html2any

A non-dependecy package for coverting html/xml string to your customized format/structures.

While building websites, people may met issues for rendering rich text into different formats. For example, I've got an <video> tag, but I wanna render it with my own React video component. But I also want to render the whole html easily rather than parse it manually.

Now html2any help you to render html string. It not only parses your html but also gives you ability to transform it from origin to the dest.

Theory

Use html2any to construct an AST of html string, then convert each node recursively with rule passed to transform function.

For example, we translate <p> tag into React Native component <Text style={styles.paragraph}> with the prepared styles. Then decode the p tag' s content to avoid html entities mess up.

Demo

• Web React Online Demo
• React Native demo: https://github.com/huozhi/html2any-rn-demo

Documentation

html2any provide following APIs

• AST(Object) parse(String source)

• void transform(AST ast, function rule)

• void html2any(html, function rule)

• parse

Build the AST from source to AST from source html/xml code

• transform

Convert the AST to the final form with the specific rule.

• html2any

Convert the html/xml to the final form directly.

If it's not easy to reach the point, you could look at the demo code.

Example

import html2any, {parse, transform} from 'html2any'

const html = `
  <div>123</div>
`

const ast = parse(html)[0]

function rule(node, children) {
  if (node.name === 'div') {
    return <div>{children}</div>
  } else {
    return node // string node
  }
}

const vdom = transform(ast, rule)
// vdom form of Dumb
// { type: 'div', props: {...}, children: '...' }

Or you can just call html2any directly

const vdom = html2any(html, rule)

Issue

Any suggestions or beautifier API you expect, just post issue here. Reporting bugs is welcomed. : )