Use Toast quando a interface precisar de feedback transitório com região de anúncio apropriada.
Toast
Feedback transitório com região de anúncio apropriada. A documentação abaixo separa composição, comportamento e adaptação visual de cada variante.
Evite a família quando uma composição semântica mais simples comunicar a mesma ação com menos carga visual.
A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Info (básico)
Info (básico), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap; align-items:center;">
<button class="sc-btn sc-btn-outline" type="button" data-toast="info" data-toast-title="Info" data-toast-text="Uma notificação simples.">Disparar</button>
<span class="doc-muted">Saída: canto superior direito</span>
</div><div class="sc-toast-container sc-toast-container--demo" aria-label="Preview de toast (info)">
<div class="sc-toast sc-toast--info" role="status" aria-live="polite">
<div>
<div class="sc-toast-title">Info</div>
<p class="sc-toast-text">Uma notificação simples.</p>
</div>
<button class="sc-toast-close" type="button" aria-label="Fechar"></button>
</div>
</div>Classes, JavaScript e API
Inicialize toast após o DOM. Os atributos data-* do exemplo são a API declarativa.
- Plugin
- toast
- Dependências
- smart-ui.js
- Desde
- 0.1.0
Acessibilidade, teclado e movimento
- Foco visível e ordem de leitura preservados.
- Rótulos acessíveis devem acompanhar controles sem texto.
- A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
Não depende de movimento contínuo.
Temas e responsividade
Compatível com os temas Default, Clean e Tech nos modos claro, escuro e sistema.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Success (com ação)
Success (com ação), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap; align-items:center;">
<button class="sc-btn sc-btn-success" type="button" data-toast="success" data-toast-title="Sucesso" data-toast-text="Operação concluída." data-toast-actions="Ver|Desfazer">Disparar</button>
</div><div class="sc-toast-container sc-toast-container--demo" aria-label="Preview de toast (success)">
<div class="sc-toast sc-toast--success" role="status" aria-live="polite">
<div>
<div class="sc-toast-title">Sucesso</div>
<p class="sc-toast-text">Operação concluída.</p>
<div class="sc-toast-actions">
<button class="sc-btn sc-btn-outline sc-btn-sm" type="button">Ver</button>
<button class="sc-btn sc-btn-outline sc-btn-sm" type="button">Desfazer</button>
</div>
</div>
<button class="sc-toast-close" type="button" aria-label="Fechar"></button>
</div>
</div>Classes, JavaScript e API
Inicialize toast após o DOM. Os atributos data-* do exemplo são a API declarativa.
- Plugin
- toast
- Dependências
- smart-ui.js
- Desde
- 0.1.0
Acessibilidade, teclado e movimento
- Foco visível e ordem de leitura preservados.
- Rótulos acessíveis devem acompanhar controles sem texto.
- A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
Não depende de movimento contínuo.
Temas e responsividade
Compatível com os temas Default, Clean e Tech nos modos claro, escuro e sistema.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Danger (erro)
Danger (erro), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap; align-items:center;">
<button class="sc-btn sc-btn-danger" type="button" data-toast="danger" data-toast-title="Erro" data-toast-text="Algo deu errado.">Disparar</button>
</div><div class="sc-toast-container sc-toast-container--demo" aria-label="Preview de toast (danger)">
<div class="sc-toast sc-toast--danger" role="status" aria-live="polite">
<div>
<div class="sc-toast-title">Erro</div>
<p class="sc-toast-text">Algo deu errado.</p>
</div>
<button class="sc-toast-close" type="button" aria-label="Fechar"></button>
</div>
</div>Classes, JavaScript e API
Inicialize toast após o DOM. Os atributos data-* do exemplo são a API declarativa.
- Plugin
- toast
- Dependências
- smart-ui.js
- Desde
- 0.1.0
Acessibilidade, teclado e movimento
- Foco visível e ordem de leitura preservados.
- Rótulos acessíveis devem acompanhar controles sem texto.
- A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
Não depende de movimento contínuo.
Temas e responsividade
Compatível com os temas Default, Clean e Tech nos modos claro, escuro e sistema.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Warning (atenção)
Warning (atenção), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap; align-items:center;">
<button class="sc-btn sc-btn-outline" type="button" data-toast="warning" data-toast-title="Atenção" data-toast-text="Revise os dados antes de continuar.">Disparar</button>
</div><div class="sc-toast-container sc-toast-container--demo" aria-label="Preview de toast (warning)">
<div class="sc-toast sc-toast--warning" role="status" aria-live="polite">
<div>
<div class="sc-toast-title">Atenção</div>
<p class="sc-toast-text">Revise os dados antes de continuar.</p>
</div>
<button class="sc-toast-close" type="button" aria-label="Fechar"></button>
</div>
</div>Classes, JavaScript e API
Inicialize toast após o DOM. Os atributos data-* do exemplo são a API declarativa.
- Plugin
- toast
- Dependências
- smart-ui.js
- Desde
- 0.1.0
Acessibilidade, teclado e movimento
- Foco visível e ordem de leitura preservados.
- Rótulos acessíveis devem acompanhar controles sem texto.
- A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
Não depende de movimento contínuo.
Temas e responsividade
Compatível com os temas Default, Clean e Tech nos modos claro, escuro e sistema.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Persistente (duration=0)
Persistente (duration=0), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap; align-items:center;">
<button class="sc-btn sc-btn-glass" type="button" data-toast="info" data-toast-title="Persistente" data-toast-text="Este toast não fecha sozinho." data-toast-duration="0">Disparar</button>
<span class="doc-muted">Use “” para fechar</span>
</div><div class="sc-toast-container sc-toast-container--demo" aria-label="Preview de toast (persistente)">
<div class="sc-toast sc-toast--info" role="status" aria-live="polite">
<div>
<div class="sc-toast-title">Persistente</div>
<p class="sc-toast-text">Este toast não fecha sozinho.</p>
</div>
<button class="sc-toast-close" type="button" aria-label="Fechar"></button>
</div>
</div>Classes, JavaScript e API
Inicialize toast após o DOM. Os atributos data-* do exemplo são a API declarativa.
- Plugin
- toast
- Dependências
- smart-ui.js
- Desde
- 0.1.0
Acessibilidade, teclado e movimento
- Foco visível e ordem de leitura preservados.
- Rótulos acessíveis devem acompanhar controles sem texto.
- A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
Não depende de movimento contínuo.
Temas e responsividade
Compatível com os temas Default, Clean e Tech nos modos claro, escuro e sistema.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Com duração custom (6s)
Com duração custom (6s), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap; align-items:center;">
<button class="sc-btn sc-btn-outline" type="button" data-toast="success" data-toast-title="Enviado" data-toast-text="Arquivo enviado." data-toast-actions="Ver" data-toast-duration="6000">Disparar</button>
</div><div class="sc-toast-container sc-toast-container--demo" aria-label="Preview de toast (duração custom)">
<div class="sc-toast sc-toast--success" role="status" aria-live="polite">
<div>
<div class="sc-toast-title">Enviado</div>
<p class="sc-toast-text">Arquivo enviado.</p>
</div>
<button class="sc-toast-close" type="button" aria-label="Fechar"></button>
</div>
</div>Classes, JavaScript e API
Inicialize toast após o DOM. Os atributos data-* do exemplo são a API declarativa.
- Plugin
- toast
- Dependências
- smart-ui.js
- Desde
- 0.1.0
Acessibilidade, teclado e movimento
- Foco visível e ordem de leitura preservados.
- Rótulos acessíveis devem acompanhar controles sem texto.
- A interação preserva foco visível, ordem lógica de Tab e acionamento por Enter ou Espaço quando aplicável.
Não depende de movimento contínuo.
Temas e responsividade
Compatível com os temas Default, Clean e Tech nos modos claro, escuro e sistema.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.