Alert 提示
用于页面中展示重要的提示信息。
基础用法
Alert 组件不属于浮层元素,不会自动消失或关闭。
Alert 组件提供5种类型,由 type
属性指定,默认值为 info
。 primary
已被添加到2.9.11。
主题
Alert 组件提供了两个不同的主题:light
和 dark
。
通过设置 effect
属性来改变主题,默认为 light
。
自定义关闭按钮
你可以自定义关闭按钮为文字或其他符号。
你可以设置 Alert 组件是否为可关闭状态, 关闭按钮的内容以及关闭时的回调函数同样可以定制。 closable
属性决定 Alert 组件是否可关闭, 该属性接受一个 Boolean
,默认为 false
。 你可以设置 close-text
属性来代替右侧的关闭图标, 需要注意的是 close-text
必须是一个字符串。 当 Alert 组件被关闭时会触发 close
事件。
使用图标
你可以通过为 Alert 组件添加图标来提高可读性。
通过设置 show-icon
属性来显示 Alert 的 icon,这能更有效地向用户展示你的显示意图。 或者你可以使用 icon
slot 自定义 icon 内容。
文字居中
使用 center
属性来让文字水平居中。
文字描述
为 Alert 组件添加一个更加详细的描述来使用户了解更多信息。
除了必填的 title
属性外,你可以设置 description
属性来帮助你更好地介绍,我们称之为辅助性文字。 辅助性文字只能存放文本内容,当内容超出长度限制时会自动换行显示。
带图标和描述
在最后, 这是一个带有图标和描述的例子。
With Delayed Attributes 2.9.12
At last, this is an example with delayed attributes.
Alert API
属性
名称 | 说明 | 类型 | 默认值 |
---|---|---|---|
title | Alert 标题。 | string | — |
type | Alert 类型。 | enum | info |
description | 描述性文本 | string | — |
closable | 是否可以关闭 | boolean | true |
center | 文字是否居中 | boolean | false |
close-text | 自定义关闭按钮文本 | string | — |
show-icon | 是否显示类型图标 | boolean | false |
effect | 主题样式 | enum | light |
show-after 2.9.12 | delay of appearance, in millisecond | number | 0 |
hide-after 2.9.12 | delay of disappear, in millisecond | number | 200 |
auto-close 2.9.12 | timeout in milliseconds to hide alert | number | 0 |
Events
名称 | 描述 | 类型 |
---|---|---|
open 2.9.12 | trigger when alert is opened. | Function |
close | 关闭 Alert 时触发的事件 | Function |
Slots
名称 | 描述 |
---|---|
default | Alert 内容描述 |
title | 标题的内容 |
icon 2.9.7 | icon 的内容 |