– 代理会话日,2月19日

通知

通知 从 VS Code 的右下角显示简短的信息。

Example of a notification

您可以发送三种类型的通知

重要的是要限制发送的通知数量,以尊重用户的注意力。为了帮助您决定是否应该显示通知,请遵循我们的通知决策树

Show a multi-step quick pick if multi step user input is immediately needed. If user input is immediately needed but it is not multi-step show a modal dialog. If you need to show progress that is low priority show the progress in the status bar. If the interaction is triggered by the user find the right moment to show the notification and only then show it. If you need to show multiple notifications try to combine them into one. If the user does not really need to be notified consider to not show anything and relax.

通知示例

Information notification

此通知在用户运行“更新版本”命令后出现。请注意,没有其他操作,纯粹是信息性的。

Warning notification

此示例突出显示了功能存在问题,需要用户输入,并显示了解决问题的操作。

Error notification

此示例显示了一个失败通知,并提供了一个解决问题的操作。

✔️ 建议

  • 尊重用户的注意力,只有在绝对必要时才发送通知
  • 为每个通知添加“不再显示”选项
  • 一次显示一个通知

❌ 不建议

  • 发送重复的通知
  • 用于促销
  • 首次安装时请求反馈
  • 如果没有操作,则显示操作

进度通知

当需要显示不确定时间范围的进度(例如,设置环境)时,可以使用进度通知。这种类型的全局进度通知应作为最后的手段,因为最好在上下文中保留进度(在视图或编辑器中)。

✔️ 建议

  • 显示一个链接以查看更多详细信息(例如日志)
  • 显示设置进度信息(初始化、构建等)
  • 提供取消操作的选项(如果适用)
  • 为超时场景添加计时器

❌ 不建议

  • 让通知保持运行状态

Progress notification

此示例使用进度通知来显示远程连接涉及的设置,同时提供指向输出日志的链接(详细信息)。

当您需要立即获取用户对某个操作的输入时,可以选择显示模态对话框。应谨慎使用此 UI 元素,因为模态对话框会阻止用户与对话框外的交互,直到其被关闭。

Modal dialog

此对话框在移动 JavaScript/TypeScript 文件后出现,询问是否更新其他文件中的导入语句。

✔️ 建议

  • 只有在需要立即用户交互时才使用模态对话框
  • 在适当的情况下,提供一个操作以避免重复的用户确认(始终/从不 操作)
  • 考虑使用复选框来记住用户的选择

❌ 不建议

  • 使用模态对话框确认多个步骤
  • 使用模态对话框显示不需要用户操作的消息
  • 对于用户未明确发起的动作,显示模态对话框
© . This site is unofficial and not affiliated with Microsoft.