Merge pull request #10740 from demopark/patch-1

Add notification docs translation in Chinese

docs-translations/zh-CN/api/notification.md

@@ -0,0 +1,109 @@
+# 通知
+
+> 创建系统桌面通知
+
+进程: [Main](../glossary.md#main-process)
+
+## 在渲染器进程中使用
+
+如果你想要从渲染器进程显示通知，则应使用 [HTML5 Notification API](../tutorial/notifications.md)
+
+## 类: Notification
+
+> 创建系统桌面通知
+
+进程: [Main](../glossary.md#main-process)
+
+`Notification` 是一个
+[EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
+
+它通过由 `options ` 设置的原生属性创建一个新的 `Notification`.
+
+### 静态方法
+
+`Notification` 类具有以下静态方法:
+
+#### `Notification.isSupported()`
+
+返回 `Boolean` - 无论当前系统是否支持桌面通知
+
+### `new Notification([options])` _实验性_
+
+* `options` 对象
+  * `title` 字符串 - 通知的标题，显示在通知窗口的顶部.
+  * `subtitle` 字符串 - (可选) 通知的副标题，将显示在标题下方.  _macOS_
+  * `body` 字符串 - 通知的正文，将显示在标题或副标题下方.
+  * `silent` 布尔 - (可选) 是否在显示通知时发出系统通知提示音.
+  * `icon` [NativeImage](native-image.md) - (可选) 通知所使用的图标
+  * `hasReply` 布尔 - (可选) 是否在通知中添加内联的回复选项.  _macOS_
+  * `replyPlaceholder` 字符串 - (可选) 在内联输入字段中的提示占位符.  _macOS_
+  * `sound` 字符串 - (可选) 显示通知时要播放的声音文件的名称.  _macOS_
+  * `actions` [NotificationAction[]](structures/notification-action.md) - (可选) 添加到通知中的操作. 请阅读 `NotificationAction` 文档中的可用操作和限制.  _macOS_
+
+
+### 实例事件
+
+使用 `new Notification` 创建的对象会发出以下事件:
+
+**注意:** 某些事件仅在特定的操作系统上可用，请参照标签标示。
+
+#### 事件: 'show'
+
+返回:
+
+* `event` 事件
+
+当向用户显示通知时发出. 注意这可以被多次触发, 因为通知可以通过 `show()` 方法多次显示.
+
+#### 事件: 'click'
+
+返回:
+
+* `event` 事件
+
+当用户点击通知时发出.
+
+#### 事件: 'close'
+
+返回:
+
+* `event` 事件
+
+当用户手动关闭通知时发出.
+
+在关闭所有通知的情况下，不能保证会发送此事件.
+
+#### 事件: 'reply' _macOS_
+
+返回:
+
+* `event` 事件
+* `reply` 字符串 - 用户输入到内联回复字段的字符串.
+
+当用户点击 `hasReply: true` 的通知上的 “回复” 按钮时发出.
+
+#### Event: 'action' _macOS_
+
+返回:
+
+* `event` 事件
+* `index` Number - The index of the action that was activated
+
+### 实例方法
+
+使用 `new Notification` 创建的对象具有以下实例方法:
+
+#### `notification.show()`
+
+立即向用户显示通知. 请注意这不同于 HTML5 Notification 的实现, 简单地实例化一个 `new Notification` 不会立即向用户显示, 你需要在操作系统显示之前调用此方法.
+
+### 播放声音
+
+在 macOS 上, 你可以在显示通知时指定要播放的声音的名称. 除了自定义声音文件, 可以使用任意默认声音 (在 “系统偏好设置” > “声音” 下) . 同时确保声音文件被复制到应用程序包下 (例如`YourApp.app/Contents/Resources`), 或以下位置之一:
+
+* `~/Library/Sounds`
+* `/Library/Sounds`
+* `/Network/Library/Sounds`
+* `/System/Library/Sounds`
+
+查看 [`NSSound`](https://developer.apple.com/documentation/appkit/nssound) 文档获取更多信息.