RadioCard
Forma de pagamento
Plano, sem ícone
import { RadioCard } from '@rivocode/ui'Quando usar
Opção em cartão, dentro de um RadioGroup: forma de pagamento, plano, frete.
Cada cartão é um Radio inteiro, com title em destaque, description na
letra miúda e icon à esquerda. O cartão todo é o alvo: clicar no texto, no
ícone ou na borda escolhe. O title é o nome que o leitor de tela anuncia, e
a description vira a descrição do radio (aria-describedby), então quem
ouve a tela escuta "Boleto, compensa em até 3 dias úteis". O escolhido troca a
borda para o acento, e o círculo continua lá, porque cor sozinha não diz o
estado.
<RadioGroup aria-label="Forma de pagamento" defaultValue="pix">
<RadioCard value="pix" title="Pix" description="Cai na hora." />
<RadioCard value="boleto" title="Boleto" description="Compensa em até 3 dias úteis." />
</RadioGroup>
O RadioGroup empilha os cartões; para pô-los lado a lado, troque o
className dele por uma grade (grid grid-cols-1 gap-2 sm:grid-cols-2). O
className do RadioCard veste o cartão, e classNames alcança card,
control, icon, title e description. disabled desliga a opção, que
fica no lugar com a cara de desligada.
Quando não usar
Quando as opções são curtas e não precisam de explicação (sim ou não, um
status), use Radio no RadioGroup: cartão ocupa quatro vezes a altura e
empurra o resto do formulário para baixo. Quando mais de uma vale, é
CheckboxCard. E com mais de seis opções, cartão vira rolagem: é Select.
No React Native
Traduz pelo nome e pelas partes do web: title, description, icon, disabled, invalid e classNames (card, control, icon, title, description). O cartão inteiro é o alvo do toque, com papel radio e o estado checked, e a escolhida troca a borda para o acento.
Controlado por checked e onCheckedChange. No web o RadioCard mora dentro de um RadioGroup que guarda o valor; no nativo o RadioGroup recebe items e não tem filhos, então cada cartão diz se está escolhido, e o toque no que ainda não está chama onCheckedChange(true). Ponha os cartões numa View com accessibilityRole="radiogroup" e o nome da pergunta.
media é a área livre de cima, e só existe aqui. Até a 5.0 o cartão do nativo era só o desenho do item do RadioGroup variant="card", decisão escrita como vira. Um app real precisou escolher pelo desenho - o tema, o plano com a ilustração -, e o icon do ToggleGroup e o do cartão cabem em 16 a 20pt, que não serve para isso. media ocupa a largura do cartão, em cima do texto, no tamanho que quem a passa escolher, e fica escondida do leitor de tela, que ouve o title. O RadioGroup variant="card" continua sendo o atalho para a lista sem desenho grande.
API
| Prop | Tipo | Padrão |
|---|---|---|
titleobrigatóriaO nome da opcao, em destaque: "Pix". | ReactNode | sem padrão |
valueobrigatóriaO valor único que identifica a opção no grupo. | unknown | sem padrão |
classNamesClasse por parte: `card` (o cartao inteiro, que e o `<label>`), `control` (o circulo), `icon`, `title` e `description`. | Partial<Record<"card" | "control" | "description" | "icon" | "title", string>> | sem padrão |
descriptionA letra miuda que ajuda a decidir: prazo, custo, condicao. | ReactNode | sem padrão |
disabledSe a peça deve ignorar a interação do usuário. | boolean | sem padrão |
iconO desenho a esquerda do texto, escondido do leitor de tela. | ReactNode | sem padrão |
inputRefUma ref para acessar o campo oculto. | Ref<HTMLInputElement> | sem padrão |
nativeButtonSe a peça renderiza um `<button>` nativo quando é trocada pela prop `render`. | boolean | false |
readOnlySe o usuário fica impedido de escolher a opção. | boolean | sem padrão |
renderTroca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, RadioRootState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
requiredSe o usuário precisa escolher um valor antes de enviar o formulário. | boolean | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.