Fieldset
Endereço
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
| Prop | Tipo |
|---|---|
render0.4.0Troca 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.