Supporting the creation of accessible content when more information is needed.
Documentation of accessibility features is important for all authors. This feature provides short contextual information and the possibility to have more granular information provided separately.
The contextual documentation may be followed by a simple icon indicating that more detailed information or help is available. The icon provides access to a popup or modal dialog that allows the web author to learn more about the specific issue.
In addition to this, a section in the /admin/help documentation within the authoring tool explaining accessibility features is recommended.
The documentation must be provided in an easy to read and accessible format, providing good overview and the possibility to search.
Web author view
Code of end user view
The only common framework for authoring tool is JavaScript. The details will be different per tool, but Scott O’Hara outlined a process for creating Accessible Modal Dialogs with Vanilla JS that can be re-used everywhere. A user could then use click on a button (that looks like 💁♀️):
<div id="unique_ID_to_match_data-modal-open" data-modal>
<h1>
A descriptive title for the dialog
</h1>
<div>
<!--primary content of the dialog here-->
</div>
</div>
Supporting the creation of accessible content when more information is needed.
Documentation of accessibility features is important for all authors. This feature provides short contextual information and the possibility to have more granular information provided separately.
The contextual documentation may be followed by a simple icon indicating that more detailed information or help is available. The icon provides access to a popup or modal dialog that allows the web author to learn more about the specific issue.
In addition to this, a section in the /admin/help documentation within the authoring tool explaining accessibility features is recommended.
The documentation must be provided in an easy to read and accessible format, providing good overview and the possibility to search.
Web author view
Code of end user view
The only common framework for authoring tool is JavaScript. The details will be different per tool, but Scott O’Hara outlined a process for creating Accessible Modal Dialogs with Vanilla JS that can be re-used everywhere. A user could then use click on a button (that looks like 💁♀️):
to launch a dialog that would include:
There are also other models such as this one posted by Alena Nik Inclusive components: making modals accessible https://dev.to/alenanik/inclusive-components-making-modals-accessible-1hn9
or Ire Aderinokun’s Creating An Accessible Modal Dialog https://bitsofco.de/accessible-modal-dialog/
Technically, this is how Drupal added help to the CKEditor Help page https://www.drupal.org/project/drupal/issues/3150364
Video documentation
https://youtu.be/3sDQwc5DMOE
Recommendations for implementation
To make sure the implementation of the features is not causing accessibility problems for web authors with disabilities: