Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
aceta-minophen authored Jan 1, 2023
1 parent e3cad06 commit 074474f
Showing 1 changed file with 96 additions and 1 deletion.
97 changes: 96 additions & 1 deletion README.md
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).

0 comments on commit 074474f

Please sign in to comment.