any-dom

consistent API for any virtual dom library

Provides a consistent API for any virtual dom library. Now one can create libraries that are not bound to only a single virtual dom library implementation.

Idea

There are so many virtual dom libraries on the internet right now and all of them have different APIs to create or patch the DOM. This makes it awfully tough to remember the signature while using and deters developers to make frameworks/libraries that are Virtual DOM agnostic.

Any DOM aims to solve this problem but keeping the API simple and consistent. It abstracts the original patching function and provides a more simpler function that looks like this —

function patch (container: HTMLElement, vNode: VirtualNode) : void 

The patch function takes in two arguments — First is the real DOM element and second is Virtual DOM element and it returns nothing. Now we can pass the patch function as an argument to our framework/library and expect it to just work :-)

Usage

Simplified Imports

// Using react
import {patch, h} from 'any-dom/react'

// using snabbdom
import {patch, h} from 'any-dom/snabbdom'

// using preact
import {patch, h} from 'any-dom/preact'

Simplified CDN

<script src="https://unpkg.com/any-dom/react.js"></script>

<script >
  console.log(window.anydom.patch)
</script>

Usage inside the DOM

import {patch, h} from 'any-dom/react'

const element = (
  h('h1', [
    'Hello, World!!'
  ])
)

patch(
  document.getElementById('root'),
  element  
)

Supported Libraries

• React
• Preact
• Snabbdom

Wishlist

• Add mode virtual dom libraries.
• Add consistent Hyperscript helpers