-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Yell0wflash
committed
Aug 11, 2022
1 parent
cba15ab
commit ec88bf6
Showing
2 changed files
with
89 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| MIT License | ||
|
|
||
| Copyright (c) 2022 Textea | ||
|
|
||
| Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| of this software and associated documentation files (the "Software"), to deal | ||
| in the Software without restriction, including without limitation the rights | ||
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
| copies of the Software, and to permit persons to whom the Software is | ||
| furnished to do so, subject to the following conditions: | ||
|
|
||
| The above copyright notice and this permission notice shall be included in all | ||
| copies or substantial portions of the Software. | ||
|
|
||
| THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
| AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
| SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1 +1,68 @@ | ||
| # json-viewer | ||
| # @textea/json-viewer | ||
|
|
||
| `@textea/json-viewer` is a React component for displaying and editing JavaScript/TypeScript **arrays** and **JSON | ||
| objects**. | ||
|
|
||
| This component provides a responsive interface for displaying arrays or JSON in a web browser. | ||
|
|
||
| ## Usage | ||
|
|
||
| ```shell | ||
| # npm | ||
| npm install @textea/json-viewer | ||
| # yarn | ||
| yarn add @textea/json-viewer | ||
| # pnpm | ||
| pnpm add @textea/json-viewer | ||
| ``` | ||
|
|
||
| ```tsx | ||
| import ReactJson from '@textea/json-viewer' | ||
|
|
||
| const json = { /* my json object */ } | ||
| const Component = () => (<ReactJson src={json}/>) | ||
| ``` | ||
|
|
||
| ## Props | ||
|
|
||
| | Name | Type | Default | Description | | ||
| |:-----------------------------|:--------------------------|:-------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ||
| | `src` | `JSON Object` | None | This property contains your input JSON | | ||
| | `name` | `string` or `false` | "root" | Contains the name of your root node. Use `null` or `false` for no name. | | ||
| | `theme` | `string` | "rjv-default" | RJV supports base-16 themes. Check out the list of supported themes [in the demo](https://mac-s-g.github.io/react-json-view/demo/dist/). A custom "rjv-default" theme applies by default. | | ||
| | `style` | `object` | `{}` | Style attributes for react-json-view container. Explicit style attributes will override attributes provided by a theme. | | ||
| | `iconStyle` | `string` | "circle" | Style of expand/collapse icons. Accepted values are "circle", triangle" or "square". | | ||
| | `indentWidth` | `integer` | 4 | Set the indent-width for nested objects | | ||
| | `collapsed` | `boolean` or `integer` | `false` | When set to `true`, all nodes will be collapsed by default. Use an integer value to collapse at a particular depth. | | ||
| | `collapseStringsAfterLength` | `integer` | `false` | When an integer value is assigned, strings will be cut off at that length. Collapsed strings are followed by an ellipsis. String content can be expanded and collapsed by clicking on the string value. | | ||
| | `shouldCollapse` | `(field)=>{}` | `false` | Callback function to provide control over what objects and arrays should be collapsed by default. An object is passed to the callback containing `name`, `src`, `type` ("array" or "object") and `namespace`. | | ||
| | `groupArraysAfterLength` | `integer` | `100` | When an integer value is assigned, arrays will be displayed in groups by count of the value. Groups are displayed with bracket notation and can be expanded and collapsed by clicking on the brackets. | | ||
| | `enableClipboard` | `boolean` or `(copy)=>{}` | `true` | When prop is not `false`, the user can copy objects and arrays to clipboard by clicking on the clipboard icon. Copy callbacks are supported. | | ||
| | `displayObjectSize` | `boolean` | `true` | When set to `true`, objects and arrays are labeled with size | | ||
| | `displayDataTypes` | `boolean` | `true` | When set to `true`, data type labels prefix values | | ||
| | `onEdit` | `(edit)=>{}` | `false` | When a callback function is passed in, `edit` functionality is enabled. The callback is invoked before edits are completed. Returning `false` from `onEdit` will prevent the change from being made. [see: onEdit docs](#onedit-onadd-and-ondelete-interaction) | | ||
| | `onAdd` | `(add)=>{}` | `false` | When a callback function is passed in, `add` functionality is enabled. The callback is invoked before additions are completed. Returning `false` from `onAdd` will prevent the change from being made. [see: onAdd docs](#onedit-onadd-and-ondelete-interaction) | | ||
| | `defaultValue` | `string \ | number \ | boolean \ |array \|object`|`null`|Sets the default value to be used when adding an item to json | ||
| | `onDelete` | `(delete)=>{}` | `false` | When a callback function is passed in, `delete` functionality is enabled. The callback is invoked before deletions are completed. Returning `false` from `onDelete` will prevent the change from being made. [see: onDelete docs](#onedit-onadd-and-ondelete-interaction) | | ||
| | `onSelect` | `(select)=>{}` | `false` | When a function is passed in, clicking a value triggers the `onSelect` method to be called. | | ||
| | `sortKeys` | `boolean` | `false` | set to true to sort object keys | | ||
| | `quotesOnKeys` | `boolean` | `true` | set to false to remove quotes from keys (eg. `"name":` vs. `name:`) | | ||
| | `validationMessage` | `string` | "Validation Error" | Custom message for validation failures to `onEdit`, `onAdd`, or `onDelete` callbacks | | ||
| | `displayArrayKey` | `boolean` | `true` | When set to `true`, the index of the elements prefix values | | ||
|
|
||
| ## Features | ||
|
|
||
| - [X] Support `Next.js` SSR | ||
| - [X] `onEdit`, `onAdd` and `onDelete` props allow users to edit the `src` variable | ||
| - [X] Object, array, string and function values can be collapsed and expanded | ||
| - [X] Object and array nodes display length | ||
| - [X] Object and array nodes support a "Copy to Clipboard" feature | ||
| - [X] String values can be truncated after a specified length | ||
| - [X] Arrays can be subgrouped after a specified length | ||
| - [X] When `onEdit` is enabled: | ||
| * `Ctrl/Cmd+Click` Edit Mode | ||
| * `Ctrl/Cmd+Enter` Submit | ||
|
|
||
| ## LICENSE | ||
|
|
||
| This project is licensed under the terms of the [MIT license](LICENSE). |