html-tag    

> Generate HTML elements from a javascript object.

Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.

Install

Install with npm:

``sh
$ npm install --save html-tag
`

Originally inspired by an HTML helper in hexo by Tommy Chen.

Usage

`js
var tag = require('html-tag');
tag(name[, attribs, text]);
`

Params

* tag {String}: Name of the tag to create.
* attribs {Object}: Optional attributes
* text {String|Boolean}: Optional text
* returns {String}: string of HTML

Examples

`js
console.log(tag('a', {href: 'https://sellside.com'}, 'Sellside'));
//=> Sellside

console.log(tag('a', {id: 'anchor'}));
//=>

console.log(tag('strong', 'Let\'s dance!'));
//=> Let's dance

console.log(tag('div'));
//=>


`

Void elements (self-closing tags)

`js
console.log(tag('img', {src: 'foo.jpg'}));
//=>

console.log(tag('br'));
//=>


console.log(tag('br', '\nfoo'));
//=>
\nfoo
`

Force a tag to _not render_ the closing tag by passing boolean false as the last argument (this is sometimes necessary with XML implementations).

`js
console.log(tag('P', 'Some random text...', false));
//=>

Some random text...

console.log(tag('P', false));
//=>


`

Boolean attributes

Boolean attributes are defined by defining the attribute with a boolean value (strictly true or strictly false)

`js
console.log(tag('details', {open: true}));
//=>

console.log(tag('details', {open: false}));
//=>

console.log(tag('details', {open: 'false'}));
//=>


`

About

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Running Tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

`sh
$ npm install && npm test
`

Building docs

_(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)_

To generate the readme, run the following command:

`sh
$ npm install -g verbose/verb#dev verb-generate-readme && verb
``

$3

You might also be interested in these projects:

* breakdance: Breakdance is a node.js library for converting HTML to markdown. Highly pluggable, flexible and easy… more | homepage
* html-toc: Generate a HTML table of contents using cheerio. | homepage
* is-self-closing: Returns true if the given name is a HTML void element or common SVG self-closing… more | homepage
* remarkable: Markdown parser, done right. 100% Commonmark support, extensions, syntax plugins, high speed - all in… more | homepage
* self-closing-tags: HTML void elements are not the only self-closing tags. This includes common SVG self-closing elements… more | homepage

$3

Jon Schlinkert

* github/jonschlinkert
* twitter/jonschlinkert

$3

Copyright © 2017, Jon Schlinkert.
Released under the MIT License.

*

_This file was generated by verb-generate-readme, v0.6.0, on November 01, 2017._