微信小程序 MinUI 組件庫系列之 loading 加載提示組件

時間 2019-12-05

標籤微信程序 minui 組件系列 loading 加載提示简体版

原文原文鏈接

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

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

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

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

npm install -g @mindev/min-cli

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

min init my-project

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

三、安裝 loading 組件。npm

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

cd my-project

安裝組件：微信小程序

min install @minui/wxc-loading

四、開啓dev。bash

min dev

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

五、在頁面中引入組件。

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

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

wxc-loading 即爲加載提示組件的標籤名，能夠在 wxml 中使用。

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

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

<wxc-loading
    is-show="{{$loading.isShow}}"
    type="mall"
  ></wxc-loading>

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

<!-- home/index.wxp -->
<template>
  <wxc-loading
    is-show="{{$loading.isShow}}"
    type="mall"
  ></wxc-loading>
  <button bindtap="showLoading">設置 type</button>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-loading': '@minui/wxc-loading'
    }
  },
  data: {
    $loading: {
      isShow: false
    }
  },
  showLoading() {
      this.setData({
        $loading: {
          isShow: true
        }
      })
      setTimeout(() => {
        this.setData({
          $loading: {
            isShow: false
          }
        })
      }, 1000)
    }
}
</script>

<style>
</style>

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

圖示：

至此，minui 組件庫的 loading 加載提示組件在 Min 工具生成的小程序項目中的方法已介紹完畢，其餘場景，在原生小程序或其餘小程序框架項目中的使用方式請移步至以下連接：

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

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

Loading【props】

名稱	描述
`is-show`	[說明]：loading的顯示控制屬性。 [類型]：`String` [默認值]：`false`
`type`	[說明]：樣式類型。type的優先級低於 `image, slip`。 [類型]：`String` [默認值]：`"mgj"` [可選值]： `mgj`（蘑菇街女裝精選 `loading` 樣式）， `mall`（企鵝微商城 `loading` 樣式）
`image`	[說明]：loading主背景圖，必須與slip同時指定。 [類型]：`String` [默認值]：`""`
`slip`	[說明]：loading動畫背景圖，必須與image同時指定。 [類型]：`String` [默認值]：`""`

Loading【methods】

名稱	描述
`show`	[說明]：顯示loading。 [類型]：`Function` [參數]：`void` [返回]：`void`
`hide`	[說明]：隱藏loading。 [類型]：`Function` [參數]：`void` [返回]：`void`

更多demo

一、自定義數據

<template>
  <wxc-loading
    is-show="{{$loading.isShow}}"
    image="https://s10.mogucdn.com/mlcdn/c45406/170607_5241335cb37ka3ab7781ddh504ggh_200x200.png"
    slip="http://s10.mogucdn.com/p1/160715/upload_ifrgmmzwmyydknldhezdambqmeyde_200x200.png"
  ></wxc-loading>
  <button bindtap="showLoading">自定義圖片</button>
</template>

<script>
  export default {
    config: {
      usingComponents: {
        'wxc-loading': '@minui/wxc-loading'
      }
    },
    data: {
      $loading: {
        isShow: false
      }
    },
    showLoading() {
        this.setData({
          $loading: {
            isShow: true
          }
        })
        setTimeout(() => {
          this.setData({
          $loading: {
            isShow: false
          }
        })
      }, 1000)
    }
  }
</script>

<style>
</style>

圖示：

二、調用組件方法

<template>
    <wxc-loading
        class="J_loading"
        type="mall"
    ></wxc-loading>
    <button bindtap="showLoading">調用 show() 方法</button>
</template>

<script>
  export default {
    config: {
      usingComponents: {
        'wxc-loading': '@minui/wxc-loading'
      }
    },
    data: {},
    showLoading() {
        let $loading = this.selectComponent('.J_loading')
        $loading && $loading.show()

        setTimeout(() => {
          $loading && $loading.hide()
        }, 2000)
     }
  }
</script>

<style>
</style>

圖示：

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

溝通反饋

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

相關連接

開源組件

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

相關標籤/搜索

每日一句

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