Alert 警告
用于展示重要的提示信息。
基础用法
Alert 组件是非浮层元素,不会自动消失。
Alert 组件提供 5 种主题,由 type 属性指定,默认值为 info。primary 在 2.9.11 版本中新增。
主题
Alert 提供两种不同的主题:light 和 dark。
设置 effect 属性来改变主题,默认值为 light。
自定义关闭按钮
自定义关闭按钮为文本或其他符号。
Alert 允许你配置是否可关闭。关闭按钮的文本和关闭时的回调函数也是可以自定义的。closable 属性决定组件是否可以关闭。它接受一个 boolean 值,默认值为 true。你可以设置 close-text 属性来替换默认的关闭图标。注意 close-text 必须为字符串。当组件关闭时,会触发 close 事件。
带有图标
显示图标可以提高可读性。
设置 show-icon 属性会显示与当前 Alert 类型对应的图标。或者使用 icon 插槽来自定义图标。
文字居中
使用 center 属性让文字居中。
带有描述
描述包含更详细的信息。
除了必选的 title 属性外,你还可以添加 description 属性来帮助你更详细地描述警告信息。 描述只能存储文本字符串,并且会自动换行。
带有图标和描述
最后,这是一个同时具有图标和描述的示例。
Alert API
属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| title | 警告框标题。 | string | — |
| type | 警告框类型。 | 枚举 | 信息 |
| description | 描述性文本。 | string | — |
| 可关闭 | 是否可以关闭。 | boolean | true |
| 居中 | 内容是否居中。 | boolean | false |
| 关闭按钮文本 | 自定义关闭按钮文本。 | string | — |
| 是否显示类型图标 | 是否显示类型图标。 | boolean | false |
| effect | 主题样式。 | 枚举 | light |
事件
| 名称 | 描述 | 类型 |
|---|---|---|
| 关闭 | 关闭时触发的事件。 | Function |
插槽
| 名称 | 描述 |
|---|---|
| default | 警告框描述内容。 |
| title | 警告框标题内容。 |
| 图标 2.9.7 | 警告框图标内容。 |