xatto1.2.0 • Public • Published
xatto is View Layer Library based on Function and Context using VirtualDOM.
This is developed by forking from jorgebucaran/superfine.
The main APIs of
xatto are two.
The first one is
xatto.x. It returns a new virtual DOM node tree.
The other is
xatto.atto. It returns a function that mount (or update) a component in the specified DOM element. (
example: A counter that can be incremented or decremented.
import x atto from "xatto"const down = count: contextcount - 1const up = count: contextcount + 1const Component = props children context<div><h1>contextcount</h1><button =>-</button><button =>+</button></div>count: 10
xatto is available as a package on npm.
npm install xatto
It is also available on a CDN.
git clone https://github.com/atomita/xatto-starter-kit.git projectcd projectnpm installnpm run serve
It consists of dynamic data that moves within a component during execution.
To change the context you need to use the mutate function (or event handler in the components).
It is a function returned by
Passing the context mount the component specified by xatto.atto on the specified container together.
From the second time on, it update.
Each time the context changes the component is invoked so you can specify the appearance of the DOM based on the new context.
The context can be referenced in the third arguments.
import x atto from "xatto"const Component = props children context<div>contextname</div>name: "foo"
const Component = props children<><div>foo</div><div>bar</div></>
Sliced context and fill
The child component can treat a part of the context as if it were the root context by using
<Context slice="path"> in the parent component.
fill attribute can specify a value to use if part of the sliced context is undefined.
import x atto Context from "xatto"const Parent = props children context<div><span>contextname</span><ul><li><Context ="children.0"><Child /></Context></li><li><Context ="children.1" =><Child /></Context></li></ul></div>const Child = props children context<span>contextname</span>name: "foo"children:name: "bar"
Event handlers are wrapped by xatto.
Usually, the event object passed in the first argument is the fourth argument.
The return value is passed to the mutate function.
Event handler arguments:
Lifecycle events can be used to be notified when an element managed by the virtual DOM is created, updated, or deleted.
It can be used for animation, data fetching, third party library wrapping, resource cleanup, etc.
This event occurs after an element is created and attached to the DOM.
This event will occur each time you update an element's attributes.
This event occurs before an element is dettached from the DOM.
detail.done is passed a function to detach the element.
This event occurs just before an element is dettached from the DOM.
This event occurs just before each life cycle event occurs.
detail.type is passed the life cycle event name.
The key helps to identify the node each time xatto update the DOM.
This allows you to rearrange the elements to a new position if you change the position.
The key must be unique among sibling nodes.
Polyfill which may be needed
xatto is MIT licensed. See LICENSE.
import x atto Context from "xatto"const down = count: contextcount - 1const up = count: contextcount + 1const Counter = props children context<div><h1>contextcount</h1><button =>-</button><button =>+</button></div>const add =counters: contextcountersconst cut =counters: contextcountersconst Main = props children context<div><button =>add</button><button =>cut</button>contextcounters<pre>JSON</pre></div>counters:count: 0count: 10