jsoneditor/README.md

127 lines
3.1 KiB
Markdown
Raw Normal View History

2014-06-01 03:01:30 +08:00
# JSON Editor
https://github.com/josdejong/jsoneditor
http://jsoneditoronline.org/
2012-04-25 15:12:24 +08:00
Website: http://jsoneditoronline.org/
Github: https://github.com/josdejong/jsoneditor
2012-04-25 15:12:24 +08:00
2012-08-21 03:52:36 +08:00
2012-08-22 02:33:49 +08:00
### Description
2012-08-21 03:52:36 +08:00
2014-06-01 03:01:30 +08:00
JSON Editor is a web-based tool to view, edit, and format JSON.
2013-05-26 04:16:53 +08:00
It has various modes such as a tree editor, a code editor, and a plain text
editor.
2012-08-21 03:52:36 +08:00
2013-05-26 04:16:53 +08:00
The editor can be used as a component in your own web application. The library
can be loaded as CommonJS module, AMD module, or as a regular javascript file.
2012-08-21 03:52:36 +08:00
Supported browsers: Chrome, Firefox, Safari, Opera, Internet Explorer 9+.
<img alt="json editor" src="https://raw.github.com/josdejong/jsoneditor/master/misc/jsoneditor.png">
<img alt="code editor" src="https://raw.github.com/josdejong/jsoneditor/master/misc/codeeditor.png">
2013-02-11 00:30:37 +08:00
2012-08-22 02:33:49 +08:00
### Features
2012-08-21 03:52:36 +08:00
2013-05-26 04:16:53 +08:00
#### Tree editor
2012-08-21 03:52:36 +08:00
- Edit, add, move, remove, and duplicate fields and values.
- Change type of values.
2013-02-10 22:17:35 +08:00
- Sort arrays and objects.
2013-05-26 04:16:53 +08:00
- Colorized code.
2012-08-21 03:52:36 +08:00
- Search & highlight text in the treeview.
2012-11-04 22:26:05 +08:00
- Undo and redo all actions.
2013-05-26 04:16:53 +08:00
#### Code editor
- Format and compact JSON.
- Colorized code (powered by Ace).
- Inspect JSON (powered by Ace).
#### Text editor
- Format and compact JSON.
2012-08-21 03:52:36 +08:00
### Documentation
2014-05-31 03:28:40 +08:00
- Documentation:
- [API](https://github.com/josdejong/jsoneditor/tree/master/docs/api.md)
- [Usage](https://github.com/josdejong/jsoneditor/tree/master/docs/usage.md)
- [Shortcut keys](https://github.com/josdejong/jsoneditor/tree/master/docs/shortcut_keys.md)
- [Examples](https://github.com/josdejong/jsoneditor/tree/master/examples)
- [Source](https://github.com/josdejong/jsoneditor)
- [History](https://github.com/josdejong/jsoneditor/blob/master/HISTORY.md)
### Install
with npm:
npm install jsoneditor
with bower:
2013-06-03 19:01:52 +08:00
bower install jsoneditor
2013-05-04 18:09:14 +08:00
download:
[http://jsoneditoronline.org/downloads/](http://jsoneditoronline.org/downloads/)
### Use
```html
<!DOCTYPE HTML>
<html>
<head>
2014-06-12 21:40:28 +08:00
<link rel="stylesheet" type="text/css" href="jsoneditor/jsoneditor.min.css">
2014-12-22 02:34:58 +08:00
<script type="text/javascript" src="jsoneditor/jsoneditor.min.js"></script>
2013-05-04 18:09:14 +08:00
</head>
<body>
<div id="jsoneditor" style="width: 400px; height: 400px;"></div>
<script type="text/javascript" >
// create the editor
var container = document.getElementById("jsoneditor");
var editor = new JSONEditor(container);
2013-05-04 18:09:14 +08:00
// set json
var json = {
"Array": [1, 2, 3],
"Boolean": true,
"Null": null,
"Number": 123,
"Object": {"a": "b", "c": "d"},
"String": "Hello World"
};
editor.set(json);
// get json
var json = editor.get();
</script>
</body>
</html>
```
2013-02-10 22:17:35 +08:00
### Build
2014-05-30 16:33:11 +08:00
The code of the JSON Editor is located in the folder `./src`. To build
jsoneditor:
2013-02-10 22:17:35 +08:00
- Install dependencies:
2013-02-10 22:17:35 +08:00
npm install
2014-05-30 16:33:11 +08:00
- Build JSON Editor:
2014-05-30 16:33:11 +08:00
npm run build
2014-05-30 16:33:11 +08:00
This will generate the files `./jsoneditor.js`, `./jsoneditor.css`, and
minified versions in the root of the project.
2014-05-30 16:33:11 +08:00
- To rebuild the assets (not necessary):
2014-05-30 16:33:11 +08:00
npm run build-assets
2014-05-30 16:33:11 +08:00
This will build Ace editor, and then generates necessary ace editor files in
the folder `./asset/ace`, and jsonlint in the folder `./asset/jsonlint`.