← Documentação · Componentes · Exemplos

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.

Depois de enviada, a solicitação não poderá ser alterada.

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));
AtributoEfeito
idAlvo de data-bs-toggle="modal" e de data-dsgovbr-modal-abrir; gerado se faltar.
tituloTítulo (<h2 class="modal-title">), que dá o nome acessível do diálogo.
tamanhosm, lg, xl ou tela-cheia.
rolagem, centralizado.modal-dialog-scrollable e .modal-dialog-centered.
estaticoBackdrop estático e sem Escape: a pessoa precisa escolher.
rotulo-fechararia-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