showModal - 显示模态对话框

showModal(params: Object)

版本要求:

BaseKit≥2.0.1@ray-js/ray≥0.3.23

支持平台:

iOSAndroid

import { showModal } from '@ray-js/ray';

// Promise 调用
try {
  const res = await showModal({ ...params });
  console.log(res);
} catch (err) {
  console.log(err.errorMsg);
}

描述

显示模态对话框

参数

属性	类型	必填	默认值	说明	BaseKit 最低版本
`title`	string	是	-	提示的标题	-
`content`	string	否	-	提示的内容	-
`showCancel`	boolean	否	`true`	是否显示取消按钮	-
`cancelText`	string	否	`"cancel"`	取消按钮的文字，最多 4 个字符	-
`cancelColor`	string	否	-	取消按钮的文字颜色，必须是 16 进制格式的颜色字符串	-
`confirmText`	string	否	`"confirm"`	确认按钮的文字，最多 4 个字符	-
`confirmColor`	string	否	-	确认按钮的文字颜色，必须是 16 进制格式的颜色字符串	-
`isShowGlobal`	boolean	否	`false`	是否全局弹窗，若为全局弹窗，弹在最顶上	v3.14.3
`modalStyle`	0 \| 1	否	`0`	弹窗样式	v3.21.2
		否	-	弹窗输入框属性	v3.21.2
`complete`	() => void	否	-	接口调用结束的回调函数（调用成功、失败都会执行）	-
`success`	(params: Object) => void	否	-	接口调用成功的回调函数	-
`fail`	(params: Object) => void	否	-	接口调用失败的回调函数	-

success 回调参数

属性	类型	说明	BaseKit 最低版本
`confirm`	boolean	为 true 时，表示用户点击了确定按钮	v3.2.6
`cancel`	boolean	为 true 时，表示用户点击了取消（用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭）	v3.2.6
`inputContent`	string	输入框的内容	v3.21.2

fail 回调参数

属性	类型	说明
`errorMsg`	string	错误信息
`errorCode`	string \| number	错误码
		错误扩展

返回值

无

合法值

`modalStyle`

值	说明	BaseKit 最低版本
`0`	默认样式	v3.21.2
`1`	Input 样式	v3.21.2

示例代码

import { showModal } from '@ray-js/ray'

// 显示模态对话框，回调返回用户点击的是确定还是取消
showModal({
  title: "提示",
  content: "确定执行此操作吗？",
  showCancel: true,
  cancelText: "取消",
  confirmText: "确定",
  success: data => console.log("confirm:", data.confirm, "cancel:", data.cancel),
  fail: error => console.error(error),
});