A brief look at HTML 5.2 Dialog

11th January 2018

HTML Dialog has been hanging around for awhile, but until recently, was not part of W3C’s recommended spec. Now that major browsers have started to support the dialog element, we are likely to see it being used more widely. This article takes a brief look at how we use dialogs, why the new element is needed and how it can be used today.

What is a dialog?

Dialogs are a design pattern that can be used in many ways, including, but not limited to: displaying important information, requesting a choice from a user or expanding on an existing piece of content. Although dialogs can take form in different ways, they are most commonly implemented as modals; isolated from other content in an overlay.

Why is the dialog element needed?

Up until the release of the new element, to implement a dialog into a site you would have had to write it all from scratch or use an external library - there was no standard syntax or default styling for such component. A lack of standards meant that browsers and assistive technologies like screen readers could not differentiate dialog-related content from other page content by default.

To get around the accessibility issues, developers would have had to use aria attributes such as role="dialog" to describe the content within a dialog. Managing keyboard focus correctly is also important for accessibility with dialogs, for example, there must be at least one focusable control within the dialog. For a list of all of the accessibility requirements related to dialogs, check out this page on MDN.

Some great libraries were created to make implementing accessible dialogs easier for developers, such as A11y Dialog by Edenspiekermann. As well as such libraries, CSS frameworks like Bootstrap and Foundation put a lot of work into making their in-built modals/dialogs accessible.

Although these libraries and frameworks are still as relevant and useful today, having a native HTML element for dialogs ensures that there is the syntax, standards and accessibility that such a frequently used design pattern needs to be great for everyone. Also, having dialog logic built into browsers saves those precious bytes of code!

Using the Dialog element

Now we understand why it is needed, let’s take a look at how we use the dialog element.


The markup for a dialog element is as simple as wrapping some content in a <dialog> tag. In order to make the dialog functional, we need a button to open it, as well as a button to close or navigate away from it.

<button type="button" class="js-open">Open Dialog</button>

<dialog class="js-dialog">
  <h2>Dialog heading</h2>
  <button type="button" class="js-close">Close Dialog</button>

To have the dialog open by default, an open attribute can be added.

<dialog open>

If your dialog contains a form, the form element should have a method attribute set to dialog.

<form method="dialog">


Without JavaScript, the dialog element will not be interactive. We can hook up the buttons and dialog element from the HTML example above to some click event listeners.

const dialog = document.querySelector('.js-dialog')
const openButton = document.querySelector('.js-open')
const closeButton = document.querySelector('.js-close')

openButton.addEventListener('click', () => {

closeButton.addEventListener('click', () => {

And that’s it, we have a working, native dialog!


The default styling on the dialog element is not going to be to everyone’s taste… fortunately, we can style it with CSS.

dialog {
  padding: 30px;
  border: 0;
  border-radius: 10px;
  box-shadow: 0 2px 15px 0 rgba(0, 0, 0, 0.1);

There is also a handy selector for the backdrop.

dialog::backdrop {
  background: rgba(0, 0, 0, 0.7);


Here is a demo of how the dialog element can be used.

See the Pen HTML 5.2 Dialog by Kenan Yusuf (@KenanYusuf) on CodePen.


Way back in 2014, Chrome and Opera started supporting the dialog element and more recently, Chrome Android and the Samsung browser. It is also supported by Firefox but must be enabled through about:config. Despite a few of the major browsers not supporting dialog, there is a good polyfill available.

Can I Use dialog? Data on support for the dialog feature across the major browsers from caniuse.com.

Latest articles

Completely CSS: Tabs

14th November 2016

Mailto links: Letting the user decide

4th November 2016

Password visibility toggles

1st November 2016