nested-accordion
v2.0.2
Published
Generates a series of accessible nested accordions from a json datafile.
Downloads
235
Maintainers
Readme
nested-accordion
Generates a series of nested accordions (using the details/summary elements) from a json datafile
Install
$ yarn add nested-accordion
Usage
Import:
const nestedAccordion = require('nested-accordion');
.create(data)
gives a html string with a nested-accordion div to be inserted in a website
const nestedAccordionDiv = nestedAccordion.create(data)
Data should be an array of SectionData
Title is required, optional text and children. If both text and children are ommitted, that child accordion will be diabled
type SectionData = {
title: string;
text?: string;
children?: Array<SectionData>;
};
`.styles()`` gives a string with the css you should add to your site
Optional colour parameters default to grey boxes
const styles = nestedAccordion.styles(
activeColour: 'grey',
inactiveColor: 'lightgrey',
textColor: 'black')
export css = `<style>\n${styles}\n</style>`
Example
const data = [
{
title: 'Grandparent 1',
text: 'Grandparent 1 description.',
children: [
{
title: 'Parent 1',
},
{
title: 'Parent 1',
children: [
{
title: 'First Child',
text: 'I am the first child',
},
{
title: 'Second Child',
text: 'I am the first child',
}
]}
]},
{
title: 'Grandparent 2',
text: 'Grandparent 2 description.',
children: [
{
title: 'Parent 3',
children: [
{
title: 'First Child',
text: 'I am the first child',
},
{
title: 'Second Child',
text: 'I am the first child',
}
]}
]}
];
const css = `<style>${nestedAccordion.styles('cyan', 'lightcyan')}</style>`
const div = nestedAccordion.create(data)
Then when the css string is put in the body of the page, and the div where you want the accordion to appear, to looks like:
Live usage
This can be used to visualise large mind-map style datasets, for example on this site looking tinto university courses.
Bugs or updates
If you want to use this accordion for you project, but it isn't quite working, let me know and I'll see what I can do!
This was originally made for a specific purpose (visualisation of a json dataset for an eleventy-genreated website), so may not work in all scenarios yet!