Zum Hauptteil springen

Kürzliche Dokumente

Übersicht​

Windos und macOS bieten die Möglichkeit für Apps, die zuletzt geöffneten Dateien in der Taskbar per JumpList oder dock menu anzuzeigen.

JumpList:

JumpList Zuletzt geöffnete Dateien

Dock Menu einer Anwendung:

macOS Dock Menü

Beispiel​

Verwalten von zuletzt verwendeten Dokumenten​

docs/fiddles/features/recent-documents (25.0.0)Open in Fiddle
const { app, BrowserWindow } = require('electron')
const fs = require('fs')
const path = require('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()
  }
})

Ein kürzlich verwendetes Dokument hinzufügen​

To add a file to recent documents, use the app.addRecentDocument API.

After launching the Electron application, right click the application icon. In this guide, the item is a Markdown file located in the root of the project. You should see recently-used.md added to the list of recent files:

Recent document

Liste der kürzlich verwendeten Dokumente löschen​

Um die Liste der zuletzt verwendeten Dokumente zu löschen, verwende die app.clearRecentDocuments-API. In diesem Leitfaden wird die Liste der Dokumente gelöscht, sobald alle Fenster geschlossen wurden.

Additional information​

Bemerkungen zu Windows​

Um diese Funktion unter Windows nutzen zu können, muss deine Anwendung als Handler für den Dateityp des Dokuments registriert sein, sonst erscheint die Datei in JumpList nicht, auch wenn du sie hinzugefügt hast. You can find everything on registering your application in Application Registration.

Sobald ein Nutzer auf eine Datei in der JumpList klickt, wird eine neue Instanz Ihrer Anwendung gestartet mit dem Pfad der Datei als Befehlszeilenargument.

Bemerkungen zu macOS​

Hinzufügen der "kürzlich verwendeten Dokumente"-Liste zum Anwendungsmenü​

Du kannst Menüpunkte hinzufügen, um auf die kürzlich verwendeten Dokumente zuzugreifen und sie zu löschen, indem du den folgenden Codeschnipsel zu deiner Menüvorlage hinzufügst:

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

Stelle sicher, dass das Anwendungsmenü nach dem Ereignis 'ready' hinzugefügt wird und nicht vor dem Ereignis, sonst wird der Menüeintrag wird deaktiviert:

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

Sobald eine Datei vom Menu der zuletzt hinzugefügten Dateien angefordert wird, so wird dafür das open-file-Event des app-Moduls ausgeworfen.