Pular para o conteúdo
Formulário

Fieldset

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

Endereço

Endereço
Importar
import { Fieldset } from '@rivocode/ui'

Quando usar

Agrupa campos que respondem à mesma pergunta: endereço, dados do cliente, pagamento.

A legenda não é só título: o leitor de tela anuncia ela junto com o rótulo de cada campo dentro. "Número" sozinho não diz nada; "Endereço, número" diz.

<Fieldset>
  <FieldsetLegend>Endereço</FieldsetLegend>

  <Field>
    <FieldLabel>Rua</FieldLabel>
    <Input placeholder="Av. Epitácio Pessoa" />
  </Field>

  <Field>
    <FieldLabel>Número</FieldLabel>
    <Input placeholder="1200" />
  </Field>
</Fieldset>

O respiro entre grupos é maior que o respiro entre campos, de propósito: é ele que mostra onde um assunto termina.

Quando não usar

Quando uma etapa depende da anterior, porque a escolha de uma muda a seguinte, use Steps com useWizard. O Fieldset é para o cadastro longo de campos independentes, todos à vista: quebrar em passos ali só esconde o tamanho.

Para esconder o que poucos usam, como as opções avançadas, é Collapsible. E um campo só não pede Fieldset: a legenda repetiria o rótulo.

No React Native

Traduz: o @rivocode/ui-native exporta Fieldset - legend como prop. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.

API

PropTipo
render0.4.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, FieldsetRootState> | ReactElement<unknown, string | JSXElementConstructor<any>>

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.