Display

Empty空数据

用于展示空数据时的情况,支持自定义图标,支持引导按钮,单按钮、双按钮。

用于展示空数据时的情况,支持自定义图标,支持引导按钮,单按钮、双按钮。

示例图

基础用法

页面 .json 文件 usingComponents 中引入组件

// json
{
    "usingComponents": {
        "mx-empty": "/components/mxwui/empty/index"
    }
}

页面 .wxml 文件中使用组件

<mx-empty />

更多用法示例

缺省文案 text

属性:text,默认 暂无数据。

<mx-empty text="暂无内容" />

缺省文案文本色 textColor

属性:textColor,默认 #9AA0B1,支持任何合法的颜色值。

<mx-empty textColor="#1677FF" />

文案描述 desc

属性:desc,自定义描述内容。

<mx-empty desc="这是文案描述" />

描述文案文本色 descColor

属性:descColor,默认 #9AA0B1,支持任何合法的颜色值。

<mx-empty descColor="#1677FF" />

缺省图标/图片

属性:iconName,默认图标 empty,只支持图标库中的图标。

属性:iconColor,默认 #9AA0B1,支持任何合法的颜色值。

属性:iconUrl,自定义图片地址,传入则 iconName 和 iconColor 无效。

属性:iconSize,默认 120,不带单位,使用rpx。

  • 自定义图标
<mx-empty iconName="order" iconColor="#1677FF" iconSize="120" />
  • 自定义图片
<mx-empty iconUrl="https://cdn.mingsixue.com/xcx/MXWUI/remind2.png" iconSize="240" />

单按钮

单按钮只需要设置主按钮属性即可。

属性:mainBtnText,主按钮文案

属性:mainBtnType,主按钮按钮类型,支持 primary、default、ghost,默认 primary。

属性:mainBtnColor,主按钮颜色,默认 #CA0E2D,只支持十六进制颜色值。

事件:bind:empty_main_tap,主按钮点击回调事件

<mx-empty mainBtnText="主按钮" bind:empty_main_tap="handleMainBtn" />
  • 主按钮按钮类型
<mx-empty mainBtnType="primary" />

<mx-empty mainBtnType="default" />

<mx-empty mainBtnType="ghost" />
  • 主按钮自定义颜色
<mx-empty mainBtnThemeColor="#1677FF" />

双按钮

双按钮需要同时设置主按钮属性和次按钮属性。

属性:minorBtnText,次按钮文案

属性:minorBtnType,次按钮按钮类型,支持 primary、default、ghost,默认 default。

属性:minorBtnColor,次按钮颜色,默认 #CA0E2D,只支持十六进制颜色值。

事件:bind:empty_minor_tap,主按钮点击回调事件

<mx-empty mainBtnText="主按钮" bind:empty_main_tap="handleMainBtn" minorBtnText="次按钮" bind:empty_minor_tap="handleMinorBtn"  />
  • 次按钮按钮类型
<mx-empty mainBtnType="default" />

<mx-empty mainBtnType="primary" />

<mx-empty mainBtnType="ghost"  />
  • 次按钮自定义颜色
<mx-empty minorBtnThemeColor="#1677FF"  />

设置距离顶部距离

属性:top,默认 0,数字。

<mx-empty top="300" />

参数

参数 类型 必填 可选值 默认值 参数描述
text String 暂无数据 缺省文案
textColor String 颜色值 #9AA0B1 缺省文案文本色,支持任何合法的颜色值
desc String 描述文案
descColor String 颜色值 #9AA0B1 描述文案文本色,支持任何合法的颜色值
iconName String 是 empty 图标名称,只支持图标库中图标
iconColor String 颜色值 #9AA0B1 图标颜色,支持任何合法的颜色值
iconSize Number 120 图标大小,不带单位,默认使用rpx
iconUrl String 是 图标自定义图片,传了则iconName、iconColor、iconSize 无效
top Number 0 距离顶部距离,单位rpx
mainBtnText String 主按钮文案
mainBtnType String primary、default、ghost primary 主按钮按钮类型
mainBtnColor String 颜色值 #CA0E2D 主按钮自定义颜色,只支持十六进制颜色值
minorBtnText String 次按钮文案
minorBtnType String primary、default、ghost default 次按钮按钮类型
minorBtnColor String 颜色值 #CA0E2D 次按钮自定义颜色,只支持十六进制颜色值

事件

事件名称 类型 返回值 事件说明
bind:empty_main_tap Click 主按钮点击事件回调
bind:empty_minor_tap Click 次按钮点击事件回调

其他说明

  • 次按钮必须和主按钮配合使用,不能单独使用次按钮