Skip to content

H5预览

APP下载

Avatar 头像

用于展示用户头像或替代图像的组件,支持图片显示和图标占位。

基础参数

参数说明类型可选值默认值
pt样式穿透配置PassThrough--
src头像图片地址string--
size头像尺寸大小(像素)number-80
rounded是否显示为圆形头像booleantrue/falsefalse

PassThrough

样式穿透配置对象,用于深度自定义组件内部元素的样式。

参数说明类型
className组件根元素样式string
icon图标元素配置ClIconProps

示例

基本用法

html
<!-- 使用图片地址显示头像 -->
<cl-avatar src="https://example.com/avatar.jpg"></cl-avatar>

圆形头像

html
<!-- 显示圆形头像,常用于用户头像展示 -->
<cl-avatar src="https://example.com/avatar.jpg" rounded></cl-avatar>

自定义尺寸

html
<!-- 设置头像尺寸为120像素 -->
<cl-avatar src="https://example.com/avatar.jpg" :size="120"></cl-avatar>

<!-- 小尺寸头像 -->
<cl-avatar src="https://example.com/avatar.jpg" :size="40"></cl-avatar>

图标占位

html
<!-- 当没有图片时,使用图标作为占位符 -->
<cl-avatar
  :pt="{
    icon: {
        size: 60,
        name: 'user-line'
    }
}"
></cl-avatar>

组合示例

html
<!-- 大尺寸圆形头像配合自定义图标 -->
<cl-avatar
  :size="150"
  rounded
  :pt="{
    className: 'custom-avatar',
    icon: {
        size: 80,
        name: 'account-circle-line'
    }
}"
></cl-avatar>