XML-to-React
A utility to convert valid XML documents into React elements.
Prerequisites
This library may only be used in projects using React version 0.13.x or greater.
Installation
This assumes you are using npm as your package manager.
Usage
Simple Example
Convert XML nodes into DOM elements with any provided attributes
This example would render the following:
Converters
Converters are required mapping functions that define how an XML node should be converted to React. A converter must return an object in the format { type, [props] }
, which is intended to be passed to React.createElement
.
type
- required tagName, React component, or React fragmentprops
- (optional) props object
Example
XMLToReact
constructor
The XMLToReact
class is instantiated with a map of converters.
convert( xml, data )
xml
{string}
- xml node or documentdata
{Object}
- (optional) any data to be passed to all converters
Prior Art
- jsonmltoreact demonstrated this technique using JsonML, and serves as motivation for this project.