`
- JavaScript flow-control statements as elements
`html


`

Installation

`bash
npm install htmljs-parser
`

Usage

`javascript
var parser = require('htmljs-parser').createParser({
onText: function(event) {
// Text within an HTML element
var value = event.value;
},

onPlaceholder: function(event) {
// ${]} // escape = true
// $!{]} // escape = false
var value = event.value; // String
var escaped = event.escaped; // boolean
var withinBody = event.withinBody; // boolean
var withinAttribute = event.withinAttribute; // boolean
var withinString = event.withinString; // boolean
var withinOpenTag = event.withinOpenTag; // boolean
var pos = event.pos; // Integer
},

onString: function(event) {
// Text within ""
var value = event.value; // String
var stringParts = event.stringParts; // Array
var isStringLiteral = event.isStringLiteral // Boolean
var pos = event.pos; // Integer
},

onCDATA: function(event) {
// ]]>
var value = event.value; // String
var pos = event.pos; // Integer
},

onOpenTag: function(event) {
var tagName = event.tagName; // String
var attributes = event.attributes; // Array
var argument = event.argument; // Object
var pos = event.pos; // Integer
},

onCloseTag: function(event) {
// close tag
var tagName = event.tagName; // String
var pos = event.pos; // Integer
},

onDocumentType: function(event) {
// Document Type/DTD
// >
// Example:
var value = event.value; // String
var pos = event.pos; // Integer
},

onDeclaration: function(event) {
// Declaration
// ?>
// Example:
var value = event.value; // String
var pos = event.pos; // Integer
},

onComment: function(event) {
// Text within XML comment
var value = event.value; // String
var pos = event.pos; // Integer
},

onScriptlet: function(event) {
// Text within <% %>
var value = event.value; // String
var pos = event.pos; // Integer
},

onError: function(event) {
// Error
var message = event.message; // String
var code = event.code; // String
var pos = event.pos; // Integer
}
});

parser.parse(str);
`

Content Parsing Modes

The parser, by default, will look for HTML tags within content. This behavior
might not be desirable for certain tags, so the parser allows the parsing mode
to be changed (usually in response to an onOpenTag event).

There are three content parsing modes:

- HTML Content (DEFAULT):
The parser will look for any HTML tag and content placeholders while in
this mode and parse opening and closing tags accordingly.

- Parsed Text Content: The parser will look for the closing tag that matches
the current open tag as well as content placeholders but all other content
will be interpreted as text.

- Static Text Content: The parser will look for the closing tag that matches
the current open tag but all other content will be interpreted as raw text.

`javascript
var htmljs = require('htmljs-parser');
var parser = htmljs.createParser({
onOpenTag: function(event) {
// open tag
switch(event.tagName) {
case 'textarea':
//fall through
case 'script':
//fall through
case 'style':
// parse the content within these tags but only
// look for placeholders and the closing tag.
parser.enterParsedTextContentState();
break;
case 'dummy'
// treat content within ... as raw
// text and ignore other tags and placeholders
parser.enterStaticTextContentState();
break;
default:
// The parser will switch to HTML content parsing mode
// if the parsing mode is not explicitly changed by
// "onOpenTag" function.
}
}
});

parser.parse(str);
`

Parsing Events

The htmljs-parser is an event-based parser which means that it will emit
events as it is parsing the document. Events are emitted via calls
to on function which are supplied as properties in the options
via call to require('htmljs-parser').createParser(options).

$3

The onOpenTag function will be called each time an opening tag is
encountered.

EXAMPLE: Simple tag

INPUT:

`html