メインコンテンツへ飛ぶ

最近使用したドキュメント

概要​

Windows と macOS は、それぞれジャンプリストまたは Dock メニューを介して、アプリケーションによって開かれた最近の書類のリストへのアクセスを提供します。

ジャンプリスト:

ジャンプリストの最近使った書類

アプリケーションの Dock メニュー:

macOS の Dock メニュー

サンプル​

最近開いた書類の管理​

docs/fiddles/features/recent-documents (33.2.1)Open in 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 が追加されているはずです。

最近使った書類

最近開いた書類の消去​

最近開いた書類のリストを消去するには、app.clearRecentDocuments API を使用します。 このガイドでは、すべてのウインドウを閉じた時点でその書類のリストは消去されます。

さらなる情報​

Windows での注意​

Windows でこの機能を使用する際にアプリケーションが書類のファイルタイプのハンドラとして登録されていない場合、ファイルを追加してもジャンプリストに表示されません。 アプリケーションの登録については、Application Registration にすべて記載されています。

ユーザーがジャンプリストからファイルをクリックすると、アプリケーションの新しいインスタンスが、ファイルのパスがコマンドライン引数として追加されて起動されます。

macOS での注意​

アプリケーションメニューに最近開いた書類を追加する​

以下のコードスニペットをメニューテンプレートに追加することで、最近開いた書類にアクセスしたり消去したりするメニュー項目を追加できます。

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

以下のようにアプリケーションメニューを 'ready' イベントより後に追加し、それより前では追加しないようにしてください。さもなくばメニューアイテムは無効になります。

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

const template = [
  // メニューテンプレートをこちらに
]
const menu = Menu.buildFromTemplate(template)

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

macOS 最近使った書類のメニューアイテム

最近使った書類メニューからファイルが要求されると、それに対して app モジュールの open-file イベントが発生します。