permalink: /components/dialogmodal/ filename: dialogmodal title: Dialog Modal alpha: false sources:
Dialogs can be utilised to display content over the top of the current context, often as a way of prompting users for a response. While developers wait for the
dialog element to gain better support, we can make use of existing ARIA roles and attributes to replicate its function. It's becoming a common feature of modern interfaces, and a lot of positive attention has been brought to this pattern recently, thanks to Hugo Giraudel's A11y Dialog.
The underlying markup is kept as simple as possible.
buttons are used to open and close the dialog, while overlay and modal containers hold our content. Assigning
id attributes clarify which triggers are controlling their respective modal content. As the modal isn't visible by default, we add
aria-hidden="true" to the overlay container as part of its initialisation.
Giving the modal container a
role="dialog" communicates the function of the component to assistive technologies. If the content represents an alert, error or warning, we can instead use
role="alertdialog" to ensure we're presenting something that requires an immediate response from the user before continuing. The immediate child node of the modal requires an element with
role="document". This allows assistive technologies to switch to document browsing mode, providing complete access to the modal content.
An important consideration that is often overlooked with standard dialog implementations is user focus. When opening, focus is applied to the first focusable item within the modal. At the same time the
Esc key and overlay/close button click events are bound to allow users to dismiss the dialog. When the dialog is visible, using the
tab key will retain focus among elements within the modal, as to avoid applying focus to elements in the surrounding page. Lastly, we can return focus to the original trigger when closing the modal to maintain the users' place in the document.
A heading within the modal and a related
aria-labelledby attribute is required on the modal to clearly define the title of the dialog for assistive technologies.
Frdialogmodal is available to install with
npm. Run with the
--save flag to add the component your project dependencies.
npm install fr-dialogmodal --save
The component will then be available to
Functional styles for the modal (dialogmodal.css) that are required to display the component states correctly should be referenced via a
<link> in the
<head> of your document, or can be integrated into your existing stylesheet.
Assign the function invocation to a variable.
var myModal = ;
// remove all bindings and attributes when no longer neededmyModal;// re-initialise as neededmyModal;
var myModal =;