Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (bel) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

bel

A simple convenience helper for creating native DOM elements.

usage

var bel = require('bel')
var element = bel('button.clicker', {
  onclick: function () {
    element.innerHTML = 'I have been clicked!'
  },
  innerHTML: 'Click me'
})
document.body.appendChild(element)

Where natively you would do:

var element = document.createElement('button')
element.className = 'clicker'
element.addEventListener('click', function () {
  element.innerHTML = 'I have been clicked!'
}, false)
element.innerHTML = 'Click me'
document.body.appendChild(element)

custom events

Also includes a convenience helper for custom events:

var send = require('bel/send')
var element = bel('button.clicker', {
  onclick: function () {
    send(element, 'selected', 'I have been clicked!')
  },
  innerHTML: 'Click me'
})

// ...

element.addEventListener('selected', function (e) {
  element.innerHTML = e.detail
})

usage with diffhtml

This creates native elements so if you're using a DOM diffing library that works with native elements, like diffhtml, you can do the following:

var bel = require('bel')
var send = require('bel/send')
var diff = require('diffhtml')

var ul = bel('ul')

function render (items) {
  items.forEach(function (item) {
    var li = bel('li', {
      onclick: function () {
        send(ul, 'selected', item.id)
      },
      innerHTML: item.name
    })
    // Add each li to the parent ul
    diff.element(ul, li, { inner: true })
  })
  // Add ul to document.body
  diff.element(document.body, ul)
}

// Render to the DOM
render([
  { id: 1, name: 'Grizzly' },
  { id: 2, name: 'Polar' }
  { id: 3, name: 'Brown' }
])

// Listen for the selected event
ul.addEventListener('selected', function (e) {
  console.log(e.detail + ' has been selected')
})

similar projects

vel
minimal virtual-dom library
base-element
An element authoring library for creating standalone and performant elements
virtual-dom
A Virtual DOM and diffing algorithm

bel