微信小程式 MinUI 元件庫系列之 avatar 頭像元件

min_team發表於2018-01-17

MinUI 是基於微信小程式自定義元件特性開發而成的一套簡潔、易用、高效的元件庫,適用場景廣,覆蓋小程式原生框架、各種小程式元件主流框架等,並且提供了高效的命令列工具。MinUI 元件庫包含了很多基礎的元件,其中 avatar 頭像元件是一個很常用的基礎元件, MinUI 中 avatar 元件的效果圖如下:

avatar

各式各樣的頭像都有,是不是看起來很方便很快捷的樣子(^_^)。可以開啟微信掃一掃下面的小程式二維碼先一睹為快:

avatar

下面介紹 avatar 元件的使用方式。

1、使用下列命令安裝 Min-Cli,如已安裝,請進入到下一步。Min-Cli 的文件請猛戳這裡:Min-Cli使用手冊

npm install -g @mindev/min-cli
複製程式碼

2、初始化一個小程式專案。

min init my-project
複製程式碼

選擇 新建小程式 選項,即可初始化一個小程式專案。建立專案後,在編輯器中開啟專案,src 目錄為原始碼目錄,dist 目錄為編譯後用於在微信開發者工具中指定的目錄。新建的專案中已有一個 home 頁面。詳細文件:Min 初始化小程式專案

3、安裝 avatar 元件。

進入剛才新建的小程式專案的目錄中:

cd my-project
複製程式碼

安裝元件:

min install @minui/wxc-avatar
複製程式碼

4、開啟dev。

min dev
複製程式碼

開啟之後,修改原始碼後都會重新編譯。

5、在頁面中引入元件。

在編輯器中開啟 src/pages 目錄下的 home/index.wxp 檔案,在 script 中新增 config 欄位,配置小程式自定義元件欄位,程式碼如下:

export default {
    config: {
        "usingComponents": {
            'wxc-avatar': "@minui/wxc-avatar"
        }
    }
}
複製程式碼

wxc-avatar 即為頭像元件的標籤名,可以在 wxml 中使用。

6、在 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>
複製程式碼

7、開啟微信開發者工具,指定 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>
複製程式碼

圖示:

default

至此,minui 元件庫的 avatar 頭像元件在 Min 工具生成的小程式專案中的方法已介紹完畢,其他場景,如已有小程式專案中的使用方式請移步至如下連結:

在已有小程式專案中使用 MinUI 元件

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

Avatar 【Props】

名稱 描述
src 頭像圖片地址
mold 頭像規格,circle(正圓)、square(正方),預設 circle
count 訊息數,顯示在頭像右上角

更多demo

1、設定不同規格的頭像

<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>

複製程式碼

圖示:

設定不同規格的頭像

2、方形頭像

<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>
複製程式碼

圖示:

方形頭像

3、訊息提示

<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>
複製程式碼

圖示:

訊息提示

4、自定義文字

<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>
複製程式碼

text

更多元件更新同步請關注 MinUI 小程式元件庫示例檢視,或請移步到實時同步更新的 微信小程式 avatar 頭像元件使用文件

溝通反饋

請新增群助手 wUf18018252882 好友或者掃碼加好友,並與群助手對話傳送驗證碼 10088 按照指引進群。

群二維碼

相關連結

開源元件


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

相關文章