Status na matriz: Limitado. Referência: documentação do Bootstrap 5.3.
Modal (.modal)
Janela de diálogo com o plugin Modal do Bootstrap. Referência no GOV.BR DS: Modal com Scrim. Ver a análise do modal.
Interativo
Estático (sem plugin, para comparação visual)
Web component (<dsgovbr-modal>)
JS opcional (dsgovbr-bootstrapped-componentes.js) que monta o markup do modal (cabeçalho com
título e .btn-close, corpo e rodapé de ações) só com as classes do Bootstrap e reusa o plugin
Modal: foco, Escape, backdrop e retorno ao acionador são os do Bootstrap, então o
bootstrap.bundle precisa estar carregado. O próprio elemento é o .modal.fade.
Este modal não fecha com Escape nem clicando fora: só pelos botões.
Conteúdo longo, para mostrar a rolagem interna.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.
Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit.
<button data-dsgovbr-modal-abrir="#confirmar">Abrir</button> <!-- ou data-bs-toggle="modal" data-bs-target="#confirmar" -->
<dsgovbr-modal id="confirmar" titulo="Confirmar envio" centralizado>
Depois de enviada, a solicitação não poderá ser alterada.
<dsgovbr-acoes>
<button class="btn btn-outline-primary" data-bs-dismiss="modal">Cancelar</button>
<button class="btn btn-primary" data-bs-dismiss="modal">Enviar</button>
</dsgovbr-acoes>
</dsgovbr-modal>
document.querySelector("#confirmar").abrir(); // fechar(), alternar(), aberto
document.addEventListener("dsgovbr:modal", (e) => console.log(e.detail.aberto));
| Atributo | Efeito |
|---|---|
id | Alvo de data-bs-toggle="modal" e de data-dsgovbr-modal-abrir; gerado se faltar. |
titulo | Título (<h2 class="modal-title">), que dá o nome acessível do diálogo. |
tamanho | sm, lg, xl ou tela-cheia. |
rolagem, centralizado | .modal-dialog-scrollable e .modal-dialog-centered. |
estatico | Backdrop estático e sem Escape: a pessoa precisa escolher. |
rotulo-fechar | aria-label do botão de fechar (padrão "Fechar"). |
O conteúdo livre vira o corpo; <dsgovbr-acoes> vira o rodapé. Eventos do plugin
(shown.bs.modal, hidden.bs.modal...) continuam disparando; além deles, o elemento avisa com
dsgovbr:modal (detail.aberto).
Diferenças conhecidas em relação à referência GOV.BR DS
- Resolvido por tokens e CSS: sem raio e sem borda, sombra suave, largura de 500px, título de 16,8px em negrito, cabeçalho e rodapé sem divisor e fundo escurecido como o Scrim (preto a 45%).
- O backdrop continua sendo o do plugin Bootstrap, não o componente Scrim (sem as variações de foco e de texto sobre o fundo).
- O web component não usa
.br-modalnem oBRModal: monta o markup do Bootstrap e reusa o plugin, como recomenda a análise #38.