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.
Caixas de diálogo modais
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?
::background.::backdrop.background.