MarsalaDS

Buscar

Páginas e componentes da documentação

Dialog

Uso

Modal centralizado para tarefa ou confirmação com foco. No desktop é o padrão para formulários curtos e confirmações. No mobile, o mesmo fluxo costuma funcionar melhor como Drawer (bottom) — veja o componente Drawer e o exemplo responsivo.

Quando usar

  • Desktop: confirmações, formulários curtos e detalhes com Dialog no centro da tela.
  • Mobile: para fluxos equivalentes, prefira Drawer swipeDirection="down" em vez de dialog pequeno no meio da tela.
  • Título e descrição acessíveis com DialogHeader.
  • Troque Dialog por Drawer por breakpoint (matchMedia); não monte os dois overlays ao mesmo tempo.

Evite quando

  • Não empilhe vários dialogs sem necessidade.
  • Evite conteúdo longo que deveria ser uma página própria.
  • Não use Sheet — o Marsala DS usa apenas Drawer para painéis pela borda.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/dialog

Exemplos

Variações comuns de uso.

Título e descrição

Com ações no rodapé

Com formulário

Sem botão de fechar

Marsala Design System