微信小程序 MinUI 組件庫系列之 avatar 頭像組件

時間 2019-11-08

標籤微信程序 minui 組件系列 avatar 頭像简体版

原文原文鏈接

MinUI 是基於微信小程序自定義組件特性開發而成的一套簡潔、易用、高效的組件庫，適用場景廣，覆蓋小程序原生框架、各類小程序組件主流框架等，而且提供了高效的命令行工具。MinUI 組件庫包含了不少基礎的組件，其中 avatar 頭像組件是一個很經常使用的基礎元件， MinUI 中 avatar 組件的效果圖以下：javascript

各式各樣的頭像都有，是否是看起來很方便很快捷的樣子(^_^)。能夠打開微信掃一掃下面的小程序二維碼先一睹爲快：html

下面介紹 avatar 組件的使用方式。前端

一、使用下列命令安裝 Min-Cli，如已安裝，請進入到下一步。Min-Cli 的文檔請猛戳這裏：Min-Cli使用手冊java

npm install -g @mindev/min-cli

二、初始化一個小程序項目。git

min init my-project

選擇 新建小程序 選項，便可初始化一個小程序項目。建立項目後，在編輯器中打開項目，src 目錄爲源碼目錄，dist 目錄爲編譯後用於在微信開發者工具中指定的目錄。新建的項目中已有一個 home 頁面。詳細文檔：Min 初始化小程序項目github

三、安裝 avatar 組件。npm

進入剛纔新建的小程序項目的目錄中：小程序

cd my-project

安裝組件：微信小程序

min install @minui/wxc-avatar

四、開啓dev。bash

min dev

開啓以後，修改源碼後都會從新編譯。

五、在頁面中引入組件。

在編輯器中打開 src/pages 目錄下的 home/index.wxp 文件，在 script 中添加 config 字段，配置小程序自定義組件字段，代碼以下：

export default {
    config: {
        "usingComponents": {
            'wxc-avatar': "@minui/wxc-avatar"
        }
    }
}

wxc-avatar 即爲頭像組件的標籤名，能夠在 wxml 中使用。

六、在 wxml 中使用 wxc-avatar標籤。

在 home/index.wxp 文件的 template 中添加 wxc-avatar 標籤，代碼以下：

<wxc-avatar class="avatar" src="https://s11.mogucdn.com/p2/170413/upload_86dkh4e886991g9lji7a6g5c530ji_400x400.jpg"></wxc-avatar>

七、打開微信開發者工具，指定 dist 目錄，預覽項目。

home/index.wxp 文件的代碼以下所示：

<!-- home/index.wxp -->
<template>
  <wxc-avatar class="avatar" src="https://s11.mogucdn.com/p2/170413/upload_86dkh4e886991g9lji7a6g5c530ji_400x400.jpg"></wxc-avatar>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-avatar': '@minui/wxc-avatar'
    }
  }
}
</script>

<style>
  .avatar {
    display: block;
    width: 120rpx;
    height: 120rpx;
  }
</style>

圖示：

至此，minui 組件庫的 avatar 頭像組件在 Min 工具生成的小程序項目中的方法已介紹完畢，其餘場景，如已有小程序項目中的使用方式請移步至以下連接：

在已有小程序項目中使用 MinUI 組件

瞭解組件的使用方式後，下面開始介紹 avatar 組件的 API 。

Avatar 【Props】

名稱	描述
`src`	頭像圖片地址
`mold`	頭像規格，circle(正圓)、square(正方)，默認 circle
`count`	消息數，顯示在頭像右上角

更多demo

一、設置不一樣規格的頭像

<template>
  <wxc-avatar class="avatar avatar__1" src="https://s11.mogucdn.com/p2/170413/upload_86dkh4e886991g9lji7a6g5c530ji_400x400.jpg"></wxc-avatar>
  <wxc-avatar class="avatar avatar__2" src="https://s10.mogucdn.com/mlcdn/c45406/171116_3a30h33df8cj7f651al68hdh7bki7_528x528.png"></wxc-avatar>
  <wxc-avatar class="avatar avatar__3" src="https://s10.mogucdn.com/mlcdn/c45406/171116_62f571l0ki0ffcg94h6kg6452h497_356x356.png"></wxc-avatar>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-avatar': '@minui/wxc-avatar'
    }
  }
}
</script>

<style>
  .avatar {
    display: inline-block;
    margin-right: 20rpx;
  }
  .avatar__1 {
    width: 120rpx;
    height: 120rpx;
  }
  .avatar__2 {
    width: 160rpx;
    height: 160rpx;
  }
  .avatar__3 {
    width: 200rpx;
    height: 200rpx;
  }
</style>

圖示：

二、方形頭像

<template>
  <wxc-avatar class="avatar" mold="square" src="https://s11.mogucdn.com/p2/170413/upload_86dkh4e886991g9lji7a6g5c530ji_400x400.jpg"></wxc-avatar>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-avatar': '@minui/wxc-avatar'
    }
  }
}
</script>

<style>
  .avatar {
    display: block;
    width: 120rpx;
    height: 120rpx;
  }
</style>

圖示：

三、消息提示

<template>
  <wxc-avatar class="avatar" count="7" src="https://s11.mogucdn.com/p2/170413/upload_86dkh4e886991g9lji7a6g5c530ji_400x400.jpg"></wxc-avatar>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-avatar': '@minui/wxc-avatar'
    }
  },
  data: {}
}
</script>

<style>
  .avatar {
    display: block;
    width: 120rpx;
    height: 120rpx;
  }
</style>

圖示：

四、自定義文字

<template>
  <wxc-avatar class="avatar">U</wxc-avatar>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-avatar': '@minui/wxc-avatar'
    }
  },
  data: {}
}
</script>

<style>
  .avatar {
    display: block;
    width: 120rpx;
    height: 120rpx;
    border-radius: 50%;
    background: #31b0d5;
    color: #FFF;
  }
</style>

更多組件更新同步請關注 MinUI 小程序組件庫示例查看，或請移步到實時同步更新的微信小程序 avatar 頭像組件使用文檔。

溝通反饋

請添加羣助手 wUf18018252882 好友或者掃碼加好友，並與羣助手對話發送驗證碼 10088 按照指引進羣。

相關連接

開源組件

蘑菇街前端團隊，2018.01.17 於杭州

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。