Avatar

头像组件,1.19.0+ 版本支持。

何时使用 #

用来代表用户或事物,支持图片、图标或字符展示。

代码演示 #

基本 #

简单的头像展示,支持三种尺寸,两种形状。

类型 #

支持多种展示类型:内置图标、Icon、字符、图片,并可自定义样式

徽标 #

通常用于消息提示。

API #

Avatar #

参数 说明 类型 默认值 是否必填
children 孩子节点列表 React.ReactNode -
size 头像的大小 'small' | 'medium' | 'large' | number 'medium'
shape 头像的形状 'circle' | 'square' 'circle'
icon icon 类头像的图标类型,可设为 Icon 的 typeReactElement React.ReactElement | string -
src 图片类头像的资源地址 string -
onError 图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为 () => boolean -
imgProps 图片的其他属性 Omit<
React.ImgHTMLAttributes<HTMLImageElement>,
'src' | 'srcSet' | 'onError' | 'alt'
>
-
alt 图像无法显示时的 alt 替代文本 string -
srcSet 图片类头像响应式资源地址 string -