dna-dom

An uncomplicated user interface library for cloning semantic templates

dna-dom is a lightweight easy-to-use UI library enabling developers to rapidly build maintainable JavaScript applications.  The project name stems from its primary function of cloning DOM templates. 

A) Bookstore Example

Designate templates with the dna-template class, and put the templates directly into the HTML of your web page.  Use the element's id to indicate the name of the template.  Enclose data fields in double tildes ~~.

1. HTML for book template

<h1>Featured Books</h1>
<section class=books>
   <div id=book class=dna-template>
      <h2>~~title~~</h2>
      Author: <cite>~~author~~</cite>
   </div>
</section>

Then call the dna.clone() function to insert a copy of the template into the DOM.  The supplied JSON data object populates the fields of the template.

2. JavaScript call to add book node

dna.clone('book', { title: 'The DOM', author: 'Jan' });

The new clone element replaces the template.  The original template is detached from the DOM and kept for additional cloning.

3. Resulting HTML with clone

<h1>Featured Books</h1>
<section class=books>
   <div class=book>
      <h2>The DOM</h2>
      Author: <cite>Jan</cite>
   </div>
</section>

Need to clone the template multiple times?  Simply pass an array of data objects into the dna.clone() function.

B) Additional Information

• https://dna-dom.org (see the "Try it out" section for an interactive example)
• Sample To-Do Application (jsfiddle)
• Introduction to dna-dom (YouTube)
• Documentation
• Release Notes

C) Contributor Notes

To be a contributor, fork the project and run the commands npm install and npm test on your local clone.  Make your edits and rerun the tests.

Pull requests welcome.  Since the pacakge version number is updated during the release process, you can leave the version number unchanged.

MIT License

🛡️ npm Security Aggregator

dna-dom is open source under the MIT License.  The website and documentation are published under the CC BY-SA 4.0 license.