Skip to content

Message 全局提示

轻量的顶部消息提示,用于全局展示操作反馈。支持信息、成功、警告、错误等类型,默认自动关闭,也可手动关闭或常驻。

基础用法

通过全局方法 $message 打开一个消息提示,默认类型为 info

消息类型

提供四种内置类型:infosuccesswarningerror

可关闭

设置 showClose: true 显示关闭按钮,常配合 duration: 0 使其常驻。

持续时间

通过 duration 设置自动关闭时间(毫秒)。设置为 0 则不会自动关闭。

背景色

设置 background: true 以主题色浅色背景展示,更醒目。

偏移

通过 offset 控制与顶部的偏移(单位:px)。多个消息会自动错位堆叠。

关闭全部

调用 $message.closeAll() 可快速关闭所有消息。

方法

方法名参数说明
$message(options)打开一条消息
$message.info(options)打开信息消息(快捷方法)
$message.success(options)打开成功消息(快捷方法)
$message.warning(options)打开警告消息(快捷方法)
$message.error(options)打开错误消息(快捷方法)
$message.closeAll()关闭当前所有消息

提示:示例中均使用对象参数形式调用,以便明确各配置项。

选项

选项名类型默认值说明
contentstring''消息正文内容
typestringinfo类型:info/success/warning/error
durationnumber3000自动关闭的延时,单位 ms,设为 0 不关闭
showClosebooleanfalse是否显示右侧关闭按钮
backgroundbooleanfalse是否使用浅色背景样式
offsetnumber16与顶部的初始偏移,支持多个消息堆叠
onClose() => void-关闭后的回调
## 安装与调用

全量引入组件库时会自动注册全局方法 $message,可直接在组件内调用。

按需引入时也可单独安装:

ts
import { createApp } from "vue"
import { UeMessage } from "flori-ui-vue3"

const app = createApp(App)
app.use(UeMessage)