What is json2html?

json2html is a simple but powerful javascript HTML templating library used to transform JSON objects into HTML.

Check out our website www.json2html.com for more information including detailed usage notes, interactive examples and more!

Why json2html?

Instead of writing HTML templates json2html relies on JSON transforms to convert a source JSON objects to html. The benefit of using a JSON transform is that they are already readable by the browser/server and DO NOT require any compilation before use. In addition, json2html allows the following:

• One template (we call transform) that can be used on either a client OR server
• Short hand notation for mapping data objects to markup ${name}
• Event binding to DOM objects (with jquery)
• Use of inline functions to allow for complex logic during transformation
• No compilation required

Example

Transform (template)

let transform = 
 {"<>": "li", "id":"${id}", "html":[
	{"<>": "span", "text": "${name} (${year})"}
  ]};		

Plus JSON Data

let data = 
 {"id": 1123, "name": "Jack and Jill", "year":2001};		

Will render the following html

<li id="1123">
	<span>Jack and Jill (2001)</span>
</li>	

json2html for jQuery

Use seemlessly with jQuery, oh did we also mention that you can embed events in your transforms? Forget attaching your events after you've rendered your templates.

 {"<>":"li","id":"${id}","html":[
	{"<>":"span","html":"${name} ${year}"}
  ],"onclick":funciton(e){
	alert("You just clicked " + e.obj.name);
  }};		

Will render into the following html and will alert when clicked :)

<li id=1123>
	<span>Jack and Jill (2001)</span>
</li>	

json2html for Node.js

Use seemlessly with Node.js

Installation

npm install node-json2html

Usage

	const json2html = require('node-json2html');
        
	let html = json2html.transform([{'male':'Bob','female':'Jane'},{'male':'Rick','female':'Ann'}],{"<>":"div","html":"${male} likes ${female}"});

How do I start?

Check out our website www.json2html.com for more information including detailed usage notes, downloadable examples and more!