Aller au contenu principal

Documents récents

Vue d'ensemble

Windows et macOS permettent d’accéder facilement à la liste des documents récemment ouverts par l'application respectivement via JumpList ou dock menu.

JumpList :

JumpList fichiers récents

Menu application du dock :

Dock de macOS

Example

Gestiçon des documents récents

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()
}
})

Ajout d'un document récent

Utilisez l'API app.addRecentDocument pour ajouter un fichier aux documents récents .

After launching the Electron application, right click the application icon. Dans ce guide, l'élément est un fichier Markdown situé à la racine du projet. Vous devriez voir recently-used.md ajouté à la liste des fichiers récents :

Document récent

Effacement de la liste des documents récents

Pour effacer la liste des documents récents, utilisez l'API app.clearRecentDocuments. Dans ce guide, la liste des documents est effacée lorsque toutes les fenêtres ont été fermées.

Additional information

Remarques Windows

Pour utiliser cette fonctionnalité sur Windows, votre application doit être enregistrée en tant que gestionnaire/responsable du type de fichier du document, sinon le fichier n’apparaîtra pas dans la JumpList même après l'avoir ajouté. Vous trouverez tout l'enregistrement de votre application dans Enregistrement de l'application.

Lorsqu’un utilisateur clique sur un fichier à partir de la JumpList, cela démarre une nouvelle instance de votre application avec le chemin d’accès du fichier ajouté comme un argument de ligne de commande.

Remarques macOS

Ajouter la liste des Documents récents au menu de l'application

Vous pouvez ajouter des éléments de menu pour accéder et supprimer les documents récents en ajoutant le code suivant à votre template de menu :

{
"submenu":[
{
"label":"Ouvrir récent",
"role":"recentdocuments",
"submenu":[
{
"label":"Effacer récent",
"role":"clearrecentdocuments"
}
]
}
]
}

Assurez-vous que le menu de l'application soit ajouté après l'événement 'ready' et pas avant, ou l'élément de menu sera désactivé :

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

const template = [
// Modèle de Menu
]
const menu = Menu.buildFromTemplate(template)

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

élément de menu Documents récents macOS

Lorsqu’un fichier est demandé dans le menu documents récents, l’événement open-file du module app sera émit.