Pular para o conteúdo
Sobreposição

PreviewCard

/componentes/preview-card.mdmarkdown cru, para quem lê com agent em vez de olho
Importar
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

PropTipoPadrão
actionsRef0.4.0

Uma ref para as ações imperativas.

RefObject<PreviewCardRootActions | null>sem padrão
defaultOpen0.4.0

Se o cartão de prévia começa aberto.

booleanfalse
defaultTriggerId0.4.0

ID do gatilho ao qual o cartão de prévia está associado.

string | nullsem padrão
handle0.4.0

Um identificador que associa o cartão de prévia a um gatilho.

PreviewCardHandle<Payload>sem padrão
onOpenChange0.4.0

Chamado quando o cartão de prévia abre ou fecha.

((open: boolean, eventDetails: PreviewCardRootChangeEventDetails) => void)sem padrão
onOpenChangeComplete0.4.0

Chamado depois que as animações terminam, quando o cartão de prévia abre ou fecha.

((open: boolean) => void)sem padrão
open0.4.0

Se o cartão de prévia está aberto agora.

booleansem padrão
triggerId0.4.0

ID do gatilho ao qual o cartão de prévia está associado.

string | nullsem padrão

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