Caixa de diálogo

Uma caixa de diálogo modal é um tipo especial de caixa pop-up que interrompe o usuário em uma página da Web. Embora existam alguns casos de uso válidos para abrir uma caixa de diálogo, pense bem antes de adicionar uma. As caixas de diálogo modais forçam os usuários a se concentrar em um conteúdo específico e ignorar temporariamente o restante da página.

As caixas de diálogo podem ser:

  • Modal: os usuários só podem interagir com o conteúdo dentro da caixa de diálogo. As caixas de diálogo modais são exibidas na parte de cima do conteúdo da página. A página é definida como inert e, por padrão, é obscurecida por um plano de fundo semitransparente.
  • Não modal: os usuários podem interagir com o conteúdo fora da caixa de diálogo.

O elemento HTML semântico <dialog> para criar uma caixa de diálogo vem com semântica, interações de teclado e todas as propriedades e métodos da interface HTMLDialogElement.

Confira um exemplo de modal <dialog>. Clique em Abrir caixa de diálogo modal. Depois de aberta, há três maneiras de fechar a caixa de diálogo: a tecla Esc, o envio de um formulário com um botão que tenha o formmethod="dialog" definido (ou se o próprio formulário tiver method="dialog" definido) e o método HTMLDialogElement.close().

A HTMLDialogElement tem três métodos principais, além de todos os métodos herdados de HTMLElement.

dialog.show() /* opens the dialog */
dialog.showModal() /* opens the dialog as a modal */
dialog.close() /* closes the dialog */

Como esse <dialog> foi aberto com o método HTMLDialogElement.showModal(), ele é uma caixa de diálogo modal. A abertura de uma caixa de diálogo modal desativa e oculta tudo, exceto a própria caixa de diálogo. Quando você passa o cursor sobre a interface fora da caixa de diálogo, todos os elementos se comportam como se pointer-events: none; estivesse definido. Até mesmo o botão que abre a caixa de diálogo não vai reagir às interações.

Quando a caixa de diálogo é aberta, o foco é movido para ela. O foco é definido no primeiro elemento na ordem de navegação sequencial do teclado dentro dessa caixa de diálogo. Se você pressionar a tecla tab repetidamente, apenas o conteúdo dentro da caixa de diálogo poderá receber foco enquanto o modal estiver aberto. Tudo fora do modal permanece inerte.

Quando uma caixa de diálogo é fechada, modal ou não, o foco retorna ao elemento que a abriu. Evite abrir uma caixa de diálogo de forma programática sem uma ação do usuário. Se for necessário, retorne o foco para onde ele estava antes da abertura da caixa de diálogo, especialmente se o usuário dispensar a caixa de diálogo sem interagir com ela.

Há um atributo global inert que pode ser usado para desativar um elemento e todos os descendentes dele, exceto qualquer caixa de diálogo ativa. Quando uma caixa de diálogo modal é aberta usando showModal(), a inatividade ou desativação ocorre por padrão. O atributo não está definido explicitamente.

O plano de fundo que oculta tudo, exceto a caixa de diálogo, pode ser estilizado usando o pseudoelemento ::backdrop. O plano de fundo só é exibido quando um <dialog> é mostrado com o método .showModal(). Esse pseudoelemento corresponde a todos os planos de fundo, incluindo o que é exibido quando a API FullScreen é usada, como ao assistir um vídeo no modo de tela cheia que não tem a mesma proporção da tela ou do monitor.

Caixas de diálogo não modais

O HTMLDialogElement.show() também abre uma caixa de diálogo, mas sem adicionar um plano de fundo ou fazer com que algo fique inerte. A tecla Esc só fecha caixas de diálogo modais, não as não modais. Por isso, é ainda mais importante incluir um método para fechar a caixa de diálogo não modal. Se a opção de fechar estiver fora da caixa de diálogo, o foco vai retornar ao elemento que abriu a caixa de diálogo. Essa não é uma experiência ideal para o usuário.

Embora um botão para fechar a caixa de diálogo não seja oficialmente exigido pela especificação, considere-o obrigatório. Um botão visível que pode receber foco melhora a acessibilidade e a experiência do usuário.

Como fechar uma caixa de diálogo

Não é necessário usar o método HTMLDialogElement.close() para fechar uma caixa de diálogo. Você não precisa de JavaScript. Para fechar o <dialog> sem JavaScript, inclua um formulário com um método de caixa de diálogo definindo method="dialog" no <form> ou formmethod="dialog" no botão.

Quando um usuário envia com o método dialog, o estado dos dados inseridos pelo usuário é mantido. Enquanto houver um evento de envio, o formulário vai passar pela validação de restrição, a menos que novalidate esteja definido. Os dados do usuário não são apagados nem enviados. É possível criar um botão de fechar sem JavaScript:

<dialog open>
  <form method="dialog">
    <button type="submit" autofocus>close</button>
  </form>
</dialog>

Você deve ter notado o atributo autofocus definido no <button> de fechamento neste exemplo. Os elementos com o atributo autofocus definido em um <dialog> só recebem foco no carregamento da página se ela já tiver sido carregada com a caixa de diálogo visível. Se a página não tiver sido carregada, esses elementos vão receber o foco quando a caixa de diálogo for aberta.

Quando uma caixa de diálogo é aberta, o primeiro elemento focalizável nela recebe o foco, a menos que um elemento diferente tenha o atributo autofocus definido. Definir o atributo autofocus no botão de fechar garante que ele receba o foco quando a caixa de diálogo for aberta. No entanto, incluir autofocus em um <dialog> só deve ser feito com muita consideração. Todos os elementos na sequência que vêm antes do elemento com foco automático são ignorados. Discutimos esse atributo em mais detalhes no módulo de foco.

A interface HTMLDialogElement inclui uma propriedade returnValue. O envio de um formulário com um method="dialog" define o returnValue como o name, se houver, do botão usado para enviar o formulário. Se escrevêssemos <button type="submit" name="toasty">close</button>, o returnValue seria toasty.

Quando uma caixa de diálogo é aberta, o atributo booleano open está presente, o que significa que ela está ativa e pode ser usada. Quando uma caixa de diálogo é aberta adicionando o atributo open em vez de .show() ou .showModal(), ela não é modal. A propriedade HTMLDialogElement.open retorna true ou false, dependendo se a caixa de diálogo está disponível para interação, não se ela é modal ou não.

Embora o JavaScript seja o método preferido para abrir uma caixa de diálogo, incluir o atributo open no carregamento da página e removê-lo com .close() pode ajudar a garantir que a caixa de diálogo esteja disponível mesmo quando o JavaScript não estiver.

Mais detalhes

Não use tabindex.

O elemento ativado para abrir a caixa de diálogo e o botão de fechar que ela contém (e possivelmente outros conteúdos) podem receber foco e são interativos. O elemento <dialog> não é interativo e não recebe foco. Não adicione a propriedade tabindex à caixa de diálogo.

Papéis ARIA

O papel implícito é dialog. Se a caixa de diálogo for uma janela de confirmação que comunica uma mensagem que exige uma resposta ou confirmação do usuário, defina role="alertdialog". Inclua um nome acessível para a caixa de diálogo. Se o texto visível puder fornecer o nome acessível, adicione aria-labelledby="idOfLabelingText".

Padrões de CSS

Os navegadores fornecem um estilo padrão para dialog. O Firefox, o Chrome e o Edge definem color: CanvasText; e background-color: Canvas;. O Safari define color: black; background-color: white; nas folhas de estilo do user agent. O color é herdado de dialog, em vez de body ou :root, o que pode ser inesperado. A propriedade background-color não é herdada.

Teste seu conhecimento

Teste seus conhecimentos sobre o elemento de diálogo.

Como você estiliza a área atrás da caixa de diálogo?

Com o pseudoelemento ::background.
Tente de novo.
Com o pseudoelemento ::backdrop.
Correto.
Com a propriedade background.
Tente de novo.