Skip to content

Message 消息提示

用于页面顶部展示轻量反馈,支持成功、错误、警告类型和自动关闭。

示例

基础用法

MtMessage函数式调用,不需要在模板中声明组件,调用后会自动在顶部创建消息并在超时后自动关闭。

消息类型

提供三种内置类型:successerrorwarning,每种类型有对应的快捷方法。

持续时间

通过 duration 控制自动关闭时间,单位毫秒。设为 0 不会自动关闭。

偏移量

通过 offset 控制消息距离窗口顶部的偏移量。

关闭与回调

可以手动关闭消息,也可以监听关闭回调。closeAll() 可以关闭所有当前显示的消息。

HTML 内容

消息内容支持 HTML,可以展示格式化文本。

API

Options

属性名说明类型默认值示例
message消息文字string必填{ message: '保存成功' }
type消息类型'success' | 'error' | 'warning''success'{ type: 'warning' }
duration显示时间,单位 ms;设为 0 不自动关闭number3000{ duration: 0 }
show-close是否显示关闭按钮booleanfalse{ showClose: true }
offset距离窗口顶部的偏移量number16{ offset: 48 }
on-close关闭回调Function-{ onClose: () => handleClose() }

Methods

方法名说明返回值示例
MtMessage(options)打开消息提示MessageHandlerMtMessage({ message: '保存成功' })
MtMessage.success(options)打开成功提示MessageHandlerMtMessage.success('保存成功')
MtMessage.error(options)打开错误提示MessageHandlerMtMessage.error('保存失败')
MtMessage.warning(options)打开警告提示MessageHandlerMtMessage.warning('请检查输入')
MtMessage.closeAll(type?)关闭全部或指定类型提示voidMtMessage.closeAll('success')

Handler

方法名说明类型示例
close关闭当前消息提示() => voidhandler.close()

Slots

该方法式组件不提供插槽。

注意事项

  • 消息文案应简短明确,避免承载复杂操作。
  • 错误提示建议说明原因或给出可执行的下一步。