react-object-editor
Forked from react-json-tree
TODO: Update README
React JSON Viewer Component, Extracted from redux-devtools. Supports iterable objects, such as Immutable.js.
Usage
import JSONTree from 'react-json-tree'// If you're using Immutable.js: `npm i --save immutable`import Map from 'immutable' // Inside a React component:const json = array: 1 2 3 bool: true object: foo: 'bar' immutable: <JSONTree = />
Result:
Check out examples directory for more details.
Theming
This component now uses react-base16-styling module, which allows to customize component via theme
property, which can be the following:
- base16 theme data. The example theme data can be found here.
- object that contains style objects, strings (that treated as classnames) or functions. A function is used to extend its first argument
{ style, className }
and should return an object with the same structure. Other arguments depend on particular context (and should be described here). See createStylingFromTheme.js for the list of styling object keys. Also, this object can extendbase16
theme viaextend
property.
Every theme has a light version, which is enabled with isLightTheme
prop.
const theme = scheme: 'monokai' author: 'wimer hazenberg (http://www.monokai.nl)' base00: '#272822' base01: '#383830' base02: '#49483e' base03: '#75715e' base04: '#a59f85' base05: '#f8f8f2' base06: '#f5f4f1' base07: '#f9f8f5' base08: '#f92672' base09: '#fd971f' base0A: '#f4bf75' base0B: '#a6e22e' base0C: '#a1efe4' base0D: '#66d9ef' base0E: '#ae81ff' base0F: '#cc6633'; <div> <JSONTree = = = /></div>
Result (Monokai theme, dark background):
Advanced Customization
<div> <JSONTree = = /></div>
Customize Labels for Arrays, Objects, and Iterables
You can pass getItemString
to customize the way arrays, objects, and iterable nodes are displayed (optional).
By default, it'll be:
<JSONTree =
But if you pass the following:
const getItemString = type data itemType itemString <span> // {type}</span>);
Then the preview of child elements now look like this:
Customize Rendering
You can pass the following properties to customize rendered labels and values:
<JSONTree = =/>
In this example the label and value will be rendered with <strong>
and <em>
wrappers respectively.
For labelRenderer
, you can provide a full path - see this PR.
More Options
shouldExpandNode: function(keyName, data, level)
- determines if node should be expanded (root is expanded by default)hideRoot: Boolean
- iftrue
, the root node is hidden.
Credits
- All credits to Dave Vedder (veddermatic@gmail.com), who wrote the original code as JSONViewer.
- Extracted from redux-devtools, which contained ES6 + inline style port of JSONViewer by Daniele Zannotti (dzannotti@me.com)
- Iterable support thanks to Daniel K.
- npm package created by Shu Uesugi (shu@chibicode.com) per this issue.
Similar Libraries
License
MIT