Skip to content
iuiDesign
100%
17:44
本页目录

头像展示组件,支持圆形和方形两种形状,支持图片文字头像,支持五种尺寸。

基本使用

头像的基础使用

html
<!-- 默认头像 -->
<iui-avatar></iui-avatar>
<!-- 文字头像 -->
<iui-avatar size="large" bgColor="#4080FF">T</iui-avatar>
<!-- 图片头像 -->
<iui-avatar size="large" :src="url"></iui-avatar>
<!-- 默认头像 -->
<iui-avatar></iui-avatar>
<!-- 文字头像 -->
<iui-avatar size="large" bgColor="#4080FF">T</iui-avatar>
<!-- 图片头像 -->
<iui-avatar size="large" :src="url"></iui-avatar>

形状大小

通过设置 size 字段,可以调节头像的大小,默认大小为 36px。设置 shape 字段,可以设置头像是圆形 (circle) 还是正方形 (square)。

html
<!-- 形状 -->
<iui-avatar shape="circle"></iui-avatar>
<iui-avatar shape="square"></iui-avatar>

<!-- 大小 -->
<iui-avatar size="huge"></iui-avatar>
<iui-avatar size="large"></iui-avatar>
<iui-avatar size="medium"></iui-avatar>
<iui-avatar size="small"></iui-avatar>
<iui-avatar size="mini"></iui-avatar>
<!-- 形状 -->
<iui-avatar shape="circle"></iui-avatar>
<iui-avatar shape="square"></iui-avatar>

<!-- 大小 -->
<iui-avatar size="huge"></iui-avatar>
<iui-avatar size="large"></iui-avatar>
<iui-avatar size="medium"></iui-avatar>
<iui-avatar size="small"></iui-avatar>
<iui-avatar size="mini"></iui-avatar>

用户信息

头像常会搭配用户信息使用,通过 avatarNameavatarDesc 可以设置头像的文字和描述。

html
<iui-avatar
  size="small"
  avatarName="Username"
  avatarDesc="Description"
></iui-avatar>
<iui-avatar
  size="small"
  avatarName="Username"
  avatarDesc="Description"
></iui-avatar>

对齐

有时用户的描述信息可能会很长,可以通过 align 属性来设置头像的对齐方式。

html
<iui-avatar
  align="start"
  avatarName="Align start"
  avatarDesc="This is a long description, which is automatically adapted to the number of lines,set algin to start, it will be look better"
></iui-avatar>
<iui-avatar
  align="start"
  avatarName="Align start"
  avatarDesc="This is a long description, which is automatically adapted to the number of lines,set algin to start, it will be look better"
></iui-avatar>

API

<Avatar>props
参数描述类型默认值
size头像大小String | Number36
shape头像形状circle | squarecircle
src图片链接String-
bgColor背景颜色String-
defaultImage默认头像String-
avatarName头像名称String-
avatarDesc头像描述String-
autoSize名称描述字体大小自适应Booleanfalse
align头像与名称描述对齐方式Stringcenter
<Avatar>slots
插槽名描述参数
default文字头像内容-
avatarName头像名称-
avatarDesc头像描述-
extra额外内容-