更新记录

1.0.0(2024-03-27)

头像组件测试版 一个简单的头像组件,能让头像圆角显示 头像加载失败则会显示默认的灰色图标


平台兼容性

HBuilderX最低兼容版本
3.99

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后,卸载时需手动卸载,详细教程参考:如何手动卸载插件


基本使用

通过src指定头像的路径即可简单使用,如果传递了text参数,text将会优先起作用

注意: 请保证传递给src的是绝对地址,而不是相对地址,为什么呢?因为传入avatar组件的相对地址,是相对于组件的,而不是父组件(页面),所以相对址可能会出错。

<template>
    <view>
        <u-avatar :src="src"></u-avatar>
        <u-avatar :text="text"></u-avatar>
    </view>
</template>

<script>
    export default {
        data() {
            return {
                src: 'http://pic2.sc.chinaz.com/Files/pic/pic9/202002/hpic2119_s.jpg',
                text: '无头像'
            }
        }
    }
</script>

头像类型

mode参数指定头像的类型,取值circle为圆形,取值square为圆角方形

<template>
    <u-avatar :src="src" mode="square"></u-avatar>
</template>

<script>
    export default {
        data() {
            return {
                src: 'http://pic2.sc.chinaz.com/Files/pic/pic9/202002/hpic2119_s.jpg'
            }
        }
    }
</script>

默认头像

如果头像加载失败,导致加载图片失败,将会显示一个默认的灰色头像

属性

参数 说明 类型 默认值 可选值
bg-color 背景颜色,一般显示文字时用 String #ffffff -
src 头像路径,如加载失败,将会显示默认头像 String - -
size 头像尺寸,可以为指定字符串(large, default, mini),或者数值,单位rpx String Number default -
mode 显示类型,见上方说明 String circle square
text 用文字替代图片,级别优先于src String - -
img-mode 头像图片的裁剪类型,与uni的image组件的mode参数一致,如效果达不到需求,可尝试传widthFix值 String aspectFill -

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问