Disclosure (CSS Animation)

WAI-ARIA compliant disclosure pattern implementation in TypeScript. Using the <details> and <summary> element.

Install

npm i @y14e/disclosure-css

// npm
import Disclosure from '@y14e/disclosure-css';

// CDNs
import Disclosure from 'https://esm.sh/@y14e/[email protected]';
// or
import Disclosure from 'https://cdn.jsdelivr.net/npm/@y14e/[email protected]/+esm';
// or
import Disclosure from 'https://esm.unpkg.com/@y14e/[email protected]';

Usage

new Disclosure(root, options);
// => Disclosure
//
// root: HTMLElement
// options (optional): DisclosureOptions

🪄 Options

interface DisclosureOptions {
  collapsible: boolean; // default: true
}

⚙️ Customize defaults

Override the global default settings applied to all disclosure instances.

import Disclosure from '@y14e/disclosure-css';

Disclosure.defaults = {
  collapsible: false,
};

new Disclosure(root);

📦 APIs

collapse

disclosure.collapse(details);
// => void
//
// details: HTMLDetailsElement

destroy

Destroys the instance and cleans up all event listeners.

disclosure.destroy();
// => void

expand

disclosure.expand(details);
// => void
//
// details: HTMLDetailsElement

Demo

• https://y14e.github.io/disclosure-css/