MinUI 是基于微信小程序自定义组件特性开发而成的一套简洁、易用、高效的组件库,适用场景广,覆盖小程序原生框架、各类小程序组件主流框架等,而且提供了高效的命令行工具。MinUI 组件库包含了不少功能组件,其中 abnor 异常流组件是一个很经常使用的功能性组件, MinUI 中 abnor 组件的效果图以下:javascript
各式各样的类型都有哦,是否是看起来很方便很快捷的样子(^_^)。能够打开微信扫一扫下面的小程序二维码先一睹为快:html
下面介绍 abnor 组件的使用方式。前端
一、使用下列命令安装 Min-Cli,如已安装,请进入到下一步。Min-Cli 的文档请猛戳这里:Min-Cli使用手册java
npm install -g @mindev/min-cli
二、初始化一个小程序项目。git
min init my-project
选择 新建小程序 选项,便可初始化一个小程序项目。建立项目后,在编辑器中打开项目,src 目录为源码目录,dist 目录为编译后用于在微信开发者工具中指定的目录。新建的项目中已有一个 home
页面。详细文档:Min 初始化小程序项目github
三、安装 abnor 组件。npm
进入刚才新建的小程序项目的目录中:小程序
cd my-project
安装组件:微信小程序
min install @minui/wxc-abnor
四、开启dev。bash
min dev
开启以后,修改源码后都会从新编译。
五、在页面中引入组件。
在编辑器中打开 src/pages
目录下的 home/index.wxp
文件,在 script
中添加 config
字段,配置小程序自定义组件字段,代码以下:
export default { config: { "usingComponents": { 'wxc-abnor': "@minui/wxc-abnor" } } }
wxc-abnor
即为异常流组件的标签名,能够在 wxml 中使用。
六、在 wxml 中使用 wxc-abnor
标签。
在 home/index.wxp
文件的 template
中添加 wxc-abnor
标签,代码以下:
<wxc-abnor type="SHOP"></wxc-abnor>
七、打开微信开发者工具,指定 dist
目录,预览项目。
home/index.wxp
文件的代码以下所示:
<!-- home/index.wxp --> <template> <wxc-abnor type="SHOP"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
至此,minui 组件库的 abnor 异常流组件在 Min 工具生成的小程序项目中的方法已介绍完毕,其余场景,在原生小程序或其余小程序框架项目中的使用方式请移步至以下连接:
了解组件的使用方式后,下面开始介绍 abnor 组件的 API 。
Abnor【props】
名称 | 描述 |
---|---|
type |
[说明]:异常状态类型,其优先级低于其余属性。 [类型]: String 默认值: "" [可选值]: REQUEST_ERROR, NOT_FOUND, DATA, FOLLOW, FEED,SHOP, WEIBO, SEARCH, TAG, MESSAGE, LIVE, ORDER, CART, FOOTPRINT, COUPON |
image |
[说明]:背景图。若与 type 同时指定,将覆盖 type 对应的 image 。[类型]: String [默认值]: "" |
title |
[说明]:标题。若与 type 同时指定,将覆盖 type 对应的 title 。[类型]: String [默认值]: "" |
tip |
[说明]:副标题。若与 type 同时指定,将覆盖 type 对应的 tip 。[类型]: String [默认值]: "" |
button |
[说明]:按钮文案。若与 type 同时指定,将覆盖 type 对应的 button 。[类型]: String [默认值]: "" |
bindabnortap |
[说明]:按钮事件。若配置了 button 属性,则须要指定事件。其中 REQUEST_ERROR, NOT_FOUND 两种 type 中均设置了默认的按钮文案 |
更多demo
一、网络异常
<template> <wxc-abnor type="REQUEST_ERROR" bind:abnortap="onAbnorTap"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {}, onAbnorTap() { wx.showToast({ title: 'success', duration: 2000 }); } } </script> <style> </style>
图示:
二、页面不存在
<template> <wxc-abnor type="NOT_FOUND" bind:abnortap="onAbnorTap"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {}, onAbnorTap() { wx.showToast({ title: 'back', duration: 2000 }); } } </script> <style> </style>
图示:
三、自定义数据
<template> <wxc-abnor type="REQUEST_ERROR" image="{{image}}" title="{{title}}" tip="{{tip}}" button="{{button}}" bind:abnortap="onAbnorTap" ></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: { image: 'https://s10.mogucdn.com/p2/161213/upload_76h1c5hjc8heecjehlfgekjdl2ki0_514x260.png', title: '自定义标题', tip: '自定义副标题', button: '点我' }, onAbnorTap() { wx.showToast({ title: 'custom', duration: 2000 }); } } </script> <style> </style>
图示:
四、空数据状态
<template> <wxc-abnor type="DATA"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
五、无关注数据
<template> <wxc-abnor type="FOLLOW"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {}, methods: {} } </script> <style> </style>
图示:
六、无反馈数据
<template> <wxc-abnor type="FOLLOW"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
七、无搜索数据
<template> <wxc-abnor type="SEARCH"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
八、无消息通知
<template> <wxc-abnor type="FOLLOW"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
九、空订单列表
<template> <wxc-abnor type="ORDER"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
十、空购物车
<template> <wxc-abnor type="CART"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
十一、空足迹
<template> <wxc-abnor type="FOOTPRINT"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
十二、无优惠券数据
<template> <wxc-abnor type="COUPON"></wxc-abnor> </template> <script> export default { config: { usingComponents: { 'wxc-abnor': '@minui/wxc-abnor' } }, data: {} } </script> <style> </style>
图示:
更多组件更新同步请关注 MinUI
小程序组件库示例查看,或请移步到实时同步更新的 微信小程序 abnor 异常流组件使用文档。
沟通反馈
请添加群助手 wUf18018252882 好友或者扫码加好友,并与群助手对话发送验证码 10088
按照指引进群。
相关连接
开源组件
布局元素
基础元件
功能组件
提示反馈
表单组件
蘑菇街前端团队,2018.01.23 于杭州