JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 81
  • Score
    100M100P100Q79177F
  • License MIT

Generates a series of accessible nested accordions from a json datafile.

Package Exports

  • nested-accordion

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (nested-accordion) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

nested-accordion

npm version Build Status Coverage Status install size

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: demo gif

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!