Use Tooltip quando a interface precisar de informação suplementar que não substitui rótulos essenciais.
Tooltip
Informação suplementar que não substitui rótulos essenciais. 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.
O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
As composições reduzem colunas, preservam alvos de toque e evitam rolagem horizontal a partir de 320 px.
Botão (top)
Botão (top), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<span class="sc-tooltip" data-tooltip="Topo (default)">
<button class="sc-btn sc-btn-outline" type="button">Passe o mouse</button>
</span>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Posições (left/right/bottom)
Posições (left/right/bottom), 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; width:100%;">
<span class="sc-tooltip" data-tooltip="Left" data-tooltip-pos="left">
<button class="sc-btn sc-btn-outline sc-btn-sm" type="button">Left</button>
</span>
<span class="sc-tooltip" data-tooltip="Bottom" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-outline sc-btn-sm" type="button">Bottom</button>
</span>
<span class="sc-tooltip" data-tooltip="Funciona no foco (Tab)">
<button class="sc-btn sc-btn-glass sc-btn-sm" type="button">Focus</button>
</span>
<span style="flex:1 1 auto;"></span>
<span class="sc-tooltip" data-tooltip="Right" data-tooltip-pos="right" style="margin-left:auto;">
<button class="sc-btn sc-btn-outline sc-btn-sm" type="button">Right</button>
</span>
</div>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Barra social (tooltips)
Barra social (tooltips), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div class="sc-social-bar sc-social-bar--dark" aria-label="Social">
<span class="sc-tooltip" data-tooltip="GitHub" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="github" type="button" aria-label="GitHub">
<i class="sc-icon" data-smart-icon="github"></i>
</button>
</span>
<span class="sc-tooltip" data-tooltip="LinkedIn" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="linkedin" type="button" aria-label="LinkedIn">
<i class="sc-icon" data-smart-icon="linkedin"></i>
</button>
</span>
<span class="sc-tooltip" data-tooltip="Instagram" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="instagram" type="button" aria-label="Instagram">
<i class="sc-icon" data-smart-icon="instagram"></i>
</button>
</span>
<span class="sc-tooltip" data-tooltip="YouTube" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="youtube" type="button" aria-label="YouTube">
<i class="sc-icon" data-smart-icon="youtube"></i>
</button>
</span>
<span class="sc-tooltip" data-tooltip="E-mail" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="mail" type="button" aria-label="E-mail">
<i class="sc-icon" data-smart-icon="mail"></i>
</button>
</span>
</div>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Tooltip longo (legibilidade)
Tooltip longo (legibilidade), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<span class="sc-tooltip" data-tooltip="Texto mais longo para testar overflow e legibilidade do tema. Ideal para dicas de campos e explicações." data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-glass" type="button">Hover</button>
</span>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Popover (Share)
Popover (Share), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div class="sc-tip">
<button class="sc-btn sc-btn-gradient sc-btn-pill" type="button" aria-label="Share">
<span style="display:inline-flex; align-items:center; gap:10px;">
<span>Share</span>
<i class="sc-icon" data-smart-icon="share-2"></i>
</span>
</button>
<div class="sc-tip-panel" role="dialog" aria-label="Compartilhar">
<div class="sc-social-bar sc-social-bar--bare">
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="twitter" type="button" aria-label="Twitter">
<i class="sc-icon" data-smart-icon="send"></i>
</button>
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="linkedin" type="button" aria-label="LinkedIn">
<i class="sc-icon" data-smart-icon="linkedin"></i>
</button>
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="mail" type="button" aria-label="E-mail">
<i class="sc-icon" data-smart-icon="mail"></i>
</button>
<button class="sc-btn sc-btn-ghost sc-btn-icon sc-social-btn" data-social="github" type="button" aria-label="GitHub">
<i class="sc-icon" data-smart-icon="github"></i>
</button>
</div>
<div class="doc-divider" style="margin: 12px 0;"></div>
<div style="display:flex; gap:10px; justify-content:flex-end; flex-wrap:wrap;">
<button class="sc-btn sc-btn-outline sc-btn-sm" type="button">Copiar link</button>
<button class="sc-btn sc-btn-primary sc-btn-sm" type="button">Enviar</button>
</div>
</div>
</div>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Tooltip card (perfil)
Tooltip card (perfil), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div class="sc-tip" style="margin-top: 6px;">
<button class="sc-btn sc-btn-glass sc-btn-icon" type="button" aria-label="Perfil">
<i class="sc-icon" data-smart-icon="user-circle"></i>
</button>
<div class="sc-tip-panel sc-tip-panel--top" role="dialog" aria-label="Perfil">
<div class="sc-card sc-card-outline sc-card-compact" style="margin:0;">
<div style="display:flex; align-items:center; gap:10px;">
<div class="sc-badge sc-badge-soft">UI</div>
<div style="display:grid;">
<strong>User</strong>
<span class="doc-muted" style="margin:0;">@username</span>
</div>
</div>
<div class="doc-divider" style="margin: 12px 0;"></div>
<div style="display:flex; align-items:center; justify-content:space-between; gap:10px;">
<span class="doc-muted" style="margin:0;">800+ seguidores</span>
<button class="sc-btn sc-btn-primary sc-btn-sm" type="button">Seguir</button>
</div>
</div>
</div>
</div>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Tooltip em ícone (ajuda)
Tooltip em ícone (ajuda), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:12px; flex-wrap:wrap; align-items:center;">
<span class="sc-tooltip" data-tooltip="Dica rápida" data-tooltip-pos="right">
<button class="sc-btn sc-btn-outline sc-btn-icon sc-btn-sm" type="button" aria-label="Ajuda">
<i class="sc-icon" data-smart-icon="info"></i>
</button>
</span>
<span class="sc-tooltip" data-tooltip="Atenção: campo obrigatório" data-tooltip-pos="bottom">
<button class="sc-btn sc-btn-outline sc-btn-icon sc-btn-sm" type="button" aria-label="Atenção">
<i class="sc-icon" data-smart-icon="alert-circle"></i>
</button>
</span>
</div>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.
Popover posicionado (right/left)
Popover posicionado (right/left), preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:12px; flex-wrap:wrap; align-items:center;">
<div class="sc-tip">
<button class="sc-btn sc-btn-outline" type="button">Popover right</button>
<div class="sc-tip-panel sc-tip-panel--right" role="dialog" aria-label="Popover right">
<p class="doc-muted" style="margin:0;">Painel à direita, sem cortar e acima do conteúdo.</p>
</div>
</div>
<div class="sc-tip">
<button class="sc-btn sc-btn-outline" type="button">Popover left</button>
<div class="sc-tip-panel sc-tip-panel--left" role="dialog" aria-label="Popover left">
<p class="doc-muted" style="margin:0;">Painel à esquerda.</p>
</div>
</div>
</div>Classes, JavaScript e API
Não exige inicialização. Classes e atributos semânticos são suficientes.
- Plugin
- CSS-first
- Dependências
- Nenhuma
- 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.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
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.