my-rn-htmlview
v0.15.1
Published
A component which renders HTML content as native views
Downloads
3
Maintainers
Readme
Chỉ sửa để cập nhật cái color từ parent. tìm chỗ sửa Theo region //====== My code
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):
Table of contents
Install
npm install react-native-htmlview --save
Usage
props:
value
: a string of HTML content to renderonLinkPress
: 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 callingLinking.openURL(url)
)onLinkLongPress
: a function which will be called with a url when a link is long pressed. The default isnull
.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 returnsundefined
(notnull
), the default renderer will be used for that node. The function takes the following arguments:node
the html node as parsed by htmlparser2index
position of the node in parent node's childrensiblings
parent node's children (including current node)parent
parent nodedefaultRenderer
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 logicparent
the parent of node ofnode
bullet
: text which is rendered before everyli
inside aul
paragraphBreak
: text which appears after everyp
elementlineBreak
: text which appears after text elements which create a new line (br
, headings)addLineBreaks
: when explicitlyfalse
, effectively setsparagraphBreak
andlineBreak
tonull
NodeComponent
,nodeComponentProps
,RootComponent
,rootComponentProps
,TextComponent
,textComponentProps
: see Customizing things even further below.
Example
import React from 'react';
import {StyleSheet} from 'react-native';
import HTMLView from 'react-native-htmlview';
class App extends React.Component {
render() {
const htmlContent = `<p><a href="http://jsdf.co">♥ nice job!</a></p>`;
return (
<HTMLView
value={htmlContent}
stylesheet={styles}
/>
);
}
}
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
:
class App extends React.Component {
render() {
return (
<HTMLView
value={this.props.html}
onLinkPress={(url) => 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 <iframe>
element:
function renderNode(node, index, siblings, parent, defaultRenderer) {
if (node.name == 'iframe') {
const a = node.attribs;
const iframeHtml = `<iframe src="${a.src}"></iframe>`;
return (
<View key={index} style={{width: Number(a.width), height: Number(a.height)}}>
<WebView source={{html: iframeHtml}} />
</View>
);
}
}
const htmlContent = `
<div>
<iframe src="http://info.cern.ch/" width="360" height="300" />
</div>
`;
class App extends React.Component {
render() {
return (
<HTMLView value={htmlContent} renderNode={renderNode} />
);
}
}
Alternatively, this example shows how you could disallow the <iframe>
element:
function renderNode(node, index, siblings, parent, defaultRenderer) {
if (node.name == 'iframe') {
return null;
}
}
const htmlContent = `
<div>
<iframe src="http://info.cern.ch/" width="360" height="300" />
</div>
`;
class App extends React.Component {
render() {
return (
<HTMLView value={htmlContent} renderNode={renderNode} />
);
}
}
If you want to reuse the default renderer, you need to call it passing an array of nodes. This example shows how to replace a specific HTML tag with something different, but still process the children.
function renderNode(node, index, siblings, parent, defaultRenderer) {
if (node.name == 'mytag') {
const specialSyle = node.attribs.style
return (
<Text key={index} style={specialSyle}>
{defaultRenderer(node.children, parent)}
</Text>
)
}
}
const htmlContent = `
<div>
<mytag>
<div>some content processed normally by the engine</div>
</mytag>
</div>
`;
class App extends React.Component {
render() {
return (
<HTMLView value={htmlContent} renderNode={renderNode} />
);
}
}
For further understanding of the possiblities of the renderNode
prop, read through htmlToElement.js. Particularly look at where renderNode
is called to see how it can override what sort of React element is created in place of an element in the input HTML.
Customizing things even further
In addition to supplying a custom renderNode
function, you can customize what is rendered by the built in renderNode
function. Read through htmlToElement.js and note the usage of NodeComponent (for rendering HTML element nodes) and TextComponent (for rendering text strings in the HTML). Both of these components can be injected as the NodeComponent
and TextComponent
props to HTMLView, or alternatively they can be given extra props by passing an object as the nodeComponentProps
and textComponentProps
props. Finally you can also use the props RootComponent
and rootComponentProps
to customize the root wrapper View
element that is rendered by the HTMLView in HTMLView.js.
Changelog
See CHANGELOG.md.