弹窗

接口声明

  1. { "name": "system.prompt" }

导入模块

  1. import prompt from '@system.prompt' 或 const prompt = require('@system.prompt')

接口定义

prompt.showToast(OBJECT)

显示 Toast

参数：

参数名类型必填说明
messageString是要显示的文本
durationNumber否0 为短时，1 为长时，默认 0

示例：

  1. prompt.showToast({
  2.   message: 'message'
  3. })

prompt.showDialog(OBJECT)

显示对话框

参数：

参数名类型必填说明
titleString否标题
messageString否内容
buttonsArray否按钮的数组，按钮结构：{text:'text',color:'#333333'}，color 可选：buttons 的第 1 项为 positive button；buttons 的第 2 项（如果有）为 negative button；buttons 的第 3 项（如果有）为 neutral button。最多支持 3 个 button
successFunction否成功回调
cancelFunction否取消回调
completeFunction否执行结束后的回调
success 返回值：
参数名类型说明
indexInteger选中按钮在 buttons 数组中的序号

示例：

  1. prompt.showDialog({
  2.   title: 'title',
  3.   message: 'message',
  4.   buttons: [
  5.     {
  6.       text: 'btn',
  7.       color: '#33dd44'
  8.     }
  9.   ],
  10.   success: function(data) {
  11.     console.log('handling callback')
  12.   },
  13.   cancel: function() {
  14.     console.log('handling cancel')
  15.   },
  16.   fail: function(data, code) {
  17.     console.log(`handling fail, code = ${code}`)
  18.   }
  19. })

prompt.showContextMenu(OBJECT)

显示上下文菜单

参数：

参数名类型必填说明
itemListArray是按钮的文字数组
itemColorHexColor否按钮颜色
successFunction否成功回调
cancelFunction否取消回调
completeFunction否执行结束后的回调
success 返回值：
参数名类型说明
indexInteger选中按钮在 itemList 数组中的序号

示例：

  1. prompt.showContextMenu({
  2.   itemList: ['item1', 'item2'],
  3.   itemColor: '#ff33ff',
  4.   success: function(data) {
  5.     console.log('handling success')
  6.   },
  7.   cancel: function() {
  8.     console.log('handling cancel')
  9.   },
  10.   fail: function(data, code) {
  11.     console.log(`handling fail, code = ${code}`)
  12.   }
  13. })

后台运行限制

禁止使用。后台运行详细用法参见后台运行 脚本。