@starptech/webparser
v0.10.0
Published
Optimized html parser for HTML5 Web Components.
Downloads
12,241
Maintainers
starptechReadme
@starptech/webparser
Optimized html parser for HTML5 Web Components. The parser supports features which are very useful if you want to implement a HTML formatter or anything else where a less strict parser is needed to keep all informations in the ast.
Installation
npm install --save @starptech/webparserUsage
This example shows how we parse HTML
const parser = new HtmlParser(options)
const result = parser.parse('<div></div>')Representation
There are four different types of nodes
- Doctype
{
value: '<!doctype html>',
sourceSpan: null
}- Element
{
name: 'div',
attrs: [],
children: [],
implicitNs: false,
sourceSpan: null,
startSourceSpan: null,
endSourceSpan
}Void or self-closing elements can be checked when the startSourceSpan is equals the endSourceSpan.
- Attribute
{
name: 'div',
value: 'foo',
children: [],
implicitNs: false,
sourceSpan:null,
valueSpan: null
}- Comment
{
value: 'foo comment',
sourceSpan: null
}API
HtmlParser.parse(doc: string): ParseTreeResult
Parse a document and returns a ParseTreeResult result.
options.decodeEntities (enabled by default)
Decode html entities in text and attributes according to HTML5 specification.
options.ignoreFirstLf (enabled by default)
Ignore first line feed of pre, textarea and listing tags according to HTML5 specification.
options.selfClosingCustomElements (disabled by default)
Allow custom self-closing elements.
options.selfClosingElements (disabled by default)
Allow custom and known self closing HTML elements.
options.insertRequiredParents (disabled by default)
Insert the required parent element according to the HTML5 specification.
Credits
The parser is a modificated version of Angular 6 template parser.