Ir al contenido principal

Componente de avatar

Última actualización:

Avatar CSS Tailwind solo CSS para imágenes de perfil. Tallas xs-xl, apilamiento de grupos e indicador de estado en línea/fuera de línea. Accesible a WCAG AA, funciona con Django, HTMX, Laravel, React y cualquier pila.

Los componentes de Avatar muestran imágenes de perfil de usuario o iniciales en un contenedor compacto y personalizable. Creados con las propiedades personalizadas CSS de Frutjam, los avatares representan usuarios, contribuyentes o miembros del equipo en su interfaz. El sistema de avatar admite imágenes y texto, múltiples tamaños, colores, formas, indicadores de estado, anillos y disposiciones de grupo, ideal para listas de usuarios, comentarios, presentaciones de equipos, secciones de perfil e interfaces de mensajería.

Solo CSS, no se requiere JavaScript. WCAG AA accesible e independiente del marco: funciona con Django, HTMX, Laravel, React y cualquier pila.

Clase Tipo Descripción
avatarBaseContenedor de avatar circular con iniciales o imagen.
avatar-groupModificadorPila superpuesta de múltiples avatares
avatar-ringModificadorAgrega un borde de anillo de color alrededor del avatar.
avatar-circleEstiloForma completamente circular (predeterminada)
avatar-roundedEstiloForma de rectángulo redondeado
avatar-squareEstiloForma cuadrada sin redondeos.
avatar-onlineEstiloIndicador verde de estado en línea
avatar-awayEstiloIndicador amarillo de estado ausente
avatar-busyEstiloIndicador rojo de estado ocupado
avatar-offlineEstiloIndicador gris de estado fuera de línea
avatar-xsTamañoextrapequeño
avatar-smTamañoPequeño
avatar-mdTamañoMedio (predeterminado)
avatar-lgTamañoGrande
avatar-xlTamañoExtra grande
avatar-2xlTamaño2x extra grandes
avatar-primaryColorColor del tema principal
avatar-secondaryColorColor del tema secundario
avatar-accentColorColor del tema de acento
avatar-neutralColorColor de tema neutro
avatar-infoColorColor semántico de información
avatar-successColorColor semántico del éxito
avatar-warningColorColor semántico de advertencia
avatar-errorColorColor semántico del error
avatar-ring-primaryColorAnillo en color primario
avatar-ring-secondaryColorAnillo en color secundario
avatar-ring-accentColorAnillo en color de acento
avatar-ring-neutralColorAnillo en color neutro
avatar-ring-infoColorAnillo en color info
avatar-ring-successColorAnillo en color éxito
avatar-ring-warningColorAnillo en color de advertencia.
avatar-ring-errorColorAnillo en color de error

Uso básico

Crea avatares simples con iniciales de texto o colores.

<div class="avatar">AB</div>
<div className="avatar">AB</div>

Avatar con imágenes

Muestre fotos de perfil de usuario con ajuste automático de imagen y tamaño responsivo.

html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<div class="avatar avatar-sm">
  <img src="https://cdn.frutjam.com/images/avatar-1.jpg?format=webp&width=32&height=32&face_crop=true" alt="Strawbery" loading="lazy" />
</div>

<div class="avatar avatar-md">
  <img src="https://cdn.frutjam.com/images/avatar-1.jpg?format=webp&width=40&height=40&face_crop=true" alt="Strawbery" loading="lazy" />
</div>

<div class="avatar avatar-lg">
  <img src="https://cdn.frutjam.com/images/avatar-1.jpg?format=webp&width=56&height=56&face_crop=true" alt="Strawbery" loading="lazy" />
</div>

Tamaños de avatares

Utilice variantes de tamaño para escalar avatares desde extrapequeño (xs) hasta 2x-grande (2xl) para diferentes contextos.

html
1
2
3
4
5
6
<div class="avatar avatar-xs avatar-primary">XS</div>
<div class="avatar avatar-sm avatar-secondary">SM</div>
<div class="avatar avatar-md avatar-accent">MD</div>
<div class="avatar avatar-lg avatar-primary">LG</div>
<div class="avatar avatar-xl avatar-secondary">XL</div>
<div class="avatar avatar-2xl avatar-accent">2XL</div>

Colores de avatar

Aplique variantes de color para diferenciar los avatares por función, equipo o estado cuando no utilice imágenes.

html
1
2
3
4
5
6
7
8
<div class="avatar avatar-md avatar-primary">A</div>
<div class="avatar avatar-md avatar-secondary">B</div>
<div class="avatar avatar-md avatar-accent">C</div>
<div class="avatar avatar-md avatar-info">D</div>
<div class="avatar avatar-md avatar-neutral">E</div>
<div class="avatar avatar-md avatar-success">F</div>
<div class="avatar avatar-md avatar-warning">G</div>
<div class="avatar avatar-md avatar-error">H</div>

Formas de avatar

Elija entre formas circulares (predeterminadas), redondeadas o cuadradas para combinar con su sistema de diseño.

html
1
2
3
<div class="avatar avatar-lg avatar-circle avatar-primary"></div>
<div class="avatar avatar-lg avatar-rounded avatar-secondary"></div>
<div class="avatar avatar-lg avatar-square avatar-accent"></div>

Avatar con iniciales

Muestre las iniciales del usuario para una identificación rápida en listas, hilos de comentarios y secciones de equipo.

html
1
2
3
4
<div class="avatar avatar-sm avatar-primary">JD</div>
<div class="avatar avatar-md avatar-secondary">AR</div>
<div class="avatar avatar-lg avatar-accent">MS</div>
<div class="avatar avatar-xl avatar-info">KL</div>

Avatar con indicador de estado

Combine avatares con insignias de estado para mostrar la presencia o disponibilidad del usuario (en línea, fuera de línea, ocupado, ausente).

html
1
2
3
4
5
6
7
<div class="avatar avatar-md avatar-online avatar-primary">JD</div>

<div class="avatar avatar-md avatar-offline avatar-secondary">AR</div>

<div class="avatar avatar-md avatar-busy avatar-accent">MS</div>

<div class="avatar avatar-md avatar-away avatar-info">KL</div>

Avatar con borde de anillo

Agregue anillos decorativos alrededor de los avatares para enfatizar, resaltar el estado o separar visualmente.

html
1
2
3
<div class="avatar avatar-md avatar-ring avatar-ring-primary avatar-primary">A</div>
<div class="avatar avatar-lg avatar-ring avatar-ring-secondary avatar-secondary">B</div>
<div class="avatar avatar-xl avatar-ring avatar-ring-accent avatar-accent">C</div>

Variantes de color de anillo

Elija colores de anillo independientemente de los colores de fondo del avatar.

html
1
2
3
4
5
6
7
<div class="avatar avatar-md avatar-ring avatar-ring-primary avatar-primary">A</div>
<div class="avatar avatar-md avatar-ring avatar-ring-secondary avatar-secondary">B</div>
<div class="avatar avatar-md avatar-ring avatar-ring-accent avatar-accent">C</div>
<div class="avatar avatar-md avatar-ring avatar-ring-info avatar-info">D</div>
<div class="avatar avatar-md avatar-ring avatar-ring-success avatar-success">E</div>
<div class="avatar avatar-md avatar-ring avatar-ring-warning avatar-warning">F</div>
<div class="avatar avatar-md avatar-ring avatar-ring-error avatar-error">G</div>

Grupo de avatares

Apila varios avatares con un margen negativo automático para mostrar superpuestamente a los miembros y colaboradores del equipo.

html
1
2
3
4
5
6
<div class="avatar-group">
  <div class="avatar avatar-md avatar-primary">A</div>
  <div class="avatar avatar-md avatar-secondary">B</div>
  <div class="avatar avatar-md avatar-accent">C</div>
  <div class="avatar avatar-md avatar-info">D</div>
</div>

Grupo de avatar con diferentes tamaños

Combine varios tamaños dentro de un grupo para lograr una jerarquía visual.

html
1
2
3
4
5
<div class="avatar-group">
  <div class="avatar avatar-sm avatar-primary">A</div>
  <div class="avatar avatar-md avatar-secondary">B</div>
  <div class="avatar avatar-lg avatar-accent">C</div>
</div>

Grupo de avatar con estado

Muestra el estado de disponibilidad de cada miembro de un grupo de equipo.

html
1
2
3
4
5
<div class="avatar-group">
  <div class="avatar avatar-md avatar-online avatar-primary">A</div>
  <div class="avatar avatar-md avatar-offline avatar-secondary">B</div>
  <div class="avatar avatar-md avatar-busy avatar-accent">C</div>
</div>

Combined Variants

Mezcle y combine modificadores de tamaño, color, forma, estado y anillo para pantallas de avatar complejas.

html
1
2
3
4
5
<div class="avatar avatar-xl avatar-rounded avatar-ring avatar-ring-success avatar-success avatar-online">SK</div>

<div class="avatar avatar-lg avatar-square avatar-ring avatar-ring-primary avatar-primary">AB</div>

<div class="avatar avatar-2xl avatar-circle avatar-ring avatar-ring-error avatar-error avatar-busy">MR</div>

¿Usando Claude Code, Cursor u otro editor de IA?

Cherry MCP le brinda a su editor de IA la estructura y los nombres exactos de las clases Avatar según sea necesario. No más clases alucinadas.

Pruebe Cherry MCP