跳到主要内容
前端术语库

错误状态

Error State

交互模式也叫:报错状态、出错提示、Error

一句话:请求失败、输入有误或页面出错时展示给用户的画面,要说明出了什么问题以及下一步怎么办。

详细解释

错误状态分几个层级:字段级(某个输入框格式不对,在框下方显示提示)、区块级(某个卡片或列表加载失败,在原位置显示「加载失败,重试」)、页面级(404、500、断网,整页显示说明和返回按钮)、操作级(保存失败,用轻提示或警告条告知)。

好的错误提示有三个要素:说人话(「网络连接失败」而不是「Error 500」)、说原因(如果知道的话)、给出路(重试按钮、返回首页、联系客服)。一个区块出错,不要让整个页面白屏。

AI 写代码时经常只写成功的情况、漏掉失败分支,所以提需求时要明确要求它处理错误。

示例

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

怎么跟 AI 说

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

仪表盘里每个图表卡片单独处理错误:某个接口失败时,只在该卡片内显示灰色图标、「数据加载失败」和「重试」按钮,点击重试只重新请求这一个接口;其他卡片正常显示,不要整页报错或白屏。