Spoiler
Descrição longa de produto
O plano Equipe organiza os projetos de até cinquenta pessoas, com quadros, cronogramas e arquivos guardados por nós, e cópia de segurança diária avisada por e-mail.
Tarefas, prazos e comentários ficam na mesma tela, e o aviso chega sozinho quando alguém menciona você. O relatório do mês fecha no primeiro dia útil, pronto para a reunião, com as horas de cada projeto e o andamento de cada entrega.
Até cinco convidados de fora usam a conta sem custo extra, cada um com o próprio papel, e o histórico guarda quem criou, moveu ou arquivou cada tarefa.
Texto curto: sem botão
A assinatura vence em 12 de março. Renove antes para não perder o acesso.
Com outros textos no botão
Ao aceitar, você autoriza o envio de avisos do serviço para os contatos da equipe cadastrada, declara que as informações prestadas são verdadeiras e concorda que a RivoCode guarde os arquivos pelo prazo que o contrato prevê. A autorização pode ser revogada a qualquer momento nas configurações da conta, sem prejuízo dos projetos já criados.
import { Spoiler } from '@rivocode/ui'Quando usar
Mostra o começo de um texto longo e esconde o resto atrás de um "Ler mais". A descrição de um produto, o termo de uso, a anotação interna sobre um cliente, a resposta longa de um chamado.
<Spoiler maxHeight={96}>
<p>O plano Equipe organiza os projetos de até cinquenta pessoas…</p>
<p>Tarefas, prazos e comentários ficam na mesma tela…</p>
</Spoiler>
Pela altura, e só quando estoura
O corte é por altura, em pixels (maxHeight, 120 sem a prop), e não por
número de caracteres: o que cabe depende da largura da tela, e a peça mede o
conteúdo de verdade, de novo a cada vez que ele muda de tamanho.
Conteúdo que cabe na altura não ganha botão, nem corte, nem degradê. Por isso
dá para usar o mesmo Spoiler em toda linha de uma lista, com texto curto e
longo misturados.
O corte
Recolhido, as duas últimas linhas visíveis somem num degradê. É uma máscara, e
não uma camada pintada por cima: ela funciona sobre bg, surface, cartão ou
imagem, sem saber a cor do fundo. O degradê mede duas alturas de linha (2lh),
então acompanha o corpo do texto, e a linha que o corte pega pela metade nunca
aparece com a borda seca.
Ao abrir, a caixa cresce até a altura inteira com a duração base e a curva
da casa, e sem movimento quando o sistema pede para reduzir.
O botão
"Ler mais" recolhido, "Ler menos" aberto, e aria-expanded diz o estado para
quem ouve. aria-controls aponta para a caixa. labels troca os dois textos:
<Spoiler labels={{ more: 'Ver o termo inteiro', less: 'Recolher o termo' }}>
<p>Ao aceitar, você autoriza o envio de avisos do serviço…</p>
</Spoiler>
Controlado, open e onOpenChange andam juntos; sem controlar,
defaultOpen decide como nasce. São os mesmos nomes do Collapsible e do
AccordionItem: abrir e fechar se chama open em toda a biblioteca.
O que fica escondido não some
O corte é só visual. O leitor de tela lê o texto inteiro, recolhido ou não, e o
link que estiver abaixo do corte continua na ordem do Tab. Quando o foco entra
num elemento abaixo do corte ou dentro do degradê, o Spoiler abre sozinho,
volta o texto para o começo e traz o elemento focado para a vista, para ninguém
focar o que não vê.
Partes
classNames alcança cada nó pelo nome: content (a caixa que corta) e
trigger (o botão). O className vai na raiz, e é lá que o corpo e o tom do
texto entram.
Quando não usar
- Uma linha ou poucas, cortadas com reticência, sem abrir é
TextcomtruncateoulineClamp. OSpoileré para quem vai querer ler o resto ali mesmo. - Um bloco inteiro que nasce fechado, com título próprio ("Ver os detalhes
do cálculo") é
Collapsible. OSpoilermostra o começo do conteúdo; oCollapsibleesconde tudo atrás do título. - Várias seções que se fecham entre si é
Accordion. - Texto que não cabe e que a pessoa precisa ler inteiro para decidir, como
um contrato antes do aceite, vai aberto numa
ScrollAreaou numDialog. O "Ler mais" convida a pular.
No React Native
Traduz, com os mesmos maxHeight, open, defaultOpen, onOpenChange e labels, e o mesmo botão que só aparece quando o conteúdo estoura. O botão diz o estado por accessibilityState.expanded.
Recolhido, o leitor de tela ouve que o texto está cortado. O overflow esconde só da vista, e o TalkBack e o VoiceOver leem o bloco inteiro. Então o conteúdo recolhido vira um elemento só para o leitor, com a dica "Texto cortado. Toque em Ler mais para ver o resto."; aberto, a dica sai. Link dentro do bloco recolhido não recebe foco próprio até abrir.
O degradê é pintado, e não máscara. O React Native não tem máscara sem dependência nova, então os últimos 40 pontos recebem faixas na cor do fundo, com opacidade crescente. A cor sai de fadeOver (bg, surface ou surface-raised, bg sem a prop): ponha o fundo em que o bloco pousa, senão o degradê aparece como uma faixa.
O className vai na raiz, e as partes vestem pelo mesmo classNames do web: content (a caixa que corta) e trigger (o botão).
API
| Prop | Tipo | Padrão |
|---|---|---|
classNamesClasse por parte: `content` (a caixa que corta) e `trigger` (o botao). | Partial<Record<"content" | "trigger", string>> | sem padrão |
defaultOpenAberto na primeira pintura, sem controlar. | boolean | false |
labelsOs textos do botao. | { more?: string | undefined; less?: string | undefined; } | sem padrão |
maxHeightA altura do recolhido, em pixels. | number | sem padrão |
onOpenChangeRecebe o estado novo a cada "Ler mais" e "Ler menos". | ((open: boolean) => void) | sem padrão |
openAberto, para quem controla. | boolean | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.