</>
vdomini

mini jsx virtual dom


Install

$ npm i vdomini

Or directly from jsDelivr:

/** @jsx h */
/** @jsxFrag Fragment */
import { h, Fragment, render } from 'https://cdn.jsdelivr.net/gh/stagas/vdomini/vdomini.min.js'

Goals

  • Minimal-to-zero API.

  • Fast. Stable. Predictable.

  • No surprises!

  • Compact. Readable. Hackable.

  • Minimal error surface – With code that tries to do as little as possible there can only be a handful of ways that
    something can go wrong and when it does it won’t be because “issue #47665 hasn’t been resolved yet.

  • When an error occurs you can inspect it, you’re always one navigation away from its readable source code
    and the understanding of what caused it and possibly how to solve it.

  • No bells and whistles – All operations are as close as possible to the Real DOM(tm). No fibers, monads,
    queues, portals, no tons of layers of complexity between your intention and the operation.

  • No learning curve – You already know how to write HTML and to manipulate it using JavaScript.
    This is only abstracting a few DOM operations, which you also already know.

  • No setup – There are no plugins, transformers, transpilations that you need to learn or specific tools
    you need to use, besides TypeScript, which is excellent.
    If you’re setup with TypeScript, then this is simply one npm install away. It’s more like a library than a framework.

Features

  • Fast.
  • Tiny. 1.5kb brotli.
  • JSX with virtual dom.
  • Functional components with props, like usual from React.
  • Keyed lists with fast reconciliation only touching the items that changed.
  • Refs – Passing any object to the ref attribute will be injected a current property that corresponds
    to the live dom element.
  • Reactive Hooks – Only the function component and its children where the hook was captured are going to be rerendered when it triggers.
  • BYOB – The hook API is simply holding a reference and using the trigger function. Any kind of hook can be implemented
    using these primitives. The very basic ones are included simply for convenience and as an example.

Example

/** @jsx h */
/** @jsxFrag Fragment */

import { h, Fragment, render, useCallback } from 'vdomini'

let count = 0

const Counter = ({ count }) => {
  const inc = useCallback(() => count++)
  const dec = useCallback(() => count--)
  return (
    <>
      count is: {count}
      <br />
      <button onclick={inc}>increase</button>
      <button onclick={dec}>decrease</button>
    </>
  )
}

render(<Counter {...state} />, document.body)

A more complete example can be seen here.

API

render

src/render.ts:622-624

Renders a virtual node on an html Element.

render(<p>hello world</p>, document.body)

Parameters

  • vNode VNode The virtual node to render
  • el Element The target element to render on

useHook

src/hooks.ts:17-20

Returns a callback that will trigger
a rerender on the current component.

let clicked = 0
const Foo = () => <>
  {clicked++}
  <button onclick={useHook()}>click me</button>
</>

Returns any The hook callback

useCallback

src/hooks.ts:40-43

Wraps a function along with a hook
so when called will also trigger that hook.

let clicked = 0
const Foo = () => {
  const inc = useCallback(() => clicked++)
  return <>
    {clicked}
    <button onclick={inc}>click me</button>
  </>
}

Parameters

  • fn function (): void Any function to wrap with the hook

Returns any The callback function

trigger

src/render.ts:600-604

Triggers a rerender on a hook.

let hook
const Foo = () => {
  hook = current.hook
  return <p>{content}</p>
}
render(<Foo />, c)
trigger(hook)

Parameters

  • hook VHook The hook to trigger

VHook

src/render.ts:35-40

A hook that enables reactive programming. It can
be obtained using the export current.hook
from inside a functional component.

current

src/render.ts:566-572

The current singleton.

Type: Current

hook

src/render.ts:571-571

Holds a reference to a hook that can
be triggered later using trigger.

h

src/h.ts:79-87

The virtual node JSX factory. Returns the tree of the node and its children.

const vNode = h('p', { align: 'center' }, ['hello', 'world'])

Parameters

  • type any The element type of the virtual node to be constructed.
  • props any? A props object with arbitrary values.
  • children …any A VNode.

Returns VNode

Fragment

src/h.ts:66-66

Fragment symbol for JSX fragments <></>.

FunctionalComponent

src/h.ts:59-61

Functional component interface.

const vNode = h(() => ({ type: 'p', props: null, children: ['hello'] }))

Parameters

  • props The properties passed to the component

Returns any The computed VNode.

VNode

src/h.ts:43-47

A virtual dom node.

VType

src/h.ts:24-28

The VNode type.

Type: (FunctionalComponent | CustomElementConstructor | string | symbol)

VProps

src/h.ts:33-33

VNode propeties.

Type: (Record<string, any> | null | undefined)

VChild

src/h.ts:38-38

A VNode child.

Type: (VNode | string | number | boolean | undefined)

Contribute

Fork or
edit and submit a PR.

All contributions are welcome!

License

MIT © 2021
stagas

GitHub

View Github