Alert 提示
用于页面中展示重要的提示信息。
基础用法
Alert 组件不属于浮层元素,不会自动消失或关闭。
Alert 组件提供多种主题,由 type 属性指定,默认值为 primary。基础示例里可以用 effect 在 light 与 dark 之间切换,默认是 light。
文字超出滚动 1.3.4
使用 scroll 属性让超长标题自动滚动。
scroll 为 true 时标题从右向左无缝滚动,仅在标题实际宽度超出容器时才产生位移,鼠标悬停暂停、移出后继续;开启 scroll 后标题只渲染 title 属性文本,title 插槽在该分支下不再生效。
标题加粗 1.3.4
使用 bold-title 属性让标题加粗显示。
bold-title 为 true 时标题文本加粗,与是否存在辅助性文字无关,且不会改变辅助性文字的字重。
通栏提示 1.3.4
使用 banner 属性让提示以通栏形态展示,常用于页面顶部的公告。
banner 为 true 时组件撑满父容器,图标与标题作为一组水平居中,关闭按钮固定在末尾,无圆角、无边框颜色,标题使用主题主文本色;可与 closable、close-text、show-icon 组合使用。
延迟属性 0.0.11
自定义关闭按钮
你可以自定义关闭按钮为文字或其他符号。
你可以设置 Alert 组件是否为可关闭状态,关闭按钮的内容以及关闭时的回调函数同样可以定制。closable 属性决定 Alert 组件是否可关闭,该属性接受一个 boolean,默认为 true。你可以设置 close-text 属性来代替右侧的关闭图标,需要注意的是 close-text 必须是一个字符串。当 Alert 组件被关闭时会触发 close 事件。
使用图标
你可以通过为 Alert 组件添加图标来提高可读性。
通过设置 show-icon 属性来显示 Alert 的 icon,这能更有效地向用户展示你的显示意图。也可以通过 icon 插槽自定义图标。有描述文字时,图标会使用更大的尺寸。
文字居中
使用 center 属性来让文字水平居中。
文字描述
为 Alert 组件添加一个更加详细的描述来使用户了解更多信息。
除了必填的 title 属性外,你可以设置 description 属性来帮助你更好地介绍,我们称之为辅助性文字。 辅助性文字只能存放文本内容,当内容超出长度限制时会自动换行显示。
Alert API
属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| title | Alert 标题。 | string | — |
| type | Alert 类型。 | enum | primary |
| description | 描述性文本。 | string | — |
| closable | 是否可以关闭。 | boolean | true |
| center | 文字是否居中。 | boolean | false |
| bold-title 1.3.4 | 标题是否加粗。与是否存在辅助性文字无关。 | boolean | false |
| banner 1.3.4 | 是否为通栏提示。图标与标题作为一组居中,关闭按钮在末尾。 | boolean | false |
| scroll 1.3.4 | 标题超出容器时是否从右向左滚动。开启后只渲染 title 文本。 | boolean | false |
| close-text | 自定义关闭按钮文本。 | string | — |
| show-icon | 是否显示类型图标。 | boolean | false |
| effect | 主题样式。 | enum | light |
| show-after 0.0.11 | 在触发后多久显示内容,单位毫秒。 | number | 0 |
| hide-after 0.0.11 | 点击关闭后延迟隐藏,单位毫秒。 | number | 200 |
| auto-close 0.0.11 | 出现后自动隐藏的延时,单位毫秒。为 0 时不自动隐藏。 | number | 0 |
Events
| 名称 | 描述 | 类型 |
|---|---|---|
| close | 关闭 Alert 时触发的事件。点击关闭时参数为点击事件,自动关闭时可能没有事件对象。 | Function |
| open 0.0.11 | 开启 Alert 时触发的事件。 | Function |
Slots
| 名称 | 描述 |
|---|---|
| default | Alert 内容描述。仅含注释节点时不渲染描述区域。 |
| title | 标题的内容。scroll 为 true 时不使用该插槽。 |
| icon 0.0.11 | 自定义类型图标,需同时开启 show-icon。 |
Copyright 2025 Winning Health 版权所有

