Functions

generate(data, root, settings) - convert data according with converting settings and render it to root.

| Name | Type | Default | Description | | ------------ | ---------------- | ----------- | ------------------------------------------ | | data | String or Object | '' | a string which is json or an object | | root | DOM Element | undefined | a DOM-node where the data will be rendered | | settings | Object | {} | an object of settings |

transform(data, settings) - convert data according with converting settings. Returns converted Object.

| Name | Type | Default | Description | | ------------ | -------- | ----------- | --------------------- | | data | Object | '' | an object | | settings | Object | {} | an object of settings |

Fields of settings object

| Name | Type | Default | Description | | ------------------------- | -------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | root | String or Array | '' | root of json which should be presented. Could be string or array. If it is "" the whole json will be presented. If it is a string will be returned data[root]. Array is a path to concrete value. E.g. if to use ['key1', 'key2', ... 'keyn'] you will get data[key1][key2]...[keyn] | | isFormatKeys | Boolean | false | if it is true all keys in CamesCase, snake_case, and kebab-case will be formatted to separate words | | nullAppearence | String | undefined | string by which will be replaced null values | | boolAppearence | Array of two Strings | undefined | array of strings by which will be replaced true and false values | | hidePropertiesByValue | Array of Strings | undefined | array of values by which will be hided parameters of your json | | hidePropertiesByKey | Array of Strings | undefined | array of keys by which will be hided parameters of your json | | hideEmpty | Boolean | true | hide fields with an empty object and empty arrays as a value. Fields could also become empty after hiding inner fields | | isMergeSingleFields | Boolean | false | if there is only one field in an Object or only one element is in an Array it merges to parents field | | keysForArrays | Object | undefined | an abject where keys are names of arrays and values are properties which will be shown as keys for corresponding arrays | | arraysAsTable | Array of Strings | [] | array of keys of parameters which contain an array and which will be presented as a table | | showNotifications | Boolean | true | if it's true all errors and warnings will be visible | | capitalizeKeys | Boolean | undefined | if it's true all keys will start from capital letter |

Usage

import { generate } from 'json-custom-view';

const root = document.querySelector('#main');

generate(JSONdata, root, settings);