Description
Lumen ARIA Blocks helps you publish interactive content that stays usable for keyboard and assistive technology users, while remaining practical for editorial teams in Gutenberg.
Why teams use Lumen ARIA Blocks:
- Better accessibility defaults out of the box (roles, states, keyboard behavior, focus handling).
- SSR-first output for robust rendering and content continuity.
- Theme-agnostic integration (works with any WordPress theme).
- Privacy-friendly runtime (no telemetry, no tracking scripts).
How it works:
- SSR-first dynamic blocks (content remains server-rendered).
- Progressive enhancement with block-specific frontend scripts, enqueued only when the related block is rendered.
- Runtime assets are served from your own WordPress site.
- No third-party runtime libraries are bundled in this release.
Available blocks in this release:
- Accordion
- Button (action/link/toggle)
- Carousel
- Dialog
- Popup
- Tabs
- Tooltip
This plugin is designed to work across themes and does not require coupling to a specific theme implementation.
Demo page: https://lumen.angelodelorenzo.it/lumen-aria-blocks
Accessibility Contract
Lumen ARIA Blocks targets WCAG 2.2 AA intent with:
- keyboard-first interactions
- ARIA roles/state mapping per component
- focus-visible support
- reduced-motion baseline (
prefers-reduced-motion) - no-JS SSR fallback behavior for content continuity
ARIA contracts and QA checks are maintained in the release workflow and are not bundled in the plugin package.
Privacy
- No analytics or telemetry are included.
- No third-party tracking requests are sent by the plugin.
- Runtime assets are loaded from your own WordPress site.
Third-Party Libraries
- No third-party runtime libraries are bundled in this plugin release.
THIRD_PARTY_NOTICES.txtremains included as distribution metadata.
Screenshots
Accordion block with keyboard-operable disclosure panels. 
Tabs block showing active state and panel relationships. 
Dialog block trigger and modal content surface. 
Tooltip block in manual mode with explicit trigger state. 
Carousel block with previous/next controls and pagination dots. 
Popup block with close control and role labeling.
Blocks
This plugin provides 7 blocks.
- Carousel Accessible carousel powered by runtime setCarousel.
- Dialog Accessible dialog with modal and alert variants.
- Accordion Accessible accordion with ARIA-aware controls and keyboard support.
- Tooltip Accessible tooltip with runtime enhancement and keyboard-safe fallback.
- Popup Accessible popup with runtime enhancement and keyboard fallback.
- Tabs Accessible tabs with keyboard navigation and ARIA semantics.
- Button Accessible button/toggle button powered by runtime Button module.
Installation
- Upload the plugin folder to
/wp-content/plugins/lumen-aria-blocks. - Activate Lumen ARIA Blocks from the Plugins screen.
- In the block editor, open category Lumen Accessibility.
- Insert blocks and configure attributes from block settings.
FAQ
-
Does this plugin work without JavaScript?
-
Core content is server-rendered. Interactive enhancements require JavaScript, but the main content remains present in the markup.
-
Does this plugin load external CDNs?
-
No. Runtime assets are served from your WordPress site.
-
Is third-party code bundled?
-
No. This release does not bundle third-party runtime libraries. See
THIRD_PARTY_NOTICES.txtfor distribution details. -
Which blocks are included?
-
Accordion, Button, Carousel, Dialog, Popup, Tabs, and Tooltip.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Lumen ARIA Blocks” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Lumen ARIA Blocks” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.4.0
- Introduced the first WordPress.org-ready public release.
- Added seven stable accessibility-focused blocks for editorial use.
- Strengthened keyboard, focus, and no-JS behavior across the block set.
- Improved runtime reliability and release validation for production use.
- Included release compliance metadata and third-party notices.
0.3.0
- Replaced full module preload strategy with block-scoped runtime initialization.
- Added deterministic runtime initialization safeguards.
- Hardened dialog/popup/tabs/tooltip behavior for interaction parity.
0.2.18
- Split scope to editorial/content blocks only.