PreviewCard
Em link
import { PreviewCard } from '@rivocode/ui'Quando usar
O cartão que aparece ao pousar sobre um link: quem é a aluna, o que é aquele pedido, o resumo do termo.
Não é Tooltip. A dica explica um botão em poucas palavras e some ao sair;
o cartão mostra conteúdo que dá para ler com calma, e por isso ele espera antes
de abrir e demora a fechar, para o ponteiro chegar até ele.
Nada que só exista aqui é alcançável por toque, então o cartão nunca pode ser o único caminho para uma informação.
<PreviewCard>
<PreviewCardTrigger render={<a href="/alunos/4813" />}>Ana Clara Ribeiro</PreviewCardTrigger>
<PreviewCardContent>
<p className="font-medium text-fg">Ana Clara Ribeiro</p>
<p className="text-sm text-fg-muted">Aluna desde 2023, turma de inglês B1.</p>
</PreviewCardContent>
</PreviewCard>
Quando não usar
Para ação dentro do cartão (um botão, um filtro, um formulário curto), use
Popover: este abre no hover e no foco, e um controle que some quando o
ponteiro sai do lugar não se alcança com calma. A dica de poucas palavras de um
botão só de ícone é Tooltip.
E como nada daqui chega pelo toque, o que a pessoa precisa saber para decidir vai na própria tela ou na página que o link abre, e não só no cartão.
No React Native
Não porta, por decisão - aparece ao pousar o ponteiro, e não há pousar no toque. Não é fila: não vai existir. A tabela de paridade diz o porquê de cada uma.
API
| Prop | Tipo | Padrão |
|---|---|---|
actionsRef0.4.0Uma ref para as ações imperativas. | RefObject<PreviewCardRootActions | null> | sem padrão |
defaultOpen0.4.0Se o cartão de prévia começa aberto. | boolean | false |
defaultTriggerId0.4.0ID do gatilho ao qual o cartão de prévia está associado. | string | null | sem padrão |
handle0.4.0Um identificador que associa o cartão de prévia a um gatilho. | PreviewCardHandle<Payload> | sem padrão |
onOpenChange0.4.0Chamado quando o cartão de prévia abre ou fecha. | ((open: boolean, eventDetails: PreviewCardRootChangeEventDetails) => void) | sem padrão |
onOpenChangeComplete0.4.0Chamado depois que as animações terminam, quando o cartão de prévia abre ou fecha. | ((open: boolean) => void) | sem padrão |
open0.4.0Se o cartão de prévia está aberto agora. | boolean | sem padrão |
triggerId0.4.0ID do gatilho ao qual o cartão de prévia está associado. | string | null | sem padrão |