跳至主要内容

最近文件

概述​

Windows 和 macOS 分别通过 JumpList 或 Dock 菜单提供对应用程序打开的最近文档列表的访问。

JumpList

JumpList Recent Files

应用程序 Dock 菜单

macOS Dock Menu

示例​

管理最近文档​

docs/fiddles/features/recent-documents (33.0.1)在 Fiddle 中打开
const { app, BrowserWindow } = require('electron/main')
const fs = require('node:fs')
const path = require('node:path')

function createWindow () {
  const win = new BrowserWindow({
    width: 800,
    height: 600
  })

  win.loadFile('index.html')
}

const fileName = 'recently-used.md'
fs.writeFile(fileName, 'Lorem Ipsum', () => {
  app.addRecentDocument(path.join(__dirname, fileName))
})

app.whenReady().then(createWindow)

app.on('window-all-closed', () => {
  app.clearRecentDocuments()
  if (process.platform !== 'darwin') {
    app.quit()
  }
})

app.on('activate', () => {
  if (BrowserWindow.getAllWindows().length === 0) {
    createWindow()
  }
})

添加最近文档​

要将文件添加到最近文档中，请使用 app.addRecentDocument API。

启动 Electron 应用程序后，右键单击应用程序图标。在本指南中，该项是位于项目根目录中的 Markdown 文件。您应该看到 recently-used.md 已添加到最近文件列表中。

Recent document

清除最近文档列表​

要清除最近文档列表，请使用 app.clearRecentDocuments API。在本指南中，一旦所有窗口都关闭，文档列表就会被清除。

其他信息​

Windows 说明​

要在 Windows 上使用此功能，您的应用程序必须注册为文档文件类型的处理程序，否则即使您添加了该文件，它也不会出现在 JumpList 中。您可以在 应用程序注册 中找到有关注册应用程序的所有内容。

当用户从 JumpList 中点击一个文件时，您的应用程序的新实例将启动，并添加文件的路径作为命令行参数。

macOS 说明​

将最近文档列表添加到应用程序菜单​

您可以通过将以下代码片段添加到菜单模板中来添加菜单项以访问和清除最近文档。

{
  "submenu":[
    {
      "label":"Open Recent",
      "role":"recentdocuments",
      "submenu":[
        {
          "label":"Clear Recent",
          "role":"clearrecentdocuments"
        }
      ]
    }
  ]
}

确保在 'ready' 事件之后添加应用程序菜单，而不是之前，否则菜单项将被禁用。

const { app, Menu } = require('electron')

const template = [
  // Menu template here
]
const menu = Menu.buildFromTemplate(template)

app.whenReady().then(() => {
  Menu.setApplicationMenu(menu)
})

macOS Recent Documents menu item

当从最近文档菜单请求文件时，app 模块的 open-file 事件将为此文件发出。