Saltar al contenido

Avatar

Representa a un usuario o entidad con una imagen, o con las iniciales derivadas del nombre como fallback (si la imagen falla, el Core las escribe). Sin tono explícito deriva uno estable del nombre (tone-*). Tiene indicador de estado (status-online) y apilado con ts avatar-group, que resume el resto en un contador (data-avatar-overflow, “+5”).

Contenido · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Con imagen, con iniciales y con estado

Ana Torres BD CR
html

Grupo con contador de miembros

AT BD CR +5
html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Tamaño

El tamaño del avatar: sm, md, lg o xl.

AT AT AT AT
html

Forma

La forma: circle (por defecto) o square.

BD BD
html

Indicador de estado

El indicador de presencia en la esquina: online, offline, busy o away.

CR CR CR CR
html

Color

tone-brand, tone-info y tone-success colorean las iniciales; gray es el neutro, sin tono.

AT AT AT AT
html

Color por nombre

Sin color explícito el tono se deriva del nombre: la misma persona siempre sale del mismo color.

AT BD CR DS EV
html

Grupo

ts avatar-group superpone los avatares; con max el resto se resume en un contador +K (data-avatar-overflow).

AT BD CR DS EV
AT BD CR +2
AT BD CR +9
html

Cuándo usarlo

  • Identificar a una persona en una lista, un comentario o una barra de cuenta.
  • Mostrar de un vistazo quiénes participan de algo (ts avatar-group).
  • Se busca un fallback digno cuando no hay foto.

Cuándo no

  • Es un estado o una categoría, no una persona → badge.
  • Es una imagen de contenido que hay que ver bien → una imagen con aspect-ratio.

Cómo usarlo

  • Siempre se pone data-ts-name: es de donde salen las iniciales y el texto alternativo.
  • El avatar se acompaña con el nombre cuando la identidad importa de verdad.

Cómo no usarlo

  • El indicador de estado (status-*) no se usa como único indicador: el color solo no comunica.
  • No se apilan veinte avatares: se muestran unos pocos y el resto pasa a un contador.
  • No se fuerza el tono (tone-*) para decorar: el que se deriva del nombre ya hace reconocible a cada persona.

Relacionados

BadgeCard

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

Si la imagen no carga, el avatar cae a las iniciales, y eso lo hace el Core.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-avatar
  • data-ts-name

Qué hace: Si la imagen falla, la saca del DOM, escribe las iniciales y deja el nombre de la persona en el contenedor (role="img" y aria-label). También cubre la imagen que falló antes de que corra el Core: al iniciar revisa las <img> ya terminadas y sin ancho natural, así que no depende del orden de carga. El tono de las iniciales (tone-*) y el contador +K del grupo son marcado estático: los pinta el CSS, no hace falta JavaScript.

Sin build, desde el CDN: taisho.avatar.css, además de taisho.base.css. Con ese archivo alcanza.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Siempre se pone alt en la <img>; las iniciales del fallback salen de data-ts-name.
  • Si la imagen no carga, se reemplaza por las iniciales del nombre, aunque el error ocurra antes de que el Core se inicialice.
  • Las iniciales de color derivan del name con el par de fondo y texto -600 / -600-contrast de cada tono, que cumple AA en claro y oscuro; no hace falta decidir contraste a mano.
  • El contador +K del grupo (ts avatar-group) es role="img" con nombre accesible «y K más»; el «+K» visible queda como contenido de la imagen.
  • El indicador de presencia (status-online, status-busy…) es role="img" con el estado en el aria-label («En línea»). Si el estado es información esencial, se acompaña también de texto visible en el contexto.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.