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.
| Propriedade | Tipo | Padrão | Descrição |
|---|---|---|---|
| asChild | boolean | false | Troca o elemento renderizado por padrão pelo que for passado como filho, combinando as props e o comportamento. |
| defaultValue | string | - | 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. |
| value | string | - | 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. |
| disabled | boolean | - | Quando true, impede o usuário de interagir com os itens de rádio. |
| name | string | - | Nome do grupo. É enviado com o formulário como parte de um par nome/valor. |
| required | boolean | - | Quando true, indica que o usuário precisa marcar um item de rádio antes de o formulário ser enviado. |
| orientation | "horizontal" | "vertical" | undefined | undefined | Orientaçã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). |
| loop | boolean | true | Quando true, a navegação pelo teclado volta do último item para o primeiro, e vice-versa. |
| Atributo data | Valores |
|---|---|
| [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.
| Propriedade | Tipo | Padrão | Descrição |
|---|---|---|---|
| asChild | boolean | false | Troca o elemento renderizado por padrão pelo que for passado como filho, combinando as props e o comportamento. |
| value | string | - | Valor enviado como dado quando o formulário é submetido com um name. |
| disabled | boolean | - | Quando true, impede o usuário de interagir com os itens de rádio. |
| required | boolean | - | 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 data | Valores |
|---|---|
| [data-state] | "checked" | "unchecked" |
| [data-disabled] | Presente quando desabilitado |