Skip to content

GuillaumeCisco/react-json-prettify

Repository files navigation

Build Status Coverage Status

React Json Prettify

Simple and Lightweight React Component for displaying Json.

The only dependencies are react and prop-types (last is excluded once built).
There is no css to load.

Installation

npm install react-json-prettify

or

yarn add react-json-prettify

Usage

import JSONPretty from 'react-json-prettify';

const json = {
    name: 'John Doe',
    age: 20,
    admin: true,
    member: null,
    permissions: ['read', 'write', 'edit'],
    deep: [
        {
            a: {
                b: {
                    c: null,
                    d: ['e', 'f', [1, null]],
                },
            },
        },
    ],
};
    
return <JSONPretty json={json} />

Output will look like

There are only two simple options: theme and padding

import JSONPretty from 'react-json-prettify';
import {github} from 'react-json-prettify/themes';

const json = {
    name: 'John Doe',
    age: 20,
    admin: true,
    member: null,
    permissions: ['read', 'write', 'edit'],
    deep: [
        {
            a: {
                b: {
                    c: null,
                    d: ['e', 'f', [1, null]],
                },
            },
        },
    ],
};
    
return <JSONPretty json={json} theme={github} padding={4} />

Modifying the padding will modify the number of spaces to indent.

Regarding themes, this modules come with 81 predefined themes.
For the main part, they come from highlightjs.
Do not hesitate to play with them.

Overriding a theme to your needs is very easy. And you can control most of the part of the render.
For example:

import {atomOneLight} from 'react-json-prettify/dist/themes';

const customTheme = {
    ...atomOneLight,
    valueQuotes: 'rgb(140, 153, 165)',
    value: {
        ...atomOneLight.value,
        string: 'rgb(140, 153, 165)',
    },
};

All the themes derive from the same simple architecture:

export default {
    background: 'rgb(39, 40, 34)',
    brace: 'rgb(129, 211, 204)',
    keyQuotes: 'rgb(129, 211, 204)',
    valueQuotes: 'rgb(129, 211, 204)',
    colon: 'rgb(129, 211, 204)',
    comma: 'rgb(129, 211, 204)',
    key: 'rgb(201, 70, 56)',
    value: {
        string: 'rgb(242, 152, 59)',
        null: 'rgb(201, 70, 56)',
        number: 'green',
        boolean: 'rgb(129, 211, 204)',
    },
    bracket: 'rgb(129, 211, 204)',
};

Themes only support colors for now.
Simply use basic css color values.
You can use conditional function on your json values too:

import {atomOneLight} from 'react-json-prettify/dist/themes';

const customTheme = {
   ...atomOneLight,
   value: {
       ...atomOneLight.value,
       string: (value) => value === 'foo' ? 'red': 'green',
   },
};

Tests

npm cover

Contributing

In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

TODO

More css customization (background-color, background-url, font-weight).
Styles of brackets and braces.
Inline options for arrays.

About

Simple and Lightweight React Component for displaying Json

Resources

License

Stars

Watchers

Forks

Packages

No packages published