```
OUTPUT EVENT:
```javascript
{
type: 'openTag',
tagName: 'div',
attributes: []
}
```
**EXAMPLE: Tag with literal attribute values**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'openTag',
tagName: 'div',
attributes: [
{
name: 'class',
value: '"demo"',
literalValue: 'demo'
},
{
name: 'disabled',
value: 'false',
literalValue: false
},
{
name: 'data-number',
value: '123',
literalValue: 123
}
]
}
```
**EXAMPLE: Tag with expression attribute**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'openTag',
tagName: 'div',
attributes: [
{
name: 'message',
value: '"Hello "+data.name'
}
]
}
```
**EXAMPLE: Tag with an argument**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'openTag',
tagName: 'for',
argument: {
value: 'var i = 0; i < 10; i++',
pos: ... // Integer
},
attributes: []
}
```
**EXAMPLE: Attribute with an argument**
INPUT:
```html
y)>
```
OUTPUT EVENT:
```javascript
{
type: 'openTag',
tagName: 'div',
attributes: [
{
name: 'if',
argument: {
value: 'x > y',
pos: ... // Integer
}
}
]
}
```
### onCloseTag
The `onCloseTag` function will be called each time a closing tag is
encountered.
**EXAMPLE: Simple close tag**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'closeTag',
tagName: 'div'
}
```
### onText
The `onText` function will be called each time within an element
when textual data is encountered.
**NOTE:** Text within `` will be emitted via call
to `onCDATA`.
**EXAMPLE**
In the following example code, the `TEXT` sequences will be emitted as
text events.
INPUT:
```html
Simple text
```
OUTPUT EVENT:
```javascript
{
type: 'text',
value: 'Simple text'
}
```
### onCDATA
The `onCDATA` function will be called when text within ``
is encountered.
**EXAMPLE:**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'cdata',
value: 'This is text'
}
```
### onPlaceholder
The `onPlaceholder` function will be called each time a placeholder
is encountered.
If the placeholder starts with the `$!{` sequence then `event.escape`
will be `false`.
If the placeholder starts with the `${` sequence then `event.escape` will be
`true`.
Text within `` and `` will not be parsed so you
cannot use placeholders for these blocks of code.
**EXAMPLE:**
INPUT:
```html
${"This is an escaped placeholder"}
$!{"This is a non-escaped placeholder"}
```
OUTPUT EVENTS
```html
${name}
```
```javascript
{
type: 'placeholder',
value: 'name',
escape: true
}
```
--------
```html
$!{name}
```
```javascript
{
type: 'placeholder',
value: 'name',
escape: true
}
```
**NOTE:**
The `escape` flag is merely informational. The application code is responsible
for interpreting this flag to properly escape the expression.
Here's an example of modifying the expression based on the `event.escape` flag:
```javascript
onPlaceholder: function(event) {
if (event.escape) {
event.value = 'escapeXml(' + event.value + ')';
}
}
```
### onDocumentType
The `onDocumentType` function will be called when the document type declaration
is encountered _anywhere_ in the content.
**EXAMPLE:**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'documentType',
value: 'DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN"'
}
```
### onDeclaration
The `onDeclaration` function will be called when an XML declaration
is encountered _anywhere_ in the content.
**EXAMPLE:**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'declaration',
value: 'xml version="1.0" encoding="UTF-8"'
}
```
### onComment
The `onComment` function will be called when text within ``
is encountered.
**EXAMPLE:**
INPUT:
```html
```
OUTPUT EVENT:
```javascript
{
type: 'comment',
value: 'This is a comment'
}
```
### onScriptlet
The `onScriptlet` function will be called when text within `<%` `%>`
is encountered.
**EXAMPLE:**
INPUT:
```html
<% console.log("Hello World!"); %>
```
OUTPUT EVENT:
```javascript
{
type: 'scriptlet',
value: ' console.log("Hello World!"); '
}
```
### onError
The `onError` function will be called when malformed content is detected.
The most common cause for an error is due to reaching the end of the
input while still parsing an open tag, close tag, XML comment, CDATA section,
DTD, XML declaration, or placeholder.
Possible error codes:
- `MISSING_END_TAG`
- `MISSING_END_DELIMITER`
- `MALFORMED_OPEN_TAG`
- `MALFORMED_CLOSE_TAG`
- `MALFORMED_CDATA`
- `MALFORMED_PLACEHOLDER`
- `MALFORMED_DOCUMENT_TYPE`
- `MALFORMED_DECLARATION`
- `MALFORMED_COMMENT`
- `EXTRA_CLOSING_TAG`
- `MISMATCHED_CLOSING_TAG`
- ...
**EXAMPLE:**
INPUT:
```html