Message 消息提示

命令式全局消息提示，支持类型、自定义时长与手动关闭。

基础用法

四种类型

成功错误警告信息

示例代码

自定义时长

自定义时长

2 秒5 秒不自动关闭（0）

示例代码

手动关闭

手动关闭

弹出消息手动关闭

示例代码

清空全部

清空全部

连发三条清空全部

示例代码

分组消息

相同 group 的消息合并为一条，重复触发递增计数（×n）；不同 group 相互独立。

分组消息

保存（连点试试）同步（另一组）

示例代码

更新消息

key 标记消息后，可用 message.update(key, options) 更新内容/类型，message.destroy(key) 关闭指定消息。

更新消息

开始上传更新为成功关闭该条

示例代码

API

方法

方法	说明
message.info(content, duration?) / message.info(content, options?)	信息提示，返回 { close }
message.success(content, duration?) / message.success(content, options?)	成功提示，返回 { close }
message.warning(content, duration?) / message.warning(content, options?)	警告提示，返回 { close }
message.error(content, duration?) / message.error(content, options?)	错误提示，返回 { close }
message.update(key, { content, type?, duration? })	更新已存在消息内容/类型，key 不存在则新建
message.destroy(key)	关闭指定 key 的消息
destroyAllMessage()	清空全部消息

属性

属性	说明	类型	默认值
count	合并计数（>1 时内容后显示 ×n）	string	0
duration	自动关闭时长（ms），0 表示不自动关闭	string	3000
group	分组标识：同组消息合并为一条	—	—
key	唯一标识：供 message.update / message.destroy 定位	—	—
type	消息类型：info/success/warning/error	string	info

事件

事件	说明
oas-close	消息关闭时派发（自动关闭/关闭按钮/destroy），detail: { key? }

• options：{ duration?, group?, key?, onClose? }。group 同组消息合并为一条并递增计数；key 供 update / destroy 定位；onClose 关闭回调。
• duration 默认 3000ms，传 0 表示不自动关闭。
• 消息关闭（自动关闭 / 关闭按钮 / destroy）时派发 oas-close，detail: { key? }。
• 顶部居中堆叠；error 类型使用 role="alert"，其余使用 role="status"。