electron/docs-translations/zh-CN/tutorial/notifications.md
Jonas Zhang 6fa9249062 Add notification.md file in Chinese
Add notification.md file in Chinese
2017-10-11 09:42:34 +08:00

3.3 KiB
Raw Blame History

通知 (Windows, Linux, macOS)

所有三个操作系统都提供了应用程序向用户发送通知的手段。Electron允许开发者使用 HTML5 Notification API 发送通知,并使用当前运行的操作系统的本地通知 API 来显示它。

注意: 由于这是一个 HTML5 API它只能在渲染器进程中使用。 如果你想在主进程中显示通知,请查看 Notification 模块.

let myNotification = new Notification('标题', {
  body: '通知正文内容'
})

myNotification.onclick = () => {
  console.log('通知被点击')
}

虽然操作系统的代码和用户体验相似,但依然存在微妙的差异。

Windows

  • 在 Windows 10 上, 通知 "仅能运行".
  • 在 Windows 8.1 和 Windows 8 上, 你的应用程序的快捷方式,[Application User Model ID][app-user-model-id],必须安装到 “开始” 屏幕。但是请注意,它不需要被固定到开始屏幕。
  • 在 Windows 7 上, 通知通过视觉上类似于较新系统原生的一个自定义的实现来工作。

此外在Windows 8中通知正文的最大长度为250个字符Windows团队建议将通知保留为200个字符。 然而Windows 10中已经删除了这个限制但是Windows团队要求开发人员合理使用。 尝试将大量文本发送到API数千个字符可能会导致不稳定。

高级通知

Windows 的更高版本允许高级通知,自定义模板,图像和其他灵活元素。 要发送这些通知(来自主进程或渲染器进程),请使用用户区模块 electron-windows-notifications 来用原生节点附件发送 ToastNotificationTileNotification 对象。

虽然包含按钮的通知只能使用 electron-windows-notifications,但处理回复则需要使用electron-windows-interactive-notifications这有助于注册所需的COM组件并使用输入的用户数据调用Electron应用程序。

免打扰模式 / 演示模式

要检测是否允许发送通知,请使用用户区模块 electron-notification-state

这样,您可以提前确定 Windows 是否会将通知忽略。

macOS

macOS上的通知是最直接的但你应该注意 苹果关于通知的人机接口指南.

请注意通知的大小限制为256个字节如果超过该限制则会被截断。

高级通知

后来的 macOS 版本允许有一个输入字段的通知,允许用户快速回复通知。为了通过输入字段发送通知,请使用用户区模块 node-mac-notifier

勿扰 / 会话状态

要检测是否允许发送通知,请使用用户区模块 electron-notification-state.

这样可以提前检测是否显示通知。

Linux

通知使用 libnotify 发送,可以在 [Desktop Notifications Specification] [notification-spec] 之后的任何桌面环境中显示通知,包括 Cinnamon, Enlightenment, Unity, GNOME, KDE.