<details-utils>
- All Demos
- Blog post on zachleat.com: Add Responsive-Friendly Enhancements to
<details>
with<details-utils>
Related work elsewhere:
Installation
npm install @zachleat/details-utils
Add details-utils.js
to your bundle.
Usage
Wrap <details-utils>
around one or more <details>
elements to add enhancements to their behavior:
- Click outside to close (also bind an optional close button)
- Animate open and close (obeys
prefers-reduced-motion
) - Force open/closed based on:
- JavaScript
- Media query
- (e.g. viewport size,
prefers-reduced-motion
, evenprefers-reduced-data
if browsers ever support itπ ) - Optionally restores user state when media query does not match (use
force-restore
attribute)
- (e.g. viewport size,
- Close via
esc
Key- With optional Media query.
- Toggle Document Class (toggles a class on
<html>
when active, useful for modals to disable document overflow)
Changelog
v2.0.0
- Renamed attribute
force-closed
toforce-close
- Added
force-open
to complementforce-close
- Added
force-restore
to be used withforce-open
andforce-close
(restores state when media query does not match).