Pular para o conteúdo
UI

Radio Group

Exibe um grupo de opções de rádio.

Exemplos

Regular

Desabilitado

API

RadioGroup

Contém todas as partes de um grupo de rádio.

PropriedadeTipoPadrãoDescrição
asChildbooleanfalseTroca o elemento renderizado por padrão pelo que for passado como filho, combinando as props e o comportamento.
defaultValuestring-Valor do item de rádio que deve vir marcado na primeira renderização. Use quando você não precisa controlar o estado dos itens.
valuestring-Valor controlado do item de rádio marcado. Deve ser usado junto com onValueChange.
onValueChange(value: string) => void-Função chamada quando o valor muda.
disabledboolean-Quando true, impede o usuário de interagir com os itens de rádio.
namestring-Nome do grupo. É enviado com o formulário como parte de um par nome/valor.
requiredboolean-Quando true, indica que o usuário precisa marcar um item de rádio antes de o formulário ser enviado.
orientation"horizontal" | "vertical" | undefinedundefinedOrientação do componente.
dir"ltr" | "rtl"-Direção de leitura do grupo. Se omitida, herda globalmente do DirectionProvider ou assume o modo LTR (da esquerda para a direita).
loopbooleantrueQuando true, a navegação pelo teclado volta do último item para o primeiro, e vice-versa.
Atributo dataValores
[data-disabled]Presente quando desabilitado

RadioGroupItem

Item do grupo que pode ser marcado. Dentro de um formulário, um input também é renderizado para garantir que os eventos se propaguem corretamente.

PropriedadeTipoPadrãoDescrição
asChildbooleanfalseTroca o elemento renderizado por padrão pelo que for passado como filho, combinando as props e o comportamento.
valuestring-Valor enviado como dado quando o formulário é submetido com um name.
disabledboolean-Quando true, impede o usuário de interagir com os itens de rádio.
requiredboolean-Quando true, indica que o usuário precisa marcar um item de rádio antes de o formulário ser enviado.
variant"regular""regular"Estilo visual do item de rádio.
size"sm" | "md" | "lg""md"Tamanho do item de rádio.
Atributo dataValores
[data-state]"checked" | "unchecked"
[data-disabled]Presente quando desabilitado