Collapsible
Aberto
import { Collapsible } from '@rivocode/ui'Quando usar
Esconde e mostra um bloco.
É o Accordion de um item só, sem a moldura e sem a coordenação entre irmãos.
Quando há várias seções que se fecham entre si, o Accordion diz mais.
<Collapsible>
<CollapsibleTrigger>Endereço de entrega</CollapsibleTrigger>
<CollapsiblePanel>Rua das Acácias, 120, apto 34, Curitiba - PR.</CollapsiblePanel>
</Collapsible>
O painel anima altura sozinho, e para de animar quando o sistema pede menos movimento.
Quando não usar
Para várias seções que se abrem uma de cada vez, use Accordion: ele coordena
os irmãos e traz a moldura. O Collapsible é um bloco só, como as opções
avançadas no fim de um formulário.
Texto longo que a pessoa pode querer ler ali mesmo é Spoiler: ele corta pela
altura e só mostra o "Ler mais" quando estoura, em vez de esconder tudo atrás de
um título. E esconder o que todo mundo usa só acrescenta um clique.
No React Native
Traduz: o @rivocode/ui-native exporta Collapsible - label no lugar de CollapsibleTrigger e CollapsiblePanel; open/onOpenChange ou defaultOpen, como no web; o mesmo movimento do Accordion. 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 |
|---|---|---|
defaultOpen0.4.0Se o painel recolhível começa aberto. | boolean | false |
disabled0.4.0Se a peça deve ignorar a interação do usuário. | boolean | false |
onOpenChange0.4.0Chamado quando o painel abre ou fecha. | ((open: boolean, eventDetails: CollapsibleRootChangeEventDetails) => void) | sem padrão |
open0.4.0Se o painel recolhível está aberto agora. | boolean | sem padrão |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, CollapsibleRootState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.