Merge pull request #5332 from Stone-Jay/patch-7

Update desktop-environment-integration.md (zh-CN)
This commit is contained in:
Cheng Zhao 2016-04-29 08:22:26 +09:00
commit c2833274bf

View file

@ -3,6 +3,47 @@
本章将会说明怎样使用 Electron APIs 把你的应用和桌面环境集成到一块。
## Notifications (Windows, Linux, OS X)
这三个操作系统都为用户提供了发送通知的方法。Electron让开发人员通过
[HTML5 Notification API](https://notifications.spec.whatwg.org/)
便利的去发送通知用操作系统自带的通知APIs去显示。
**Note:** 因为这是一个HTML5API所以只在渲染进程中起作用
```javascript
var myNotification = new Notification('Title', {
body: 'Lorem Ipsum Dolor Sit Amet'
});
myNotification.onclick = function () {
console.log('Notification clicked')
}
```
尽管代码和用户体验在不同的操作系统中基本相同,但还是有一些差异。
### Windows
* 在Windows 10上, 通知"可以工作".
* 在Windows 8.1和Windows 8系统下你需要将你的应用通过一个[Application User
Model ID][app-user-model-id]安装到开始屏幕上。需要注意的是,这不是将你的应用固定到开始屏幕。
* 在Windows 7以及更低的版本中通知不被支持。不过你可以使用[Tray API][tray-balloon]发送一个"气泡通知"。
此外通知支持的最大字符长队为250。Windows团队建议通知应该保持在200个字符以下。
### Linux
通知使用`libnotify`发送,它能在任何支持[Desktop Notifications
Specification][notification-spec]的桌面环境中显示,包括 Cinnamon, Enlightenment, Unity,
GNOME, KDE。
### OS X
在OS X系统中通知是直接转发的你应该了解[Apple's Human Interface guidelines regarding notifications](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)。
注意通知被限制在256个字节以内如果超出则会被截断。
## 最近文档 (Windows & OS X)
Windows 和 OS X 提供获取最近文档列表的便捷方式,那就是打开跳转列表或者鱼眼菜单。
@ -165,3 +206,17 @@ window.setDocumentEdited(true);
[16]: https://cloud.githubusercontent.com/assets/639601/5082061/670a949a-6f14-11e4-987a-9aaa04b23c1d.png
[17]: https://github.com/electron/electron/blob/master/docs-translations/zh-CN/api/browser-window.md
[18]: https://github.com/electron/electron/blob/master/docs-translations/zh-CN/api/browser-window.md
[addrecentdocument]: ../api/app.md#appaddrecentdocumentpath-os-x-windows
[clearrecentdocuments]: ../api/app.md#appclearrecentdocuments-os-x-windows
[setusertaskstasks]: ../api/app.md#appsetusertaskstasks-windows
[setprogressbar]: ../api/browser-window.md#winsetprogressbarprogress
[setoverlayicon]: ../api/browser-window.md#winsetoverlayiconoverlay-description-windows-7
[setrepresentedfilename]: ../api/browser-window.md#winsetrepresentedfilenamefilename-os-x
[setdocumentedited]: ../api/browser-window.md#winsetdocumenteditededited-os-x
[app-registration]: http://msdn.microsoft.com/en-us/library/windows/desktop/ee872121(v=vs.85).aspx
[unity-launcher]: https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles#Adding_shortcuts_to_a_launcher
[setthumbarbuttons]: ../api/browser-window.md#winsetthumbarbuttonsbuttons-windows-7
[tray-balloon]: ../api/tray.md#traydisplayballoonoptions-windows
[app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx
[notification-spec]: https://developer.gnome.org/notification-spec/