Button
Acione uma operação, envie um formulário ou confirme uma decisão com um botão nativo.
Uso básico
Por padrão, Button usa type="button". Em um formulário, use type="submit" para enviar. Para navegar até uma URL, use um link <a>.
Variantes
O variant define a ênfase visual. Use solid para a ação principal, outline ou soft para alternativas e ghost para ações discretas. link dá ao botão a aparência de um link.
Tons
O tone comunica a intenção da ação e acompanha o tema. Por exemplo, danger sinaliza uma ação destrutiva.
Tamanhos
As alturas padrão vão de 24 px (xs) a 48 px (lg). Com responsive, o botão usa um tamanho abaixo em telas menores que 640 px. xs fica com a mesma altura. Use rounded para cantos em formato de pílula e fullWidth para preencher a largura disponível.
Ícones
Use startIcon ou endIcon para complementar um rótulo. Dê um nome acessível com aria-label quando o botão tiver só um ícone.
Estados
Use disabled para indisponibilidade e loading durante uma operação. Durante o carregamento, o botão bloqueia novos cliques, mantém sua largura e seu nome acessível e expõe aria-busy. Use aria-pressed para uma ação de alternância, como marcar um favorito. Passe o ponteiro, use Tab ou mantenha o botão pressionado para ver hover, foco e :active.
API
Button também aceita atributos, eventos e refs do elemento HTML button. O foco de teclado e a ativação por Enter ou Espaço seguem o comportamento nativo.
| Propriedade | Valores e comportamento | Padrão |
|---|---|---|
variant | solid, outline, soft, ghost, link | solid |
tone | primary, neutral, info, success, warning, danger | primary |
size | xs, sm, md, lg | md |
rounded | boolean | false |
fullWidth | boolean | false |
responsive | boolean | false |
iconOnly | boolean | false |
startIcon / endIcon | JSX.Element | — |
loading | boolean | false |
disabled | boolean | false |
type | button, submit, reset | button |
aria-label | string | — |
aria-pressed | true, false, mixed | — |