用途:读取目标组件或页面文件,找出所有依赖数据的区域,并为其补齐完整的用户反馈状态,避免出现空白、闪烁或错误无提示的问题。
主要能力:为每个数据依赖区域实现四种状态。加载态使用骨架屏,形状需与最终内容尺寸一致,配合 animate-pulse(1.5 秒循环),延迟 300 毫秒显示且至少展示 300 毫秒,快速加载可跳过骨架屏,卡片内不使用旋转加载图标。空状态居中显示,使用指定图标与文字层级,始终给出下一步操作建议,零值显示为“0”。错误态区分局部失败与整页失败,局部失败仅影响相关卡片,错误文案使用平实语言并归因于系统,始终提供重试按钮。成功态使用 Toast 确认操作,信息类提示显示 3 秒,带撤销的操作类提示显示 5 秒,位置在 BottomNav 之上,同一时间只保留一个 Toast。
使用方式:以目标为参数调用,先读取目标文件,再参考 DESIGN-LANGUAGE.md 中加载、空、错误状态相关章节,按实现模式依次判断 isLoading、error、空数据、正常内容并返回对应视图。
限制:需遵循 prefers-reduced-motion,在用户偏好减少动态效果时禁用 animate-pulse。资料未提供该技能的安装命令、平台支持、收费信息与更多配置项。