Alert 警告提示
内嵌式提示条,用于展示成功、信息、警告或错误信息,支持标题、描述、图标、操作区、关闭动画与多种变体。
基础用法
四种类型
无标题
无标题
图标
icon 显示 type 对应的默认图标;slot="icon" 可传入自定义图标覆盖;prominent 将图标放大一档(需与 icon 或 banner 联动)。
图标(icon)
自定义图标(slot=icon)
slot="icon" 替换默认图标,可放任意图标或图片。 大图标(prominent)
描述
description 属性或 slot="description" 渲染描述行,位于标题与正文之间,可与默认插槽正文并存。
描述(description)
操作区
slot="action" 渲染右侧操作区(如查看详情、撤销等按钮),与关闭按钮并存时位于其左侧。
操作区(slot=action)
变体
variant 支持三种形态:tint(默认,浅底+描边)/ filled(type 色实心+对底文字)/ outlined(透明底+type 色描边)。
变体(variant)
横幅
banner 去掉边框圆角、通栏展示,并默认显示 type 图标(联动 icon);常与 center 组合用于页面顶部居中横幅。
横幅(banner + center)
横幅可关闭
居中
center 让文本区水平居中(标题/描述/正文),常用于 banner 横幅与纯文本提示。
居中(center)
可关闭
可关闭
关闭动画与受控显隐
关闭时播放淡出过渡,过渡结束派发 oas-after-close;open 属性为受控显隐(默认开),关闭后组件移除 open 并派发 oas-open-change,宿主重设 open 可重新打开。prefers-reduced-motion 下自动跳过过渡直接隐藏。
关闭动画(open 受控重开)
受控显隐(open)
open 控制显隐,同样带退场过渡。关闭自定义
close-text 替换 ✕ 文案(并同步为按钮可访问名称);slot="close" 提供富自定义关闭内容。
关闭自定义(close-text)
关闭自定义(slot=close)
折叠
max-line 数字属性用 CSS line-clamp 截断正文,并提供展开 / 收起按钮切换。
折叠(max-line)
色条
border 属性在对应侧渲染 type 色强调条,取值以空格分隔:top / end / bottom / start。
色条(border)
尺寸
size 三档:small / medium(默认)/ large,字号与内边距随之缩放。
尺寸(size)
事件反馈
事件反馈
API
oas-alert
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
banner | 横幅模式:去边框圆角、通栏展示;联动默认显示图标 | boolean | — |
border | 侧边色条:空格分隔多值 top/end/bottom/start(逻辑方向,RTL 自适应),对应侧渲染 type 色强调条 | string | — |
center | 文本区水平居中(标题/描述/正文);常与 banner 组合用于页面顶部公告 | boolean | — |
close-text | 关闭按钮文案(替换默认 ✕,如「知道了」);富自定义用 slot="close" | string | — |
closeable | 是否显示关闭按钮 | boolean | — |
description | 描述文案(标题下二级文字);富内容用 slot="description" | string | — |
icon | 显示 type 默认图标(信息/成功/警告/错误对应);slot="icon" 可覆盖 | boolean | — |
max-line | 正文最大行数:超出用 CSS line-clamp 截断并显示展开/收起按钮;缺省不折叠 | string | 0 |
open | 受控显隐(默认 true):关闭后组件回写 false 并派发 oas-open-change;宿主重设 true 可重新打开 | boolean | — |
prominent | 大图标:图标尺寸放大一档(与 icon 联动) | boolean | — |
size | 尺寸档:small/medium/large(默认 medium),字号与内边距随之缩放 | string | medium |
title | 标题文案(渲染进可见标题区;读取后即从宿主移除,不残留原生悬浮提示;清空传空串);富内容用 slot="title" | string | — |
type | 提示类型 | string | info |
variant | 视觉形态:tint(默认,浅底+同色描边)/ filled(type 色实心+对底文字)/ outlined(透明底+type 色描边) | string | tint |
事件
| 事件 | 说明 |
|---|---|
oas-after-close | 关闭退场过渡结束后派发(prefers-reduced-motion 下跳过过渡直接隐藏,仍派发) |
oas-close | 点击关闭按钮后触发,随后组件隐藏 |
oas-open-change | 显隐状态变化时派发,detail |
插槽
| 名称 | 说明 |
|---|---|
| 默认 | 正文内容插槽 |
action | 右侧操作区插槽(如「查看详情」「撤销」按钮),与关闭按钮并存时位于其左侧 |
close | 关闭元素富自定义,覆盖 ✕ 与 close-text;aria-label 仍取 close-text/locale |
description | 描述富内容插槽,有内容时覆盖 description 属性文案 |
icon | 图标插槽,覆盖 type 默认图标 |
title | 标题富内容插槽,有内容时覆盖 title 属性文案 |
CSS 变量
| CSS 变量 | 默认值 |
|---|---|
--oas-alert-max-line | 2 |