897 B
897 B
name, description
| name | description |
|---|---|
| frontend-dialog | 前端弹窗规范。用于需要确认、提醒、提示输入的交互场景,统一使用 GlobalDialog(或项目统一对话框 Hook),禁止浏览器原生弹窗。 |
弹窗规范
核心规则
- 禁止使用
window.alert/window.confirm/window.prompt - 必须使用项目统一弹窗能力(
GlobalDialog或统一useDialog)
使用要求
- 确认型操作使用异步确认 API(返回
Promise<boolean>) - 错误提示使用统一
alert/toast能力 - 成功反馈使用统一
toast,避免散落样式
最小流程
- 在应用根节点挂载
DialogProvider - 页面内通过 Hook 调
confirm/alert/toast - 危险操作必须先
await confirm(...)再执行
设计目标
- 统一视觉风格与交互行为
- 避免原生弹窗破坏主题与体验
- 降低重复实现和状态不一致