Изоморфный фреймворк Catberry.js

Изоморфный фреймворк Catberry.js

rdner

Денис Речкунов
node.js-разработчик

Если коротко, что такое Catberry.js:

Что ты сейчас сказал?

Flux

Flux

Flux

Почему Flux?

Flux — это более безопасный MVC

Web/Cat-Components

Почти как веб-компоненты, но:

Cat-component

			hello-world/
    assets/
        hello.svg
        world.svg
    index.js
    template.hbs
    error.hbs
    cat-component.json

cat-component.json

			{
			  "name": "hello-world",
			  "logic": "./index.js",
			  "template": "./template.hbs",
			  "errorTemplate": "./error.hbs"
			}
		

Использовать как кастомные тэги:

			<cat-hello-world id="uniq-id" 
			  cat-store="some/Store"
			  any-attribute="any-value">
			</cat-hello-world>
		
В этот тэг отрендерится шаблон, который может содержать тэги компонентов, процесс повторяется рекурсивно

Особенности и исключения:

Как писать логику в index.js

			module.exports = HelloWorld;
			function HelloWorld() {...}
			// этапы жизни компонента
			HelloWorld.prototype.render = function () {...}
			HelloWorld.prototype.bind = function () {...}
			HelloWorld.prototype.unbind = function () {...}
		

Этап "render"

Тэг компонента рендерит свой шаблон
			HelloWorld.prototype.render = function () {
				// может вернуть данные для шаблона
				// или Promise на них
				return {hello: 'world'};
			};
		

Этап "bind"

Рендеринг завершен, можно привязать события
			HelloWorld.prototype.bind = function () {
				// может вернуть карту событий
				// для дочерних элементов или Promise на нее
				return {
					click: {'div.clickable': this.clickHandler}
				};
			};
		

Этап "unbind"

Компонент готовится к удалению или обновлению
			HelloWorld.prototype.unbind = function () {
				// здесь нужно прибраться, если вы
				// что-то делали в bind помимо карты событий
				// события из карты отвязываются автоматически
			};
		

А откуда брать данные?

Из Store, конечно же

Flux Stores в Catberry.js

Директория "catberry_stores" с .js-файлами
			./catberry_stores/
    doge/
        Wow.js
        Such.js
        Store.js
    grumpy-cat/
        No.js

Особенности:

Как писать логику Store

			module.exports = Wow;
			function Wow() {...}
			// время актуальности данных в мс
			Wow.prototype.$lifetime = function () {...}
			// загрузка данных
			Wow.prototype.load = function () {...}
			// обработка Action
			Wow.prototype.handleVeryAction = function () {...}
		

Метод "load"

			Wow.prototype.load = function () {...}
				// запрашивает данные, например по REST
				// возвращает объект или Promise
				return {hello: 'world'};
			};
		

Метод "handle"

			Wow.prototype.handleVeryAction = function () {...}
				// может запостить данные по REST
				// вернуть результат или Promise
				return {response: 'some'};
			};
		

Метод "handle"

			Wow.prototype.handleVeryAction = function () {...}
				// а может отправить сигнал,
				// что Store изменился
				this.$context.changed();
			};
		

Главный герой — this.$context

У компонента или Store есть $context:

У компонента дополнительно:

У Store дополнительно:

Как из компонента получить данные Store

			this.$context.getStoreData()
			  .then(function () {
			    // ура, Store дал данные
			  });
			  .catch(function (error) {
			    // печаль :(
			  });
		

Как из компонента отправить Action

			this.$context.sendAction('item-submit', item)
			  .then(function () {
			    // ура, Action обработался
			  });
			  .catch(function (error) {
			    // печаль :(
			  });
		

Service Locator

			locator.register(‘uhr’, UHR);
			locator.registerInstance('uhr', new UHR());
			locator.resolve(‘uhr’);
			locator.resolveAll(‘uhr’);
			locator.resolveInstance(SomeConstructorDependsOnUHR);
		

Dependency Injection

			function StoreConstructor ($uhr, someConfigSection) {
			  // можно внедрять и использовать $uhr
			  // и внедрять даже конфиг-секции
			}
		

Прогрессивный рендеринг

Как работает Catberry.js

Что происходит первый раз на сервере:

Когда у вас прогрессивный рендеринг

Это просто космос!

С чего начать?

			$ npm -g install catberry-cli
			$ catberry init example
		
catberry-todomvc
catberry-homepage
catberry-debugger

Где следить за новостями?

catberry.github.io
github.com/catberry/catberry (звезду, звезду поставьте)

Вопросы?