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
BD
CR
Grupo con contador de miembros
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.
Forma
La forma: circle (por defecto) o square.
Indicador de estado
El indicador de presencia en la esquina: online, offline, busy o away.
Color
tone-brand, tone-info y tone-success colorean las iniciales; gray es el neutro, sin tono.
Color por nombre
Sin color explícito el tono se deriva del nombre: la misma persona siempre sale del mismo color.
Grupo
ts avatar-group superpone los avatares; con max el resto se resume en un contador +K (data-avatar-overflow).
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.
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-avatardata-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
alten la<img>; las iniciales del fallback salen dedata-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
namecon el par de fondo y texto-600/-600-contrastde cada tono, que cumple AA en claro y oscuro; no hace falta decidir contraste a mano. - El contador
+Kdel grupo (ts avatar-group) esrole="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…) esrole="img"con el estado en elaria-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.