Notification 通知
在页面角落显示全局的通知提醒消息。
基础用法
不同类型
我们提供了四种类型:success、warning、info 和 error。
自定义位置
通知可以从您喜欢的任何角落出现。
带有偏移量
自定义通知从屏幕边缘的偏移量。
使用 HTML 字符串
message 属性支持 HTML 片段。
警告
message 属性虽然支持传入 HTML 片段,但是在网站上动态渲染任意 HTML 是非常危险的,因为容易导致 XSS 攻击。 因此,当 dangerouslyUseHTMLString 打开的情况下,请确保 message 的内容是可信的,永远不要将用户提交的内容赋值给 message 属性。
使用函数的 Message 2.9.0
message 可以是 VNode。
在 2.9.0 版本后, message 支持一个函数,其返回值是一个 VNode。
隐藏关闭按钮
可以隐藏关闭按钮
全局方法
Element Plus 为 app.config.globalProperties 添加了一个全局方法 $notify。 因此,在一个 vue 实例中,你可以像我们在这个页面上做的那样调用 Notification。
局部导入
import { ElNotification } from 'element-plus'
import { CloseBold } from '@element-plus/icons-vue'
ElNotification({
title: 'Title',
message: 'This is a message',
closeIcon: CloseBold,
})在这种情况下,您应该调用 ElNotification(options)。 我们还为不同的类型注册了方法,例如 ElNotification.success(options)。 您可以调用 ElNotification.closeAll() 来手动关闭所有实例。 在 2.10.5 版本中,你可以通过调用 ElNotification.updateOffsets(position) 来手动更新特定方向所有实例的偏移量。
应用上下文继承 > 2.0.4
现在通知接受 context 作为消息构造函数的第二个参数,它允许您将当前应用程序的上下文注入到通知中,从而允许您继承应用程序的所有属性。
您可以像这样使用它
提示
如果您全局注册了 ElNotification 组件,它将自动继承您的应用程序上下文。
import { getCurrentInstance } from 'vue'
import { ElNotification } from 'element-plus'
// in your setup method
const { appContext } = getCurrentInstance()!
ElNotification({}, appContext)API
配置项
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| title | title | string | '' |
| message | 描述文本 | string / VNode / Function | '' |
| dangerouslyUseHTMLString | message 是否被当作 HTML 字符串处理 | boolean | false |
| type | 通知类型 | 枚举 | '' |
| icon | 自定义图标组件。 它将被 type 覆盖 | string / Component | — |
| customClass | Notification 的自定义类名 | string | '' |
| duration | 关闭前的持续时间。 如果设置为 0,它不会自动关闭 | number | 4500 |
| 位置 | 自定义位置 | 枚举 | 右上角 |
| showClose | 是否显示关闭按钮 | boolean | true |
| onClose | 关闭时回调函数 | Function | — |
| onClick | 点击通知时回调函数 | Function | — |
| offset | 距离屏幕顶部的偏移量。 同一时刻的每个通知实例应具有相同的偏移量 | number | 0 |
| appendTo | 设置通知的根元素,默认为 document.body | CSSSelector / HTMLElement | — |
| zIndex | 初始 zIndex | number | 0 |
| closeIcon 2.9.8 | 自定义关闭图标 | string / Component | 关闭 |
方法
Notification 和 this.$notify 返回当前的通知实例。 要手动关闭该实例,您可以在其上调用 close。
| 名称 | 描述 | 类型 |
|---|---|---|
| 关闭 | 关闭通知 | Function |