Компонент Avatar для Angular | ng-hub-ui-avatar

Компонент avatar для Angular с инициалами, запасными изображениями, бейджами присутствия и CSS-переменными для переиспользуемых интерфейсов идентификации пользователя.

Справочник API

Вот полный контракт avatar: всё, что можно привязать, прослушать, спроецировать и тематизировать, собрано в одном месте. Подключите то, что нужно, и оформите так, как хотите — это standalone и дружит с сигналами.

Входные свойства

Настройте avatar с помощью 21 входных свойств. Привязывайте их, как любой @Input в Angular.

ИмяТипПо умолчаниюОписание
sizestring | number50Размер аватара в пикселях
namestringИмя пользователя для генерации инициалов, когда источники изображений недоступны
srcstring | SafeUrlURL основного пользовательского источника изображения для аватара
altstringАльтернативный текст изображения аватара для доступности
roundbooleantrueДолжен ли аватар быть круглым (true) или следовать cornerRadius
interactivebooleanfalseПомечает аватар как интерактивный элемент управления: выставляет role=“button”, делает его фокусируемым и вызывает clickOnAvatar по Enter/Space. Включайте всегда, когда привязываете (clickOnAvatar).
bgColorstringЦвет фона для текстовых аватаров. Генерируется автоматически, если не указан
autoColorbooleantrueПри `true` (по умолчанию) аватар с инициалами получает фон из хеша имени. Установите `false`, чтобы задать его через переменную `--hub-avatar-bg-color`; явный `bgColor` всегда имеет приоритет.
fgColorstring#FFFЦвет текста инициалов в текстовых avatar
borderColorstringЦвет рамки вокруг аватара
cornerRadiusstring | number0Радиус скругления углов, когда round равно false
textSizeRationumber3Коэффициент для расчёта размера текста на основе размера аватара (size / textSizeRatio)
initialsSizestring | number0Ограничивает количество отображаемых инициалов (0 = без ограничения)
facebookIdstringID пользователя Facebook для изображения профиля (по возможности, могут действовать ограничения API)
githubIdstringИмя пользователя GitHub для получения изображения профиля
gravatarIdstringEmail или MD5-хеш Gravatar для получения изображения профиля
valuestringОтображение пользовательского значения в качестве аватара (например, "75%", "+5")
stylePartial<CSSStyleDeclaration>Пользовательские стили, применяемые к корневому элементу аватара
referrerpolicystringПолитика referrer для изображения аватара (например, "no-referrer")
badgestring | number | boolean | nullУгловой оверлей: `badge` / `[badge]="true"` → точка; `badge="4k"` → метка; null / отсутствует → ничего.
badgeColorHubAvatarBadgeColor | string | nullСемантический цвет бейджа (primary · secondary · success · danger · warning · info · light · dark) → `--hub-sys-color-*`.

События

Реагируйте на то, что делает avatar, — 1 событий, к которым можно подключить вашу логику.

ИмяТипОписание
clickOnAvatarSourceВызывается при клике по аватару, возвращает объект текущего активного источника

Шаблоны

Шаблоны пока не задокументированы.