Angular 头像组件 | ng-hub-ui-avatar

Angular 头像组件,支持首字母、备用图片、在线状态徽标和 CSS 变量,用于可复用的用户身份界面。

概览

团队为何搜索这个库

当你需要稳健的用户身份界面,并支持备用方案、首字母、多个图片来源以及对设计系统友好的样式钩子时,请选择这个 Angular 头像组件。

安装

npm install ng-hub-ui-avatar

跳转到

适用于

  • 用户菜单
  • 团队列表
  • 动态信息流
  • 个人资料卡片

关于 avatar

ng-hub-ui-avatar 帮助 Angular 应用在菜单、个人资料卡片和协作界面中一致地展示用户。它覆盖了常见的边界情况,例如图片缺失、首字母生成、状态指示器和共享的尺寸规则。

功能指南

头像来源

可从社交资料、自定义图片、名称首字母或自定义值解析头像,并提供自动回退。

示例:
Facebook 资料

Facebook 资料

https://graph.facebook.com/nasa/picture?width=60&height=60
Gravatar

Gravatar

https://secure.gravatar.com/avatar/adde9b2b981a8083cf084c63ad86f753?s=60&d=404
GitHub 资料

GitHub 资料

自定义图片来源

自定义图片来源

https://i.pravatar.cc/150?u=custom
姓名首字母

姓名首字母

JD
值显示

值显示

75%

回退系统

会优雅地逐一降级遍历每个已配置的来源,直到显示出一个有意义的表示。

示例:
回退系统

回退系统

https://graph.facebook.com/invalid_id/picture?width=60&height=60

Showing GitHub source (Facebook ID invalid)

尺寸

可控制头像尺寸、文字与尺寸的比例以及渲染多少个首字母。

示例:
自定义尺寸

自定义尺寸

SD
文字大小比例

文字大小比例

RD
首字母数量限制

首字母数量限制

JD

样式

形状、圆角半径、颜色、边框和任意内联样式——全部由输入和 CSS 变量驱动。

示例:
圆形头像

圆形头像

R
圆角半径

圆角半径

R
背景色和前景色

背景色和前景色

C
Custom BG & FG
边框颜色

边框颜色

B
自定义样式

自定义样式

S

交互性

通过头像点击事件对用户交互做出响应。

示例:
点击事件处理器

点击事件处理器

CM
Click the avatar...

分组与徽标

将头像堆叠为分组,并在角落叠加徽标——状态圆点或计数——使用语义色板着色。

示例:
头像组显示

头像组显示

A
B
C
+3
徽标(圆点与计数)

徽标(圆点与计数)

AL
GH
AT
LT
CM
4k
JD
9+

自定义内容

可将任意图标、内联 SVG、图片或表情符号投影到头像内。它会居中、留白并按头像形状裁剪,以不依赖类型的方式调整大小(字体图标缩放,SVG/图片填充),并通过常规的 bgColor / fgColor 输入进行主题化。

示例:
自定义内容(图标、SVG)

自定义内容(图标、SVG)

🚀

核心特性

最近更改

Version 19.0.3 - 9/15/24, 12:00 AM

added: Comprehensive documentation page with functional examples