通知
通知 在 VS Code 的右下方显示简短信息。
您可以发送三种类型的通知
重要的是限制发送的通知数量,以尊重用户的注意力。为了帮助您决定是否应该显示通知,请遵循我们的通知决策树
通知示例
此通知在用户运行更新版本命令后出现。请注意,没有其他操作,并且纯粹是信息性的。
此示例突出显示了需要用户输入的功能的问题,并显示了解决问题的操作。
此示例显示了一个失败通知,其中包含解决问题的操作。
✔️ 建议
- 仅在绝对必要时发送通知,以尊重用户的注意力
- 为每个通知添加不再显示选项
- 一次显示一个通知
❌ 不建议
- 发送重复的通知
- 用于促销
- 在首次安装时请求反馈
- 如果没有操作,则显示操作
进度通知
当需要显示不确定时间范围的进度时(例如,设置环境),您可以使用进度通知。这种类型的全局进度通知应作为最后的手段使用,因为进度最好保持在上下文中(在视图或编辑器中)。
✔️ 建议
- 显示链接以查看更多详细信息(如日志)
- 在设置进行时显示信息(正在初始化、正在构建等)
- 提供取消操作的操作(如果适用)
- 为超时场景添加计时器
❌ 不建议
- 让通知在进度中运行
此示例使用进度通知显示远程连接所涉及的设置,同时还提供指向输出日志的链接(详细信息)。
模态对话框
当您需要用户立即输入以执行操作时,您可以选择显示模态对话框。应谨慎使用此 UI 元素,因为模态对话框会阻止对话框外部的用户交互,直到其被关闭。
此对话框在移动 JavaScript/TypeScript 文件后出现,询问是否更新其他文件中的导入语句。
✔️ 建议
- 仅当您需要用户立即交互时才使用模态对话框
- 在适当的情况下,提供避免重复用户确认的操作(始终/从不 操作)
- 考虑使用复选框记住用户的选择
❌ 不建议
- 使用模态对话框确认多个步骤
- 使用模态对话框显示不需要用户操作的消息
- 为非用户显式启动的操作显示模态对话框