JSON Editor

A web-based tool to view, edit, format, and validate JSON

JSONSyntax highlightingCode Editor
josdejong/jsoneditorjsoneditoronline.orgjsoneditor

README

JSON Editor

Version Downloads Maintenance License FOSSA Status

JSON Editor is a web-based tool to view, edit, format, and validate JSON. It has various modes such as a tree editor, a code editor, and a plain text editor. The editor can be used as a component in your own web application. It can be loaded as CommonJS module, AMD module, or as a regular javascript file.

The library was originally developed as core component of the popular web application https://jsoneditoronline.org and has been open sourced since then.

Supported browsers: Chrome, Firefox, Safari, Opera, Edge, Internet Explorer 11.

json editor   code editor

Cross browser testing for JSONEditor is generously provided by BrowserStackBrowserStack

Successor: svelte-jsoneditor


This library [jsoneditor](https://github.com/josdejong/jsoneditor) has a successor: [svelte-jsoneditor](https://github.com/josdejong/svelte-jsoneditor). The new editor is not a one-to-one replacement, so there may be reasons to stick with jsoneditor.
The main differences between the two are described here.

Features


JSONEditor has various modes, with the following features.

Tree mode


- Change, add, move, remove, and duplicate fields and values.
- Sort arrays and objects.
- Transform JSON using JMESPath queries.
- Colorized code.
- Color picker.
- Search & highlight text in the tree view.
- Undo and redo all actions.
- JSON schema validation (powered by ajv).

Code mode


- Colorized code (powered by Ace).
- Inspect JSON (powered by Ace).
- Format and compact JSON.
- Repair JSON.
- JSON schema validation (powered by ajv).

Text mode


- Format and compact JSON.
- Repair JSON.
- JSON schema validation (powered by ajv).

Preview mode


- Handle large JSON documents up to 500 MiB.
- Transform JSON using JMESPath queries.
- Format and compact JSON.
- Repair JSON.
- JSON schema validation (powered by ajv).

Documentation


- Documentation:
  - API
  - Usage
  - Shortcut keys
- Examples
- Source
- History

Install


with npm (recommended):

    npm install jsoneditor

Note that to use JSONEditor in Internet Explorer 11, it is necessary

to load a polyfill for Promise in your application.


Alternatively, you can use another JavaScript package manager like https://yarnpkg.com/, or a CDN such as https://cdnjs.com/ or https://www.jsdelivr.com/.

Use


Note that in the following example, you'll have to change the urls jsoneditor/dist/jsoneditor.min.js and jsoneditor/dist/jsoneditor.min.css to match the place where you've downloaded the library, or fill in the URL of the CDN you're using.


  1. ``` html
  2. <!DOCTYPE HTML>
  3. <html lang="en">
  4. <head>
  5.     
  6.     <meta charset="utf-8">
  7. <link href="jsoneditor/dist/jsoneditor.min.css" rel="stylesheet" type="text/css">
  8.     <script src="jsoneditor/dist/jsoneditor.min.js"></script>
  9. </head>
  10. <body>
  11.     <div id="jsoneditor" style="width: 400px; height: 400px;"></div>
  12. <script>
  13.         // create the editor
  14.         const container = document.getElementById("jsoneditor")
  15.         const options = {}
  16.         const editor = new JSONEditor(container, options)
  18.         // set json
  19.         const initialJson = {
  20.             "Array": [1, 2, 3],
  21.             "Boolean": true,
  22.             "Null": null,
  23.             "Number": 123,
  24.             "Object": {"a": "b", "c": "d"},
  25.             "String": "Hello World"
  26.         }
  27.         editor.set(initialJson)
  29.         // get json
  30.         const updatedJson = editor.get()
  31.     </script>
  32. </body>
  33. </html>
  34. ```

Build


The code of the JSON Editor is located in the folder ./src. To build
jsoneditor:

- Install dependencies:

  1. ```
  2.   npm install
  3. ```

- Build JSON Editor:

  1. ```
  2.   npm run build
  3. ```

  This will generate the files ./jsoneditor.js, ./jsoneditor.css, and  
  minified versions in the dist of the project.

- To automatically build when a source file has changed:

  1. ```
  2.   npm start
  3. ```

  This will update ./jsoneditor.js and ./jsoneditor.css in the dist folder
  on every change, but it will NOT update the minified versions as that's
  an expensive operation.

Test


Run unit tests:

  1. ```
  2. npm test
  3. ```

Run code linting (JavaScript Standard Style):

  1. ```
  2. npm run lint
  3. ```

Custom builds


The source code of JSONEditor consists of CommonJS modules. JSONEditor can be bundled in a customized way using a module bundler like browserify or webpack. First, install all dependencies of jsoneditor:

    npm install

To create a custom bundle of the source code using browserify:

    browserify ./index.js -o ./jsoneditor.custom.js -s JSONEditor

The Ace editor, used in mode code, accounts for about one third of the total
size of the library. To exclude the Ace editor from the bundle:

    browserify ./index.js -o ./jsoneditor.custom.js -s JSONEditor -x brace -x brace/mode/json -x brace/ext/searchbox

To minify the generated bundle, use uglifyjs:

    uglifyjs ./jsoneditor.custom.js -o ./jsoneditor.custom.min.js -m -c