界面交互

qh.showToast

解释:显示消息提示框

方法参数:Object object

object参数说明

参数名类型必填默认值说明
titleString-提示的内容
iconStringsuccess图标,有效值"success"、"loading"、"none"
imageString-自定义图标的本地路径,image 的优先级高于 icon
durationNumber2000提示的延迟时间,单位毫秒。
maskBooleanfalse是否显示透明蒙层,防止触摸穿透。
successFunction-接口调用成功的回调函数
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

icon有效值

有效值说明
success显示成功图标,此时 title 文本最多显示 7 个汉字长度。默认值
loading显示加载图标,此时 title 文本最多显示 7 个汉字长度。
none不显示图标,此时 title 文本最多可显示两行。

示例

  • 在 html 文件中
  1. <div >
  2. <se-button @click="showToast" type="primary">点击弹出默认toast</se-button>
  3. <se-button @click="showToastIcon" type="primary">点击弹出设置icon的toast</se-button>
  4. <se-button @click="showToastDuration" type="primary">点击弹出设置duration的toast</se-button>
  5. <se-button @click="showToastLoading" type="primary">点击弹出显示loading的toast</se-button>
  6. <se-button @click="hideToast" type="primary">点击隐藏toast</se-button>
  7. </div>
  • 在 js 文件中
Page({
    methods: {
        showToast() {
            qh.showToast({
                title: '默认'
            });
        },

        showToastIcon() {
            qh.showToast({
                title: 'success',
                icon: 'success'
            });
        },

        showToastDuration() {
            qh.showToast({
                duration: 5000,
                title: 'duration 5000'
            });
        },

        showToastLoading() {
            qh.showToast({
                title: '正在加载...',
                icon: 'loading'
            });
        },

        hideLoading() {
            qh.hideLoading();
        },

        hideToast() {
            qh.hideToast();
        }
    }
});

qh.showLoading

解释:显示 loading 提示框, 需主动调用 hideLoading 才能关闭提示框。

方法参数:Object object

object参数说明

参数名类型必填默认值说明
titleString-提示的内容
maskBooleanfalse是否显示透明蒙层,防止触摸穿透。
successFunction-接口调用成功的回调函数
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

示例

  • 在 html 文件中
<div>
    <se-button type="primary" @click="showLoading">showLoading</se-button>
</div>
  • 在 js 文件中
Page({
    methods: {
        showLoading() {
            qh.showLoading({
                title: 'loading',
                mask: true,
                success: function () {
                    console.log('showLoading success');
                },
                fail: function (err) {
                    console.log('showLoading fail', err);
                }
            });
        }
    }
});

qh.hideToast

解释: 隐藏消息提示框

方法参数:Object object

参数名类型必填默认值说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例

  • 在 html 文件中
<div>
    <se-button type="primary" @click="showToast">showToast</se-button>
    <se-button type="primary" @click="hideToast">hideToast</se-button>
</dov>
  • 在 js 文件中
Page({
    methods: {
        showToast() {
            qh.showToast({
                title: 'toast',
                duration: 10000
            });
        },
        hideToast() {
            qh.hideToast();
        }
    }
});

qh.hideLoading

解释:隐藏 loading 提示框

方法参数:Object object

参数名类型必填默认值说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例

  • 在 html 文件中
<div>
    <se-button type="primary" @click="showLoading">showLoading</se-button>
    <se-button type="primary" @click="hideLoading">hideLoading</se-button>
</div>
  • 在 js 文件中
Page({
    methods: {
        showLoading() {
            qh.showLoading({
                title: 'loading'
            });
        },
        hideLoading() {
            qh.hideLoading();
        }
    }

});

qh.showModal

解释:显示模态弹窗

方法参数:Object object

object参数说明

参数名类型必填默认值说明
titleString-提示的标题
contentString-提示的内容
showCancelBooleantrue是否显示取消按钮 。
cancelTextString取消取消按钮的文字,最多 4 个字符。
cancelTypeStringdefault取消按钮的类型,可选值:primary,default,warn,danger,text
confirmTextString确定确定按钮的文字,最多 4 个字符。
confirmTypeStringprimary确认按钮的类型,可选值:primary,default,warn,danger,text
closeFunction-对话框关闭的回调函数,基础库1.8.0开始支持。
successFunction-接口调用成功的回调函数
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明

参数名类型说明
confirmBoolean为 true 时,表示用户点击了确定按钮 。
cancelBoolean为 true 时,表示用户点击了取消。

示例

  • 在 html 文件中
<div>
    <se-button @click="showModal" type="primary">showModal</se-button>
</div>
  • 在 js 文件中
Page({
    methods: {
        showModal() {
            qh.showModal({
                title: '标题',
                content: '内容',
                confirmText: '确定',
                cancelType: 'primary'
            });
        }
    }
});

qh.showActionSheet

解释:​显示操作菜单

方法参数:Object object

object参数说明

参数名类型必填默认值说明
itemListArray.<string>-按钮的文字数组,数组长度最大为6个。
itemColorHexColor#3c76ff按钮的文字颜色。
successFunction-接口调用成功的回调函数,详见返回参数说明。
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明

参数名类型说明
tapIndexNumber用户点击的按钮,从上到下的顺序,从0开始。

示例

  • 在 html 文件中
<div>
    <se-button @click="showActionSheet" type="default">showActionSheet</se-button>
</div>
  • 在 js 文件中
Page({
    methods: {
        showActionSheet() {
            qh.showActionSheet({
                itemList: ['选项一', '选项二', '选项三', '选项四'],
                itemColor: '#333',
                success: res => {
                    console.log('用户点击了第' + (res.tapIndex + 1) + '个按钮');
                }
            });
        }
    }
});