智能小程序 Ray 开发界面 API —— 交互 API 合集

showModal

显示模态对话框

引入

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

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
title	string		是	提示的标题
content	string		否	提示的内容
showCancel	boolean		否	是否显示取消按钮
cancelText	string		否	取消按钮的文字，最多 4 个字符
cancelColor	string		否	取消按钮的文字颜色，必须是 16 进制格式的颜色字符串
confirmText	string		否	确认按钮的文字，最多 4 个字符
confirmColor	string		否	确认按钮的文字颜色，必须是 16 进制格式的颜色字符串
complete	function		否	接口调用完成的回调函数（成功或失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
confirm	boolean	为 true 时，表示用户点击了确定按钮
cancel	boolean	为 true 时，表示用户点击了取消（用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭）

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

常见问题（FAQ）

如何自定义对话框内容？

可以去物料平台找找，比如 涂鸦风格对话框组件

 

showActionSheet

显示操作菜单

引入

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

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
alertText	string		否	警示文案
itemList	array		是	按钮的文字数组，数组长度最大为 6
itemColor	string		否	按钮的文字颜色
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
tapIndex	number	用户点击的按钮序号，从上到下的顺序，从 0 开始

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

 

showLoading

显示 loading 提示框。需主动调用 ty.hideLoading 才能关闭提示框

引入

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

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
title	string		是	提示的内容
mask	boolean		否	是否显示透明蒙层，防止触摸穿透
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

 

hideLoading

隐藏 loading 提示框

引入

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

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

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

 

showToast

显示消息提示框

引入

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

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
title	string		是	提示的内容
icon	string		否	图标 'success' / 'error' / 'loading' / 'none'
image	string		否	自定义图标的本地路径，image 的优先级高于 icon
duration	number		否	提示的延迟时间
mask	boolean		否	是否显示透明蒙层，防止触摸穿透
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

 

hideToast

隐藏消息提示框

引入

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

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

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

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。