react-jason

Render syntax-highlighted JSON data using React. Lightweight.

Usage no npm install needed!

<script type="module">
  import reactJason from 'https://cdn.skypack.dev/react-jason';
</script>

README

react-jason screenshot

react-jason

npm versionnpm bundle size

Render syntax-highlighted JSON data using React. Lightweight.

Check out the demo to see what it can do.

Yes, the name is intentional ;)

Installation

npm install --save react-jason

Usage

import {ReactJason} from 'react-jason'

const jsonData = {
  type: 'author',
  age: 34,
  primaryGenre: null,
  hasPublished: true,
  tags: ['sci-fi', 'fantasy'],
  image: {
    url: 'https://some.url/img.png',
  },
}

export function YourComponent() {
  return <ReactJason value={jsonData} />
}

Theming/styling

We bundle a few different themes, and defining your own styles is actually very simple. The bundled themes are the following:

  • An old hope classic - default (anOldHopeClassic)
  • GitHub (github)
  • Monokai (monokai)
  • Monokai Sublime (monokaiSublime)
  • VS Code Dark (vscodeDark)
  • VS Code Light (vscodeLight)

To use them, import them from react-jason/themes:

import {ReactJason} from 'react-jason'
import github from 'react-jason/themes/github'

const jsonData = {
  /* ... */
}

export function YourComponent() {
  return <ReactJason value={jsonData} theme={github} />
}

To specify your own styles, specify a theme object with either a classes object or a styles object (or both). The keys represent the different node types. See [src/themes/monokai.ts](an existing theme) to figure out the available types.

Props

  • value: any - The JSON data to render. This is the only required property.
  • quoteAttributes: boolean - Whether or not to quote attributes (JSON-style) or remove them where they are not needed (like in javascript). Default is true.
  • theme: object - See theming/styling section above.
  • sortKeys: boolean | function - Whether or not to sort object keys. A custom sorting function can also be provided (same signature as Array.prototype.sort, but receives a third argument - the parent object being sorted)

Switching theme on dark/light mode

import {ReactJason} from 'react-jason'
import {vscodeLight, vscodeDark} from 'react-jason/themes'

const jsonData = {
  /* ... */
}

export function YourComponent() {
  const prefersDarkMode =
    typeof window !== 'undefined' && typeof window.matchMedia === 'function'
      ? window.matchMedia('(prefers-color-scheme: dark)').matches
      : false // use light theme by default?

  const theme = prefersDarkMode ? vscodeDark : vscodeLight

  return <ReactJason value={jsonData} theme={theme} />
}

What's with the name?

react-json was taken 🤷

License

MIT © Espen Hovlandsdal