ant-design/components/avatar/index.zh-CN.md
Wanpan 8875ca7043
feat: Avatar.Group adding max props (#49131)
* feat: Avatar.Group adding max props

* feat: update

* feat: update

* feat: update test case

* feat: update docs

* Update components/avatar/index.en-US.md

Co-authored-by: afc163 <afc163@gmail.com>
Signed-off-by: Wanpan <wanpan96@163.com>

* feat: update docs

* feat: update

* feat: update snap

* feat: delete default value

---------

Signed-off-by: Wanpan <wanpan96@163.com>
Co-authored-by: afc163 <afc163@gmail.com>
2024-06-01 14:44:53 +08:00

2.9 KiB
Raw Blame History

category title subtitle description cover coverDark demo group
Components Avatar 头像 用来代表用户或事物,支持图片、图标或字符展示。 https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*JJBSS5lBG4IAAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*YbgyQaRGz-UAAAAAAAAAAAAADrJ8AQ/original
cols
2
title order
数据展示 5

设计师专属

安装 Kitchen Sketch 插件 💎,一键填充高逼格头像和文本。

代码演示

基本 类型 自动调整字符大小 带徽标的头像 Avatar.Group 隐藏情况下计算字符对齐 响应式尺寸 图片不存在时 组件 Token

API

通用属性参考:通用属性

Avatar

参数 说明 类型 默认值 版本
alt 图像无法显示时的替代文本 string -
gap 字符类型距离左右两侧边界单位像素 number 4 4.3.0
icon 设置头像的自定义图标 ReactNode -
shape 指定头像的形状 circle | square circle
size 设置头像的大小 number | large | small | default | { xs: number, sm: number, ...} default 4.7.0
src 图片类头像的资源地址或者图片元素 string | ReactNode - ReactNode: 4.8.0
srcSet 设置图片类头像响应式资源地址 string -
draggable 图片是否允许拖动 boolean | 'true' | 'false' true
crossOrigin CORS 属性设置 'anonymous' | 'use-credentials' | '' - 4.17.0
onError 图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为 () => boolean -

Tip你可以设置 iconchildren 作为图片加载失败的默认 fallback 行为,优先级为 icon > children

Avatar.Group (4.5.0+)

参数 说明 类型 默认值 版本
max 设置最多显示相关配置,5.18.0 前可使用 参数 { count?: number; style?: CSSProperties; popover?: PopoverProps } - 5.18.0
size 设置头像的大小 number | large | small | default | { xs: number, sm: number, ...} default 4.8.0
shape 设置头像的形状 circle | square circle 5.8.0

主题变量Design Token