# React JSON Pretty [![npm version](https://badge.fury.io/js/react-json-pretty.svg)](https://badge.fury.io/js/react-json-pretty) [![npm downloads](https://img.shields.io/npm/dm/react-json-pretty.svg)](https://www.npmjs.com/package/react-json-pretty) [![build status](https://api.travis-ci.org/chenckang/react-json-pretty.svg?branch=master)](https://travis-ci.org/chenckang/react-json-pretty) ![MIT license](https://img.shields.io/github/license/mashape/apistatus.svg) ## Introduction This is a lightweight and tiny react component that helps you to format and prettify the JSON data. ## Install ```bash npm install --save react-json-pretty ``` ## Usage ### Basic The usage is quite simple, assuming that you already have an application using React. If you don't, visit [Facebook React](https://reactjs.org/) to create one or take a look at the [example](https://github.com/chenckang/react-json-pretty/tree/master/example) provided. Firstly, you need to require the react-json-pretty: ```javascript var JSONPretty = require('react-json-pretty'); ``` Or use the es2015 syntax with the help of tools like babel: ```javascript import JSONPretty from 'react-json-pretty'; ``` Next, use it in your React component: ```jsx ``` Where the property `data` is the JSON string or just a plain JavaScript object. Lastly, you can add themes stated below. ***Note: if `yourData` is not a plain object, use `circular-json` or other similar tools to preprocess it before being passed to `JSONPretty`.*** ### Themes #### Use themes with css-loader and webpack And also you can import the style to the document, here is an example of using webpack loaders(`style!css`) to load style, You can visit [webpack](https://webpack.js.org/) to get more details: ```javascript require('react-json-pretty/themes/monikai.css'); ``` Or ```javascript import 'react-json-pretty/themes/monikai.css'; ``` #### Use themes with `theme` property If you don't want to use css, `theme` property is also available. Properties of `theme` will be used as `style` property of the target DOM element. ```jsx var JSONPrettyMon = require('react-json-pretty/dist/monikai'); ``` Visit the [example](https://github.com/chenckang/react-json-pretty/tree/master/example) to get some details. The preview is as below: ![previews, you can also find it in the example folder](https://github.com/chenckang/react-json-pretty/blob/master/example/preview.png?raw=true) ## Others ### Error Use `onJSONPrettyError` function property to get `JSON.parse` errors. ```jsx console.error(e)}> ``` ### Formation Actually, react-json-pretty is based on `JSON.stringify(value[, replacer[, space]])`. However, `JSON.stringify(value[, replacer[, space]])` has some optional parameters additionally such as `replacer` and `space`. This is also available in `react-json-pretty`. Here is an example: ```jsx ``` ***Note: The default value for property `replacer` is `null`，and `space` is `2`.*** You can visit the [example](https://github.com/chenckang/react-json-pretty/tree/master/example) to see the details. ### Custom `themeClassName` Your can also define your custome `themeClassName`, the default value is `__json-pretty__`. ***Note: this may lead to the usage of default themes provided with css being invalid.*** ```jsx // The final className will be 'custom-json-pretty' ``` ### Custom Themes There are some default themes provided including `"Adventure Time"`, `acai` and `1337`, to provide users more ready-made options. ![Adventure Time](https://github.com/chenckang/react-json-pretty/blob/master/example/at.png?raw=true) ![1337](https://github.com/chenckang/react-json-pretty/blob/master/example/1337.png?raw=true) ![acai](https://github.com/chenckang/react-json-pretty/blob/master/example/acai.png?raw=true) All the css theme files are placed in the `themes` folder. It is also prossible to define a custom theme: #### Using ***type***Style property This can make control the extra styles of the specific type of value: ``` mainStyle?: string; keyStyle?: string; valueStyle?: string; booleanStyle?: string; stringStyle?: string; errorStyle: string; ``` For example: set padding of the main area and the font size the normal value ```jsx ``` #### Using `themes` property Here is the property schema: ``` { main?: string, error?: string, key?: string, string?: string, value?: string, boolean?: string' } ``` For example: ```js { main: 'line-height:1.3;color:#66d9ef;background:#272822;overflow:auto;', error: 'line-height:1.3;color:#66d9ef;background:#272822;overflow:auto;', key: 'color:#f92672;', string: 'color:#fd971f;', value: 'color:#a6e22e;', boolean: 'color:#ac81fe;', } ``` #### Using css file For example the `monokai.styl`: ``` .__json-pretty__ line-height 1.3 color rgba(248,248,242,1) background #1e1e1e overflow auto .__json-key__ color rgba(255,94,94,1) .__json-value__ color rgba(253,176,130,1) .__json-string__ color rgba(233,253,172,1) .__json-boolean__ color rgba(102,153,204,1) .__json-pretty-error__ line-height 1.3 color rgba(248,248,242,1) background #1e1e1e overflow auto ``` ## License MIT (http://www.opensource.org/licenses/mit-license.php)

Package	Téléchargements	Stars	Taille	Issues	Publication	Licence

react-json-pretty	114,036	159	-	7	il y a 6 ans	MIT