search
开发文档
开发文档/小游戏开发/API/界面/提示框
提示框更新时间:2026-08-07 18:57:08

小米已接入快游戏联盟(OVMR)标准,通过新标准进行导出。近期小米小游戏已经停止Cocos导出,为避免影响您的游戏正常打包,请尽快迁移至快游戏联盟标准。

存量开发者:请直接按快联盟标准打包,避免新版本无法导出

基础信息说明

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

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

方法说明

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

参数说明

qg.showToast(Object option)

属性名类型默认值(如有)必填说明
durationNumber0否设置超过1500为长时,约5s
0为短时,约2s
messageString-是提示的内容

qg.showModal(Object option)

属性名类型必填默认值说明
contentString是-提示的内容
titleString否-标题
showCancelBoolean否TRUE是否显示取消按钮
cancelTextString否'取消'取消按钮文字,最多 4 个字符
cancelColorString否'#000000'取消按钮文字颜色
confirmTextString否'确定'确认按钮文字,最多 4 个字符
confirmColorString否'#3cc51f'确认按钮文字颜色
successFunction否-成功回调,入参为 Object res
failFunction否-取消回调(prompt 层触发 cancel 时调用),无参数
completeFunction否-接口调用结束的回调(在 success/fail 之后),无参数

success 回调函数的参数 Object res

属性类型说明
confirmBoolean为 true 时,表示用户点击了确定按钮
cancelBoolean为 true 时,表示用户点击了取消按钮(用于区分不同关闭方式)

qg.showLoading(Object option)

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

success参数Object res

属性类型说明
cancelboolean为true时,用户back键取消loading提示框

qg.hideLoading(Object option)

属性名类型默认值(如有)必填说明
successFunction-否接口调用成功的回调函数
failFunction-否接口调用失败的回调函数
completeFunction-否接口调用结束的回调函数(调用成功、失败都会执行)

回调结果说明

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

示例代码

// 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 关闭加载框;否则会持续显示
上一篇:字体
下一篇:键盘
文档内容是否有帮助?
有帮助
无帮助