Use Botões quando a interface precisar de ações primárias, secundárias, ícone e estados de carregamento.
Botões
Ações primárias, secundárias, ícone e estados de carregamento. 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.
Variantes
Variantes, preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap;">
<button class="sc-btn sc-btn-primary sc-btn-shine" data-spotlight="true" type="button">Primary</button>
<button class="sc-btn sc-btn-secondary sc-btn-shine" data-spotlight="true" type="button">Secondary</button>
<button class="sc-btn sc-btn-success sc-btn-glow" data-spotlight="true" type="button">Success</button>
<button class="sc-btn sc-btn-danger sc-btn-glow" data-spotlight="true" type="button">Danger</button>
<button class="sc-btn sc-btn-outline sc-btn-shine" data-spotlight="true" type="button">Outline</button>
<button class="sc-btn sc-btn-glass sc-btn-shine" data-spotlight="true" type="button">Glass</button>
<button class="sc-btn sc-btn-soft" data-spotlight="true" type="button">Soft</button>
<button class="sc-btn sc-btn-ghost" type="button">Ghost</button>
<button class="sc-btn sc-btn-gradient sc-btn-shine" data-spotlight="true" type="button">Gradient</button>
</div><div class="doc-muted" style="margin: 14px 0 10px;">Efeitos • Animações (opt-in)</div><div style="display:flex; gap:10px; flex-wrap:wrap;">
<button class="sc-btn sc-btn-outline sc-btn-pop" type="button">Pop</button>
<button class="sc-btn sc-btn-primary sc-btn-float" type="button">Float</button>
<button class="sc-btn sc-btn-glass sc-btn-pulse" type="button">Pulse</button>
<button class="sc-btn sc-btn-cutframe" type="button" aria-label="Aplicar para acesso">
Apply for access <i class="sc-icon" data-smart-icon="arrow-right"></i>
</button>
<button class="sc-btn sc-btn-secondary sc-btn-swap" type="button" aria-label="Comprar">
<span class="sc-btn-swap-text">Comprar</span>
<span class="sc-btn-swap-icon"><i class="sc-icon" data-smart-icon="cart"></i></span>
</button>
</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.
Tamanhos
Tamanhos, 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-primary sc-btn-sm" type="button">Small</button>
<button class="sc-btn sc-btn-primary" type="button">Default</button>
<button class="sc-btn sc-btn-primary sc-btn-lg" type="button">Large</button>
</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.
Pill
Pill, preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div style="display:flex; gap:10px; flex-wrap:wrap;">
<button class="sc-btn sc-btn-primary sc-btn-pill" type="button">Assinar</button>
<button class="sc-btn sc-btn-outline sc-btn-pill" type="button">Ver preços</button>
<button class="sc-btn sc-btn-glass sc-btn-pill" type="button">Compartilhar</button>
</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.
Icon buttons
Icon buttons, 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 sc-btn-icon" type="button" aria-label="Favoritar">
<i class="sc-icon" data-smart-icon="star"></i>
</button>
<button class="sc-btn sc-btn-primary sc-btn-icon" type="button" aria-label="Adicionar">
<i class="sc-icon" data-smart-icon="plus"></i>
</button>
<button class="sc-btn sc-btn-glass sc-btn-icon" type="button" aria-label="Configurações">
<i class="sc-icon" data-smart-icon="settings"></i>
</button>
</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.
Grupo
Grupo, preservado do laboratório original e isolado para uso e teste independente.
HTML e exemplo
<div class="sc-btn-group" role="group" aria-label="Grupo de botões">
<button class="sc-btn sc-btn-glass" type="button">Dia</button>
<button class="sc-btn sc-btn-glass" type="button">Semana</button>
<button class="sc-btn sc-btn-glass" type="button">Mês</button>
</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.
Estados (disabled/loading)
Estados (disabled/loading), 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-primary" type="button" disabled="">Disabled</button>
<button class="sc-btn sc-btn-primary is-loading" type="button" aria-disabled="true">Carregando</button>
</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.
FX (box-shadow) estavam em “Efeitos”
FX (box-shadow) estavam em “Efeitos”, 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-ghost sc-btn-fx-fill" type="button">Fill</button>
<button class="sc-btn sc-btn-ghost sc-btn-fx-pulse" type="button">Pulse</button>
<button class="sc-btn sc-btn-ghost sc-btn-fx-slide" type="button">Slide</button>
<button class="sc-btn sc-btn-ghost sc-btn-fx-up" type="button">Up</button>
<button class="sc-btn sc-btn-ghost sc-btn-fx-raise" type="button">Raise</button>
<button class="sc-btn sc-btn-ghost sc-btn-fx-offset" type="button">Offset</button>
<button class="sc-btn sc-btn-ghost sc-btn-fx-close" type="button">Close</button>
</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.
Soft
Soft, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-secondary " type="button">Soft</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.
Ghost
Ghost, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-glass " type="button">Ghost</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.
Destructive
Destructive, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-danger " type="button">Destructive</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.
Success
Success, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-success " type="button">Success</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.
Spotlight
Spotlight, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-primary sc-btn-spotlight" type="button">Spotlight</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- O conteúdo mantém ordem de leitura e foco visível nos elementos acionáveis.
Possui fallback para prefers-reduced-motion.
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.
Split action
Split action, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-outline " type="button">Split action</button><button class="sc-btn sc-btn-primary sc-btn-icon" type="button" aria-label="Mais opções">+</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.
Toolbar
Toolbar, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-glass " type="button">Toolbar</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.
Floating action
Floating action, composição própria do Smart UI para produtos e experiências digitais.
HTML e exemplo
<div class="sc-showcase-actions"><button class="sc-btn sc-btn-primary " type="button">Floating action</button></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
- Mantém contraste de texto e foco visível.
- Conteúdo e ações permanecem disponíveis sem animação.
- 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.