界面交互
qh.showToast
解释:显示消息提示框
方法参数:Object object
object
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
title | String | 是 | - | 提示的内容 |
icon | String | 否 | success | 图标,有效值"success"、"loading"、"none" 。 |
image | String | 否 | - | 自定义图标的本地路径,image 的优先级高于 icon |
duration | Number | 否 | 2000 | 提示的延迟时间,单位毫秒。 |
mask | Boolean | 否 | false | 是否显示透明蒙层,防止触摸穿透。 |
success | Function | 否 | - | 接口调用成功的回调函数 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
icon有效值:
有效值 | 说明 |
---|---|
success | 显示成功图标,此时 title 文本最多显示 7 个汉字长度。默认值 |
loading | 显示加载图标,此时 title 文本最多显示 7 个汉字长度。 |
none | 不显示图标,此时 title 文本最多可显示两行。 |
示例:
- 在 html 文件中
<div >
<se-button @click="showToast" type="primary">点击弹出默认toast</se-button>
<se-button @click="showToastIcon" type="primary">点击弹出设置icon的toast</se-button>
<se-button @click="showToastDuration" type="primary">点击弹出设置duration的toast</se-button>
<se-button @click="showToastLoading" type="primary">点击弹出显示loading的toast</se-button>
<se-button @click="hideToast" type="primary">点击隐藏toast</se-button>
</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
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
title | String | 是 | - | 提示的内容 |
mask | Boolean | 否 | false | 是否显示透明蒙层,防止触摸穿透。 |
success | Function | 否 | - | 接口调用成功的回调函数 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例:
- 在 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
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例:
- 在 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
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例:
- 在 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
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
title | String | 是 | - | 提示的标题 |
content | String | 是 | - | 提示的内容 |
showCancel | Boolean | 否 | true | 是否显示取消按钮 。 |
cancelText | String | 否 | 取消 | 取消按钮的文字,最多 4 个字符。 |
cancelType | String | 否 | default | 取消按钮的类型,可选值:primary,default,warn,danger,text |
confirmText | String | 否 | 确定 | 确定按钮的文字,最多 4 个字符。 |
confirmType | String | 否 | primary | 确认按钮的类型,可选值:primary,default,warn,danger,text |
close | Function | 否 | - | 对话框关闭的回调函数,基础库1.8.0开始支持。 |
success | Function | 否 | - | 接口调用成功的回调函数 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
confirm | Boolean | 为 true 时,表示用户点击了确定按钮 。 |
cancel | Boolean | 为 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
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
itemList | Array.<string> | 是 | - | 按钮的文字数组,数组长度最大为6个。 |
itemColor | HexColor | 否 | #3c76ff | 按钮的文字颜色。 |
success | Function | 否 | - | 接口调用成功的回调函数,详见返回参数说明。 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
tapIndex | Number | 用户点击的按钮,从上到下的顺序,从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) + '个按钮');
}
});
}
}
});