Componentdata-display

Shimmering Text

Stable

Texto cujos caracteres clareiam em sequência. Serve para dizer que algo ainda está acontecendo, onde um spinner seria alto demais e um rótulo estático pareceria travado — é irmão do Skeleton, não decoração. A fonte usava um controlador de animação por caractere via `motion`; a revisão arquitetural que o DS009 pediu terminou onde costuma terminar: uma varredura de cor em laço com início escalonado é um keyframe e um atraso, então a dependência saiu e a duração passou a viver em --motion-loop-duration, onde prefers-reduced-motion a alcança.

Instalação

npx up-web-ds add shimmering-text

Preview

Default

Validando o catálogo…

With Skeleton

Gerando o adapter de ícones para os quatro providers…

Stopped

Publicando no registry…Publicando no registry…

Slower

Compilando o mapping em Lucide, Phosphor, Hugeicons e Tabler…

All states

Default

Validando o catálogo…

With Skeleton

Gerando o adapter de ícones para os quatro providers…

Stopped

Publicando no registry…Publicando no registry…

Slower

Compilando o mapping em Lucide, Phosphor, Hugeicons e Tabler…

Usage

@/components/shimmering-text
import { ShimmeringText } from '@/components/shimmering-text'
Shimmering Text
<ShimmeringText text="Validando o catálogo…" className="type-small" />

Props

Props de ShimmeringText
PropTypeDefaultDescription
text, obrigatóriastringsem valor padrãoThe text to render with the shimmering effect.
durationnumbersem valor padrãoDuration of one shimmer cycle, in seconds. Left unset it takes the Foundation's ambient loop duration, which is what the skeleton sweep uses too. Set it when this particular text needs to read slower than the rest of the page, not to make it stand out more.
isStoppedbooleanfalseWhether the shimmer is paused.

Estende Omit< React.ComponentProps<'span'>, 'children' >. Aceita também os atributos padrão de um elemento React (279 não listados).

prop obrigatória.

Metadata

Notas de acessibilidade

Não é interativo: não entra na sequência de tabulação e não tem estado, então teclado e alvo de toque não têm superfície onde falhar. Leitor de tela verificado por teste: os caracteres animados são aria-hidden e a frase inteira é repetida uma vez em sr-only, porque uma palavra dividida em onze spans é uma palavra anunciada como onze letras; a divisão é por code point, então caracteres fora do plano básico não são partidos ao meio; e o texto visível não ganha separadores, para que copiar e colar devolva a frase e não uma coluna de letras. Reduced motion verificado em navegador com prefers-reduced-motion: reduce — a varredura é aplicada em motion-safe:animate-text-shimmer, então sob reduce ela não roda: o texto para em vez de acelerar e permanece exatamente onde estava. A cor de repouso vive no wrapper e não no keyframe, então texto que nunca anima continua legível em vez de ficar preso no meio de um gradiente. O estado parado também derruba a animação em vez de congelá-la no meio, para que um processo concluído não deixe uma linha com cara de travada.

Classificação

Layer
Component
Domínio
Application
Categoria
data-display
Status
Stable

Origem e distribuição

Fonte
ncdai registry / shimmering-text
Licença
MIT
Distribuição
Interna

Acessibilidade

  • Teclado: revisado
  • Leitor de tela: revisado
  • Touch: revisado
  • Reduced motion: revisado

Dependências

Pacotes
Nenhuma
Ícones
Nenhum
Construído sobre
Skeleton
Usado por
Nenhum ainda