Componente Avatar para Angular | ng-hub-ui-avatar

Componente avatar para Angular con iniciales, imágenes fallback, badges de presencia y variables CSS para interfaces reutilizables de identidad de usuario.

Referencia API

Aquí tienes el contrato completo de avatar: todo lo que puedes enlazar, escuchar, proyectar y personalizar, reunido en un solo sitio. Enlaza lo que necesites y dale el estilo que quieras — es standalone y reactivo con signals.

Inputs

Ajusta avatar a tu gusto con 20 inputs. Se enlazan como cualquier @Input de Angular.

NombreTipoPor defectoDescripción
sizestring | number50Tamaño del avatar en píxeles
namestringNombre de usuario para generar iniciales cuando fallan las fuentes de imagen
srcstring | SafeUrlURL de la fuente de imagen personalizada principal para el avatar
altstringTexto alternativo para la imagen del avatar, por accesibilidad
roundbooleantrueIndica si el avatar debe ser circular (true) o seguir cornerRadius
bgColorstringColor de fondo para los avatares de texto. Se genera automáticamente si no se proporciona
autoColorbooleantrueCuando es `true` (por defecto) un avatar de iniciales deriva su fondo de un hash del nombre. Ponlo a `false` para tematizarlo con la variable `--hub-avatar-bg-color`; un `bgColor` explícito siempre prevalece.
fgColorstring#FFFColor de texto de las iniciales en los avatares de texto
borderColorstringColor del borde alrededor del avatar
cornerRadiusstring | number0Radio de las esquinas cuando round es false
textSizeRationumber3Proporción para calcular el tamaño del texto a partir del tamaño del avatar (size / textSizeRatio)
initialsSizestring | number0Limita el número de iniciales mostradas (0 = sin restricción)
facebookIdstringID de usuario de Facebook para la foto de perfil (al mejor esfuerzo, pueden aplicarse restricciones de la API)
githubIdstringNombre de usuario de GitHub para obtener la foto de perfil
gravatarIdstringEmail o hash MD5 de Gravatar para obtener la foto de perfil
valuestringMuestra un valor personalizado como avatar (p. ej., "75%", "+5")
stylePartial<CSSStyleDeclaration>Estilos personalizados para aplicar al elemento raíz del avatar
referrerpolicystringPolítica de referrer para la imagen del avatar (p. ej., "no-referrer")
badgestring | number | boolean | nullSuperposición en la esquina: `badge` / `[badge]="true"` → punto; `badge="4k"` → etiqueta; null / ausente → nada.
badgeColorHubAvatarBadgeColor | string | nullColor semántico del badge (primary · secondary · success · danger · warning · info · light · dark) → `--hub-sys-color-*`.

Outputs

Reacciona a lo que hace avatar: 1 eventos a los que enganchar tu lógica.

NombreTipoDescripción
clickOnAvatarSourceSe emite cuando se hace clic en el avatar; devuelve el objeto de la fuente activa actual

Templates

Todavía no hay templates documentados.