基础信息说明

功能概述：提供toast提示框、模态对话框、loading提示框的显示与隐藏能力。

项目	说明
版本要求	无
前提条件	无
使用限制	无
相关教程	无

方法说明

方法名	签名	同步/异步	说明
showToast	qg.showToast(Object object) : void	同步	显示toast提示框
showModal	qg.showModal(Object object) : void	同步	显示模态对话框
showLoading	qg.showLoading(Object object) : void	同步	显示 loading 提示框。需主动调用 hideLoading方法才能关闭提示框
hideLoading	qg.hideLoading(Object object) : void	同步	隐藏 loading 提示框

参数说明

qg.showToast(Object option)

属性名	类型	默认值（如有）	必填	说明
duration	Number	0	否	设置超过1500为长时，约5s 0为短时，约2s
message	String	-	是	提示的内容

qg.showModal(Object option)

属性名	类型	必填	默认值	说明
content	String	是	-	提示的内容
title	String	否	-	标题
showCancel	Boolean	否	TRUE	是否显示取消按钮
cancelText	String	否	'取消'	取消按钮文字，最多 4 个字符
cancelColor	String	否	'#000000'	取消按钮文字颜色
confirmText	String	否	'确定'	确认按钮文字，最多 4 个字符
confirmColor	String	否	'#3cc51f'	确认按钮文字颜色
success	Function	否	-	成功回调，入参为 Object res
fail	Function	否	-	取消回调（prompt 层触发 cancel 时调用），无参数
complete	Function	否	-	接口调用结束的回调（在 success/fail 之后），无参数

success 回调函数的参数 Object res

属性	类型	说明
confirm	Boolean	为 true 时，表示用户点击了确定按钮
cancel	Boolean	为 true 时，表示用户点击了取消按钮（用于区分不同关闭方式）

qg.showLoading(Object option)

属性名	类型	默认值（如有）	必填	说明
title	String	-	否	提示的内容
success	Function(Object res)	-	否	成功回调
fail	Function	-	否	接口调用失败的回调函数
complete	Function	-	否	执行结束回调

success参数Object res

属性	类型	说明
cancel	boolean	为true时，用户back键取消loading提示框

qg.hideLoading(Object option)

属性名	类型	默认值（如有）	必填	说明
success	Function	-	否	接口调用成功的回调函数
fail	Function	-	否	接口调用失败的回调函数
complete	Function	-	否	接口调用结束的回调函数（调用成功、失败都会执行）

回调结果说明

回调/事件	触发时机	回调参数	说明
showToast.success	showToast 调用后	无	同步触发
showToast.complete	success 之后立即触发	无	同步触发
showModal.success	点击对话框按钮时	{ confirm, cancel }	按按钮索引转换布尔值
showModal.fail	prompt cancel 事件时	无	常用于关闭/取消
showModal.complete	success 或 fail 之后	无	总会触发
showLoading.success	showLoading 调用后	无	同步触发
showLoading.complete	success 之后立即触发	无	同步触发
hideLoading.success	hideLoading 调用后	无	同步触发
hideLoading.complete	success 之后立即触发	无	同步触发

示例代码

// toast提示框
qg.showToast({
  duration:1,
  message:'showToast message'
});

// 模态对话框
qg.showModal({
  title: 'showModal title',
  content:'showModal content',
  showCancel:'showModal content',
  cancelText:'cancelText',
  confirmText:'confirmText',
  confirmColor:'#0b57d0ff',
  cancelColor:'#969696ff',
  success: function (res) {
    console.info('showModal success', res);
  },
  fail: function () {
    console.info('showModal fail');
  },
  complete: function () {
    console.info('showModal complete');
  },
});

// 显示与隐藏提示框
qg.showLoading({
  title: 'showLoading title',
});
qg.hideLoading({
  success: function () {
    console.info('hideLoading success');
  },
  fail: function () {
    console.info('hideLoading fail');
  },
  complete: function () {
    console.info('hideLoading complete');
  },
});

注意事项

在使用qg.showLoading方法加载提示框提示后，需手动调用 qg.hideLoading 关闭加载框；否则会持续显示

上一篇:字体

下一篇:键盘

文档内容是否有帮助？

有帮助

无帮助