Skip to main content

Skeleton

Apresentação​

O componente Skeleton é responsável por exibir um placeholder animado que simula o carregamento de conteúdo. Ele é ideal para melhorar a experiência do usuário durante o carregamento de dados, evitando mudanças bruscas no layout e fornecendo feedback visual do conteúdo que está sendo carregado.

Quando usar​

  • Durante o carregamento de conteúdo
  • Para preencher espaços vazios temporariamente
  • Em listas e grids que carregam dados
  • Para simular o layout final do conteúdo
  • Em cards e containers que carregam dados
  • Para manter a consistência visual durante carregamentos
  • Em perfis e avatares que carregam imagens
  • Para indicar que o conteúdo está sendo carregado

Forma básica de uso​

import { Skeleton, SkeletonLine, SkeletonCircle } from 'eitri-luminus';

// Skeleton básico
<Skeleton />

// Skeleton com tamanho personalizado
<Skeleton className="w-48 h-48" />

// Skeleton com conteúdo
<Skeleton>
<div className="p-4">
<h3>Conteúdo carregando...</h3>
</div>
</Skeleton>

// SkeletonLine básico
<SkeletonLine />

// SkeletonLine com largura personalizada
<SkeletonLine className="w-64" />

// SkeletonLine com altura personalizada
<SkeletonLine className="h-6" />

// SkeletonCircle básico
<SkeletonCircle />

// SkeletonCircle com tamanho personalizado
<SkeletonCircle className="h-24 w-24" />

// Exemplo de uso combinado
<div className="flex items-center space-x-4">
<SkeletonCircle />
<div className="space-y-2">
<SkeletonLine className="w-32" />
<SkeletonLine className="w-24" />
</div>
</div>

Propriedades​

Skeleton​

PropriedadeTipoDescrição
classNamestringClasses CSS adicionais
idstringIdentificador único do componente

SkeletonLine​

PropriedadeTipoDescrição
classNamestringClasses CSS adicionais
idstringIdentificador único do componente

SkeletonCircle​

PropriedadeTipoDescrição
classNamestringClasses CSS adicionais
idstringIdentificador único do componente

Heranças​

Os componentes Skeleton, SkeletonLine e SkeletonCircle herdam todas as propriedades comuns da biblioteca através da interface CommonProps, que inclui:

  • Propriedades de estilo (margin, padding, etc)
  • Propriedades de layout (flex, grid, etc)
  • Propriedades de posicionamento
  • Propriedades de acessibilidade
  • Propriedades de identificação (id, data-e)

Observações​

  • Todos os componentes usam a classe 'skeleton' para a animação base
  • O SkeletonLine é ideal para simular linhas de texto
  • O SkeletonCircle é perfeito para simular avatares ou ícones circulares
  • É possível personalizar a aparência usando classes do Tailwind
  • Os componentes são responsivos por padrão
  • Suportam diferentes tamanhos e formas
  • Podem ser combinados para criar layouts complexos
  • São ideais para melhorar a experiência de carregamento
  • Mantêm a consistência visual durante o carregamento
  • Podem ser usados em qualquer contexto que necessite de feedback visual de carregamento
  • São especialmente úteis em aplicações que carregam dados dinamicamente