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
属性来帮助你更好地介绍,我们称之为辅助性文字。 辅助性文字只能存放文本内容,会自动换行。
带图标和描述
最后,这是一个同时具有图标和描述的示例。
带延迟属性 2.10.0
最后,这是一个带有延迟属性的例子。
Alert API
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
title | 警告标题 | string | — |
type | 警告类型 | 枚举 | 信息 |
description | 描述性文本 | string | — |
可关闭 | 警告是否可以关闭 | boolean | true |
居中 | 内容是否居中 | boolean | false |
关闭按钮文本 | 自定义关闭按钮的文本 | string | — |
显示图标 | 是否显示类型图标 | boolean | false |
effect | 主题样式 | 枚举 | light |
延迟显示 2.10.0 | 延迟出现,单位毫秒 | number | 0 |
延迟隐藏 2.10.0 | 延迟消失,单位毫秒 | number | 200 |
自动关闭 2.10.0 | 隐藏警告的超时时间(毫秒) | number | 0 |
事件
名称 | 描述 | 类型 |
---|---|---|
打开 2.10.0 | 当警告被打开时触发 | Function |
关闭 | 当警告被关闭时触发 | Function |
插槽
名称 | 描述 |
---|---|
default | 警告描述的内容 |
title | 警告标题的内容 |
图标 2.9.7 | 警告图标的内容 |