Accordion
Perguntas
import { Accordion } from '@rivocode/ui'Quando usar
Sanfona, para perguntas frequentes e para grupos de conteúdo que a pessoa abre um de cada vez.
O AccordionItem entrega cabeçalho, gatilho e painel numa peça só, porque a
Base UI exige a ordem exata entre eles e expor as partes soltas só criaria um
jeito de montar errado.
Formulário em seções
Fechado, o item desmonta o conteúdo, e campo desmontado perde o que foi digitado
e some do FormErrorSummary. Num cadastro dividido em seções, passe
hiddenUntilFound em cada AccordionItem: o conteúdo fica montado e
escondido, a busca da página acha o texto e abre a seção, e o link do
FormErrorSummary abre a seção fechada antes de levar o foco ao campo.
keepMounted só mantém montado, sem abrir para a busca.
<Accordion multiple>
<AccordionItem value="dados" title="Dados do paciente" hiddenUntilFound>
<FormField name="name" label="Nome">…</FormField>
</AccordionItem>
</Accordion>
triggerId e panelId dão o id do botão e do conteúdo, para apontar para
eles de fora; o id do próprio AccordionItem continua no item inteiro.
Quando não usar
Para um bloco só que se abre e fecha, como as opções avançadas de um
formulário, use Collapsible: é o Accordion de um item, sem a moldura e sem
a coordenação entre irmãos.
Seções que a pessoa alterna na mesma página, uma de cada vez, leem melhor em
Tabs. Antes de esconder as seções de um cadastro, veja se o Fieldset não
basta: ele divide em seções com título, todas à vista, e quem preenche enxerga
o tamanho do formulário. E acontecimento, como a chamada de ferramenta de um
assistente, é ToolCall: o Accordion organiza texto.
No React Native
Traduz: o @rivocode/ui-native exporta Accordion - value, defaultValue e onValueChange na raiz, pelo value de cada AccordionItem; um aberto por vez, como no web (multiple deixa vários), e item sem value abre sozinho. O title aceita nó, e description mostra o estado atual embaixo dele, visível fechado. Abre com a seta girando e o corpo em fade, e sem movimento quando o sistema pede para reduzir. 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 | Padrão |
|---|---|---|
defaultValue0.4.0Os itens abertos de início, no modo não controlado. | AccordionValue<Value> | sem padrão |
disabled0.4.0Se a peça deve ignorar a interação do usuário. | boolean | false |
hiddenUntilFound0.4.0Deixa a busca da página do próprio navegador achar e abrir o conteúdo do painel. | boolean | false |
keepMounted0.4.0Se o elemento fica no DOM com o painel fechado. | boolean | false |
loopFocus0.4.0Obsoleta desde a [atualização da APG](https://github.com/w3c/aria-practices/pull/3434) que tirou o foco itinerante. | boolean | sem padrão |
multiple0.4.0Se mais de um item pode ficar aberto ao mesmo tempo. | boolean | false |
onValueChange0.4.0Chamado quando um item do acordeão abre ou fecha. | ((value: AccordionValue<Value>, eventDetails: AccordionRootChangeEventDetails) => void) | sem padrão |
orientation0.4.0Obsoleta desde a [atualização da APG](https://github.com/w3c/aria-practices/pull/3434) que tirou o foco itinerante. | Orientation | "vertical" |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, State<Value>> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
value0.4.0Os itens abertos, no modo controlado. | AccordionValue<Value> | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.