|
|
@@ -13,39 +13,62 @@ __Application dock menu:__
|
|
|
|
|
|
![macOS Dock Menu][dock-menu-image]
|
|
|
|
|
|
-To add a file to recent documents, you need to use the
|
|
|
-[app.addRecentDocument][addrecentdocument] API.
|
|
|
-
|
|
|
## Example
|
|
|
|
|
|
-### Add an item to recent documents
|
|
|
-
|
|
|
-Starting with a working application from the
|
|
|
-[Quick Start Guide](quick-start.md), add the following lines to the
|
|
|
-`main.js` file:
|
|
|
+### Managing recent documents
|
|
|
|
|
|
```javascript fiddle='docs/fiddles/features/recent-documents'
|
|
|
-const { app } = require('electron')
|
|
|
+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.addRecentDocument('/Users/USERNAME/Desktop/work.type')
|
|
|
+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()
|
|
|
+ }
|
|
|
+})
|
|
|
```
|
|
|
|
|
|
-After launching the Electron application, right click the application icon.
|
|
|
-You should see the item you just added. In this guide, the item is a Markdown
|
|
|
-file located in the root of the project:
|
|
|
+#### Adding a recent document
|
|
|
|
|
|
-
|
|
|
+To add a file to recent documents, use the
|
|
|
+[app.addRecentDocument][addrecentdocument] API.
|
|
|
|
|
|
-### Clear the list of recent documents
|
|
|
+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:
|
|
|
|
|
|
-To clear the list of recent documents, you need to use
|
|
|
-[app.clearRecentDocuments][clearrecentdocuments] API in the `main.js` file:
|
|
|
+
|
|
|
|
|
|
-```javascript
|
|
|
-const { app } = require('electron')
|
|
|
+#### Clearing the list of recent documents
|
|
|
|
|
|
-app.clearRecentDocuments()
|
|
|
-```
|
|
|
+To clear the list of recent documents, use the
|
|
|
+[app.clearRecentDocuments][clearrecentdocuments] API.
|
|
|
+In this guide, the list of documents is cleared once all windows have been
|
|
|
+closed.
|
|
|
|
|
|
## Additional information
|
|
|
|
Kevin Hartman
