-
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
1 parent
e3cad06
commit 074474f
Showing
1 changed file
with
96 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 |
---|---|---|
@@ -1,2 +1,97 @@ | ||
# json-to-tree-render | ||
An npm package to render a JSON to collapsible and editable tree structures. | ||
|
||
A JavaScript library for rendering a tree view of a JSON object. | ||
|
||
## Table of Contents | ||
|
||
- [Installation](#installation) | ||
- [Usage](#usage) | ||
- [API Reference](#api-reference) | ||
- [Contributing](#contributing) | ||
- [License](#license) | ||
|
||
## Installation | ||
|
||
To install the `json-to-tree-render` package, run the following command: | ||
|
||
``` | ||
npm install json-to-tree-render | ||
``` | ||
|
||
|
||
## Usage | ||
|
||
To use the `json-to-tree-render` package, you can include the CDN `https://unpkg.com/[email protected]/src/index.js` file in your HTML file and call the `createTreeView` function with the JSON object and root element as arguments. | ||
|
||
For rendering icons, we also use the stylesheets added to the headers. | ||
|
||
``` | ||
<!-- index.html --> | ||
<!DOCTYPE html> | ||
<html> | ||
<head> | ||
<title>My Tree View</title> | ||
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet" | ||
integrity="sha384-1BmE4kWBq78iYhFldvKuhfTAU6auU8tT94WrHftjDbrCEXSU1oBoqyl2QvZ6jIW3" crossorigin="anonymous"> | ||
<script src="https://use.fontawesome.com/5d5a7b196b.js"></script> | ||
</head> | ||
<body style="background-color:black;"> | ||
<!-- include the bundle file in a script tag --> | ||
<script src="https://unpkg.com/[email protected]/src/index.js"></script> | ||
<!-- create a root element for the tree view --> | ||
<div id="root" style="color: white;"></div> | ||
<script> | ||
const json = { | ||
"1": { | ||
"1.1": { | ||
"1.1.1": "Hello world" | ||
} | ||
}, | ||
"2": "hello", | ||
"3": "world" | ||
}; | ||
// get the root element | ||
const root = document.getElementById('root'); | ||
// create the tree view | ||
createTreeView(json, root); | ||
</script> | ||
</body> | ||
</html> | ||
``` | ||
|
||
## API Reference | ||
`createTreeView(json: Object, container: HTMLElement)` Renders a tree view of the JSON object in the specified container element. | ||
|
||
**Arguments** | ||
- `json` (Object): The JSON object to render as a tree view. | ||
- `container` (HTMLElement): The root element in which to render the tree view. | ||
|
||
**Returns** | ||
- void | ||
|
||
## Contributing | ||
To contribute to the json-to-tree-render package, please follow these guidelines: | ||
- Fork the repository. | ||
- Create a new branch for your changes. | ||
- Make your changes and commit them to your branch. | ||
- Push your branch to your forked repository. | ||
- Create a pull request from your forked repository to the json-to-tree-render repository. | ||
|
||
## License | ||
|
||
This project is licensed under the GNU General Public License v3.0. | ||
|
||
The GNU General Public License (GPL) is a free, copyleft license used primarily for software. The GPL requires that any modifications or additions to the software must also be made available under the GPL. | ||
|
||
For more information, see the GNU General Public License at [https://www.gnu.org/licenses/gpl-3.0.html](https://www.gnu.org/licenses/gpl-3.0.html). |