ks.showToast

更新时间：2025-06-04 15:06:47

显示消息提示框。

showToast(options: ShowToastOptions): Promise<void>

参数

参数	类型	必填
options	ShowToastOptions	是

ShowToastOptions

属性

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

icon

图标

值	说明
'success'	显示成功图标，此时 title 文本最多显示 7 个汉字长度
'none'	不显示图标，此时 title 文本最多可显示两行，1.9.0 及以上版本支持
'loading'	显示加载图标，此时 title 文本最多显示 7 个汉字长度

返回值

Promise<void>

扫码体验

示例代码