最近文档 (Windows & macOS)

Windows 和 macOS 分别通过打开跳转列表和dock菜单使应用程序能够快速的访问最近打开的文档列表。

JumpList:

跳转列表最近的文件

应用 dock 菜单

macOS Dock 菜单

若要增加一个文件到最近文件列表,你可以使用app.addRecentDocument API:

  1. const { app } = require('electron')
  2. app.addRecentDocument('/Users/USERNAME/Desktop/work.type')

你也可以使用 app.clearRecentDocuments API 来清空最近文件列表。

  1. const { app } = require('electron')app.clearRecentDocuments', () = { ()
  2. })

Windows 注意事项

为了在 Windows 上使用这个特性,你的应用需要被注册为这类文件的处理程序,否则,在你注册之前,文件是不会出现在跳转列表里的。 你可以在 Application Registration.aspx) 里找到所有关于注册事宜的说明。

当用户点击“跳转列表”上的一个文件时,系统会启动一个新的应用程序的实例 ,而文件的路径将作为一个命令行参数被传入这个实例。

macOS 注意事项

Adding the Recent Documents list to the application menu:

macOS Recent Documents menu item

You can add menu items to access and clear recent documents by adding the following code snippet to your menu’s template.

  1. {
  2. "submenu":[
  3. {
  4. "label":"Open Recent",
  5. "role":"recentdocuments",
  6. "submenu":[
  7. {
  8. "label":"Clear Recent",
  9. "role":"clearrecentdocuments"
  10. }
  11. ]
  12. }
  13. ]
  14. }

从 “最近文档” 菜单中请求文件时, 将为其发出 app 模块的 open-file 事件。