Pular para o conteúdo
Formulário

RadioCard

/componentes/radio-card.mdmarkdown cru, para quem lê com agent em vez de olho

Forma de pagamento

Plano, sem ícone

Importar
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

PropTipoPadrão
titleobrigatória

O nome da opcao, em destaque: "Pix".

ReactNodesem padrão
valueobrigatória

O valor único que identifica a opção no grupo.

unknownsem padrão
classNames

Classe 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
description

A letra miuda que ajuda a decidir: prazo, custo, condicao.

ReactNodesem padrão
disabled

Se a peça deve ignorar a interação do usuário.

booleansem padrão
icon

O desenho a esquerda do texto, escondido do leitor de tela.

ReactNodesem padrão
inputRef

Uma ref para acessar o campo oculto.

Ref<HTMLInputElement>sem padrão
nativeButton

Se a peça renderiza um `<button>` nativo quando é trocada pela prop `render`.

booleanfalse
readOnly

Se o usuário fica impedido de escolher a opção.

booleansem padrão
render

Troca 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
required

Se o usuário precisa escolher um valor antes de enviar o formulário.

booleansem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.