# React Native HTMLView [![Build status](https://api.travis-ci.org/jsdf/react-native-htmlview.svg?branch=master)](https://travis-ci.org/jsdf/react-native-htmlview) A component which takes HTML content and renders it as native views, with customisable style and handling of links, etc. In action (from [ReactNativeHackerNews](https://github.com/jsdf/ReactNativeHackerNews)): ![React Native Hacker News Comments](http://i.imgur.com/FYOgBYc.png) ## Table of contents - [Install](#install) - [Usage](#usage) - [Example](#example) - [Changelog](#changelog) ### Install ``` npm install react-native-htmlview --save ``` ### Usage props: - `value`: a string of HTML content to render - `onLinkPress`: a function which will be called with a url when a link is pressed. Passing this prop will override how links are handled (defaults to calling `Linking.openURL(url)`) - `onLinkLongPress`: a function which will be called with a url when a link is long pressed. The default is `null`. - `stylesheet`: a stylesheet object keyed by tag name, which will override the styles applied to those respective tags. - `renderNode`: a custom function to render HTML nodes however you see fit. If the function returns `undefined` (not `null`), the default renderer will be used for that node. The function takes the following arguments: - `node` the html node as parsed by [htmlparser2](https://github.com/fb55/htmlparser2) - `index` position of the node in parent node's children - `siblings` parent node's children (including current node) - `parent` parent node - `defaultRenderer` the default rendering implementation, so you can use the normal rendering logic for some subtree. `defaultRenderer` takes the following arguments: - `node` the node to render with the default rendering logic - `parent` the parent of node of `node` - `bullet`: text which is rendered before every `li` inside a `ul` - `paragraphBreak`: text which appears after every `p` element - `lineBreak`: text which appears after text elements which create a new line (`br`, headings) - `addLineBreaks`: when explicitly `false`, effectively sets `paragraphBreak` and `lineBreak` to `null` - `NodeComponent`, `nodeComponentProps`, `RootComponent`, `rootComponentProps`, `TextComponent`, `textComponentProps`: see [**Customizing things even further**](https://github.com/jsdf/react-native-htmlview#customizing-things-even-further) below. ### Example ```js import React from 'react'; import {StyleSheet} from 'react-native'; import HTMLView from 'react-native-htmlview'; class App extends React.Component { render() { const htmlContent = `

♥ nice job!

`; return ( ); } } const styles = StyleSheet.create({ a: { fontWeight: '300', color: '#FF3366', // make links coloured pink }, }); ``` ### Custom Link Handling When a link is clicked, by default `ReactNative.Linking.openURL` is called with the link url. You can customise what happens when a link is clicked with `onLinkPress`: ```js class App extends React.Component { render() { return ( console.log('clicked link: ', url)} /> ); } } ``` If you're getting the error "undefined is not an object (evaluating 'RCTLinkingManager.openURL’)” from the LinkingIOS API, try adding ‘RCTLinking' to the project's 'Linked Frameworks and Libraries’. You might have to find RCTLinking.xcodeproj in the react-native package dir and drag that into your main Xcode project first. ### Custom Element Rendering You can implement the `renderNode` prop to add support for unsupported element types, or override the rendering for supported types. `renderNode` is a function which is called with the type and attributes of each HTML element found in the input HTML, and from this function you can return a React element to be rendered in its place. If you return `null` nothing will be rendered in place of this element or its children. If you return `undefined` (or don't return anything) then HTMLView will drop back to its default rendering for that type of HTML element. For example, here is how you might implement the ``; return ( ); } } const htmlContent = `

	Stars	Issues	Version	Updated	Created
react-native-htmlview			0.17.0	6 months ago	9 years ago
react-native-webview	6,213	95	13.8.6	8 days ago	8 years ago
react-native-wkwebview-reborn			2.0.0	6 years ago	7 years ago

react-native-htmlview vs react-native-webview vs react-native-wkwebview-reborn

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past