Skip to content

Alert 警告提示 ​

内嵌式提示条,用于展示成功、信息、警告或错误信息,支持标题、描述、图标、操作区、关闭动画与多种变体。

基础用法 ​

四种类型

这是一条普通信息操作已成功完成请注意保存当前进度操作失败,请稍后重试

无标题 ​

无标题

仅包含正文内容、不带标题行的提示条。

图标 ​

icon 显示 type 对应的默认图标;slot="icon" 可传入自定义图标覆盖;prominent 将图标放大一档(需与 icon 或 banner 联动)。

图标(icon)

这是一条带图标的信息提示操作已成功完成请注意保存当前进度操作失败,请稍后重试

自定义图标(slot=icon)

🚀 通过 slot="icon" 替换默认图标,可放任意图标或图片。

大图标(prominent)

⚠️立即清理 当前可用空间仅剩 1.2GB,请及时清理缓存。

描述 ​

description 属性或 slot="description" 渲染描述行,位于标题与正文之间,可与默认插槽正文并存。

描述(description)

请提前保存工作内容,维护完成后系统自动恢复。 这是插槽描述,支持富内容。 仅使用插槽描述、不带标题的提示条。

操作区 ​

slot="action" 渲染右侧操作区(如查看详情、撤销等按钮),与关闭按钮并存时位于其左侧。

操作区(slot=action)

立即更新稍后再说 检测到新版本 v2.4.0,包含多项性能优化与缺陷修复。

变体 ​

variant 支持三种形态:tint(默认,浅底+描边)/ filled(type 色实心+对底文字)/ outlined(透明底+type 色描边)。

变体(variant)

默认形态,浅色底 + 同色描边。type 色实心底,文字自动切换为对底色。透明底 + type 色描边。

横幅 ​

banner 去掉边框圆角、通栏展示,并默认显示 type 图标(联动 icon);常与 center 组合用于页面顶部居中横幅。

横幅(banner + center)

平台将于周六 00:00 - 06:00 进行系统升级,请提前规划操作时间。

横幅可关闭

检测到异常流量,部分请求已被拦截,请确认账户安全。

居中 ​

center 让文本区水平居中(标题/描述/正文),常用于 banner 横幅与纯文本提示。

居中(center)

内容区域水平居中对齐。

可关闭 ​

可关闭

点击右侧 ✕ 可关闭此提示条未设置标题的关闭型提示

关闭动画与受控显隐 ​

关闭时播放淡出过渡,过渡结束派发 oas-after-close;open 属性为受控显隐(默认开),关闭后组件移除 open 并派发 oas-open-change,宿主重设 open 可重新打开。prefers-reduced-motion 下自动跳过过渡直接隐藏。

关闭动画(open 受控重开)

重新打开提示点击右侧 ✕ 关闭,动画结束后可用上方按钮重新打开。

受控显隐(open)

打开(设置 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)

紧凑场景使用。常规场景。重点展示场景。

事件反馈 ​

事件反馈

关闭时触发 oas-close,显隐切换触发 oas-open-change。

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 截断并显示展开/收起按钮;缺省不折叠string0
open受控显隐(默认 true):关闭后组件回写 false 并派发 oas-open-change;宿主重设 true 可重新打开boolean—
prominent大图标:图标尺寸放大一档(与 icon 联动)boolean—
size尺寸档:small/medium/large(默认 medium),字号与内边距随之缩放stringmedium
title标题文案(渲染进可见标题区;读取后即从宿主移除,不残留原生悬浮提示;清空传空串);富内容用 slot="title"string—
type提示类型stringinfo
variant视觉形态:tint(默认,浅底+同色描边)/ filled(type 色实心+对底文字)/ outlined(透明底+type 色描边)stringtint

事件 ​

事件说明
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-line2

基于 MIT OR Apache-2.0 双许可发布