Avatar 头像

本组件一般用于展示头像的地方,如个人中心,或者评论列表页的用户头像展示等场所。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

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

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

  1. <template>
  2. <u-avatar :src="src"></u-avatar>
  3. <u-avatar :text="text"></u-avatar>
  4. </template>
  5. <script>
  6. export default {
  7. data() {
  8. return {
  9. src: 'http://pic2.sc.chinaz.com/Files/pic/pic9/202002/hpic2119_s.jpg',
  10. text: '无头像'
  11. }
  12. }
  13. }
  14. </script>

头像类型

  • mode参数指定头像的类型,取值circle为圆形,取值square为圆角方形
  1. <template>
  2. <u-avatar :src="src" mode="square"></u-avatar>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. src: 'http://pic2.sc.chinaz.com/Files/pic/pic9/202002/hpic2119_s.jpg'
  9. }
  10. }
  11. }
  12. </script>

默认头像

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

API

Props

参数说明类型默认值可选值
bg-color背景颜色,一般显示文字时用String#ffffff-
src头像路径,如加载失败,将会显示默认头像String--
size头像尺寸,可以为指定字符串(large, default, mini),或者数值,单位rpxString | Numberdefault-
mode显示类型,见上方说明Stringcirclesquare
text用文字替代图片,级别优先于srcString--
img-mode头像图片的裁剪类型,与uni的image组件的mode参数一致,如效果达不到需求,可尝试传widthFixStringaspectFill-
index用户传递的标识符值,如果是列表循环,可穿v-forindexString--

Event

事件名说明回调参数
click头像被点击index: 用户传递的标识符