跳到主要内容
前端术语库

警告提示

Alert

UI 组件也叫:提示条、横幅提示、Banner、Callout

一句话:固定显示在页面或区块内的带色提示横条,用来说明当前状态、风险或需要注意的事项。

详细解释

警告提示是页面里一块带底色的横条,左侧有图标,右侧是一两句说明,有时带「去处理」链接或关闭按钮。它按严重程度分成成功、信息、警告、错误四种,用不同颜色和图标区分。它是页面内容的一部分,不会自动消失,通常放在页面顶部、表单上方或某个区块开头。文档站里常见的「提示」「注意」框(Callout)也属于这一类。

和 轻提示 的区别:轻提示浮在页面上、几秒后消失,用来反馈刚刚的操作;警告提示是静态的,说明一个持续存在的状态,比如「试用期还剩 3 天」「当前网络离线」。和 通知提醒框 的区别:通知从角落弹出,是新到达的消息;警告提示不会弹出,它就长在页面里。

示例

灰度线框示意,只表达结构,不代表具体视觉风格。

怎么跟 AI 说

可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。

在表单顶部放一个黄色警告提示条,左侧是感叹号图标,文字写「你的邮箱尚未验证,部分功能无法使用」,右侧带「立即验证」链接和关闭按钮;关闭后本次访问不再显示,提示条和表单同宽,不要做成浮动弹窗。

结构与适用场景

结构描述

一个带底色和边框的横条,由状态图标、标题或说明文字、可选的操作链接和关闭按钮组成。

适用场景

  • 需要持续提醒一个尚未解决的状态,比如账号未验证、服务维护中
  • 表单提交失败,需要在表单上方汇总说明原因
  • 文档或设置页里,需要把一段注意事项和正文区分开

不适用场景

  • 只是反馈刚完成的操作结果,比如「复制成功」
  • 新到达的消息需要吸引注意,而用户可能正在页面别处操作
  • 同一页面要显示很多条提示,堆在一起会让人全部忽略

常见坏用法

  • 页面顶部叠了三四个警告提示条,把正文挤到首屏以下
  • 所有提示都用红色错误样式,用户分不清轻重
  • 把警告提示做成悬浮在内容上方的浮层,遮住了下面的表单

识别特征

  • 与内容同宽的浅色底横条,带细边框或左侧色块
  • 左侧有对勾、感叹号或叉号等状态图标
  • 位置固定在页面流里,不会自动消失

DOM 线索

插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。

  • [role="alert"]
  • .ant-alert
  • .el-alert
  • [class*="MuiAlert-root"]
  • .arco-alert
  • .t-alert
  • .n-alert
  • [data-slot="alert"]
  • .alert