ta-dom

Ta-Dom! 🎉

A tiny, functional helper library for generating DOM elements. Inspired in part by the jade templating engine for node.

How it works

Ta-Dom generates a bunch of named global functions that return an HTML element with the matching tag name. The optional attributes parameter is a plain object whose key/value pairs make up the desired attributes. The optional content param can hold text content, or any number of other elements.

div(attributesObject, ...content);

Event listeners can also be specified in the attributes object by specifying the name of the event prefixed with 'on-' and a function defining the event handler.

div({'on-click',(event)=> console.log(event)});

Examples

generate a single div element with a class:

div({class:'how-i-like-my-divs'});

  <div class="how-i-like-my-divs"></div>

a really bare header:

header();

  <header></header>

with some text content:

div({class:'how-i-like-my-divs'}, 'Hello, World!');

  <div class="how-i-like-my-divs">
    Hello, World!
  </div>

with some nested elements:

div({class:'how-i-like-my-divs'}, 'Hello, World!',
      h1('HEADER'),
      article({class:'how-i-like-my-articles'}, 'blah blah blah');
    );

  <div class="how-i-like-my-divs">
    Hello, World!
    <h1>HEADER</h1>
    <article>blah blah blah</article>
  </div>

Create re-usable modules:

const myArticle = (headline, articleText) => {
  return div({class:'my-article'},
    h1({class:'my-header'}, headline),
    article({class:'my-class'}, articleText)
  );
};

div({}, myArticle('My Favorite things', 'Foo and bar.'),
  myArticle('About Bananas', 'Yellow and delicious.'));

  <div>
    <div class="my-article">
      <h1>My Favorite Things</h1>
      <article>Foo and bar.</article>
    </div>
    <div class="my-article">
      <h1>About Bananas</h1>
      <article>Yellow and delicious.</article>
  </div>

Using some fancy component library, define a function to instantiate your components:

const myElement = generate('my-element');
myElement();

  <my-element><my-element>

For more examples, check out the examples directory.

Testing

Ta-dom uses Karma for unit testing. To run tests: npm test