Ações

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.

PropriedadeValores e comportamentoPadrão
variantsolid, outline, soft, ghost, linksolid
toneprimary, neutral, info, success, warning, dangerprimary
sizexs, sm, md, lgmd
roundedbooleanfalse
fullWidthbooleanfalse
responsivebooleanfalse
iconOnlybooleanfalse
startIcon / endIconJSX.Element—
loadingbooleanfalse
disabledbooleanfalse
typebutton, submit, resetbutton
aria-labelstring—
aria-pressedtrue, false, mixed—