react-native-render-html-pyou
Version:
React Native component that renders HTML as native views
91 lines (71 loc) • 2.28 kB
Markdown
# react-native-render-html
A react native component that renders HTML as native views. This library is useful for rendering html snippets such as those that you get from wysiwyg text editors.
This is based on the work of [Thomas Beverley](https://github.com/Thomas101).
It seems that he stopped updating his repo, so instead of keeping my fork up-to-date, here's a brand new module. Thanks a lot for the original work !
## Add it to your project
```
npm install react-native-render-html --save
```
## Usage
```js
import HTML from 'react-native-render-html'
...
render() {
// The html you want to render
const html = `
<div>
<h1>A Sample H1 Title</h1>
<h2>A Sample H2 Title</h2>
...
</div>
`
const styles = {
h1: { backgroundColor: '#FF0000' },
h2: { fontFamily: 'Arial' },
img: { resizeMode: 'cover' }
}
const renderers = {
img: (htmlAttribs, children, passProps) => {
return (
<Image
source={{uri: htmlAttribs.src, width: 100, height: 100}}
style={passProps.htmlStyles.img}
{...passProps} />)
}
}
return (
<HTML
// Required. The html snippet you want to render as a string
html={html}
// The styles to supply for each html tag. Default styles
// are already pre-provided in HTMLStyles.js. The additional
// styles that you provide will be merged over these, so if
// you need some funky red background on your h1, just set
// the background
htmlStyles={styles}
// Callback for when the user taps on a link. Oh look! You
// get the href passed back. Handy if you want to send
// someone somewhere :-)
onLinkPress={(evt, href) => console.log(href)} />
// Renderers to use for rendering specific HTML elements.
// Default renderers are pre-provided in HTMLRenderers.js.
renderers={renderers}
)
}
```
## Advanced example and image sizes
TODO
## Features
| Feature | |
| ------------- | ------------- |
| iOS | ✔️ |
| Android | ✔️ |
| Faster than webview | ✔️ |
| All Native views | ✔️ |
| Inline-styles | ✔️ |
| Custom stylesheet | ✔️ |
| Tag-soup | ✔️ |
| Links | ✔️ |
| Images w/ maxWidth | ✔️ |
| Custom Renderers | ✔️ |