Simple Accessible Spoilers Plugin
Create fully accessible content spoilers or accordions with a shortcode.
Create fully accessible content spoilers or accordions with a shortcode.
- Fully accessible to screen reader users
- Creates a flexible spoiler shortcode
- Define groups of accordions to close open accordions when another in the same group is opened.
- Override design in theme CSS files
Sample Code
[spoiler title="Sample Code" initial_state="expanded" tag="h2" group="a"]
Include content here
[/spoiler]
Attributes
title: should include the clickable text to be displayed in your accordion
initial_state: values include collapsed or expanded, default to “collapsed”
group: any alphanumeric value. used to define a group of accordions. when one accordion is opened all other items in the group will be closed.
tag: values include any typical html tag but a heading tag should be used for accessibility, defaults to H2
Installation
- Install via WordPress Dashboard or upload
simple-accessible-spoilers.zip
; - Activate the plugin through the ‘Plugins’ menu in WordPress;
- Use “spoiler” shortcode in your content;
FAQ
How can I customize design of the spoiler? Override the styles found in styles/simple-accessible-spoilers-styles.css
in your theme css files
Changelog
1.0.13
- added active and in focus styles for selected spoiler header
- removed role from heading tags and enclosed the heading text inside a button tag
- replaced css content for dashicon arrow with span element
1.0.12
- corrected unescaped output variables
1.0.11
- removed check for post before enqueueing styles and scripts to allow the shortcode to run in archive templates
- changed to expansion speed of accordians to slow
- modernized the look of the spoilers but adding rounded corners and updated icons
- corrected page scroll when space bar is used to toggle accordian
1.0.10
- corrected aria-expanded not updating on non-active elements when another element in the same group is activated
1.0.9
- corrected spoiler titles being stripped when certain accented characters exists in the title
1.0.8
- added option to customize shortcode
1.0.7
- changed spoiler toggle role to link to correct validation issue
1.0.6
- Added attribute input validation
1.0.5
- Added option to group accordions so that opening a new accordion will close opened items in the same list.
1.0.4
- WordPress 5.5 Compatibility release
1.0.3
- corrected bug resulting in initial state not displaying correctly
1.0.2
- corrected php not object error when post object is not found in a page
- added jquery dependency to wp_register_script to correct jquery not being loaded in some themes
1.0.1
- corrected bug with scripts not enqueue as expected
- added dashboard messages