Pular para o conteúdo
Estrutura

Accordion

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

Perguntas

Pelo botão Pedir troca, na página do pedido. O pedido fica salvo se você sair no meio.

Importar
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

PropTipoPadrão
defaultValue0.4.0

Os itens abertos de início, no modo não controlado.

AccordionValue<Value>sem padrão
disabled0.4.0

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

booleanfalse
hiddenUntilFound0.4.0

Deixa a busca da página do próprio navegador achar e abrir o conteúdo do painel.

booleanfalse
keepMounted0.4.0

Se o elemento fica no DOM com o painel fechado.

booleanfalse
loopFocus0.4.0

Obsoleta desde a [atualização da APG](https://github.com/w3c/aria-practices/pull/3434) que tirou o foco itinerante.

booleansem padrão
multiple0.4.0

Se mais de um item pode ficar aberto ao mesmo tempo.

booleanfalse
onValueChange0.4.0

Chamado quando um item do acordeão abre ou fecha.

((value: AccordionValue<Value>, eventDetails: AccordionRootChangeEventDetails) => void)sem padrão
orientation0.4.0

Obsoleta desde a [atualização da APG](https://github.com/w3c/aria-practices/pull/3434) que tirou o foco itinerante.

Orientation"vertical"
render0.4.0

Troca 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.0

Os 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.

@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.