微信小程序 MinUI 组件库系列之 loading 加载提示组件

MinUI 是基于微信小程序自定义组件特性开发而成的一套简洁、易用、高效的组件库，适用场景广，覆盖小程序原生框架、各种小程序组件主流框架等，并且提供了高效的命令行工具。MinUI 组件库包含了很多功能组件，其中 loading 加载提示组件是一个很常用的功能性组件， MinUI 中 loading 组件的效果图如下：

技术图片

是不是看起来很方便很快捷的样子(^_^)。可以打开微信扫一扫下面的小程序二维码先一睹为快：

技术图片

下面介绍 loading 组件的使用方式。

1、使用下列命令安装 Min-Cli，如已安装，请进入到下一步。Min-Cli 的文档请猛戳这里：Min-Cli使用手册

npm install -g @mindev/min-cli

2、初始化一个小程序项目。

min init my-project

选择 新建小程序 选项，即可初始化一个小程序项目。创建项目后，在编辑器中打开项目，src 目录为源码目录，dist 目录为编译后用于在微信开发者工具中指定的目录。新建的项目中已有一个 home 页面。详细文档：Min 初始化小程序项目

3、安装 loading 组件。

进入刚才新建的小程序项目的目录中：

cd my-project

安装组件：

min install @minui/wxc-loading

4、开启dev。

min dev

开启之后，修改源码后都会重新编译。

5、在页面中引入组件。

在编辑器中打开 src/pages 目录下的 home/index.wxp 文件，在 script 中添加 config 字段，配置小程序自定义组件字段，代码如下：

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

wxc-loading 即为加载提示组件的标签名，可以在 wxml 中使用。

6、在 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>

7、打开微信开发者工具，指定 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

1、自定义数据

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

图示：

技术图片

2、调用组件方法

<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 于杭州