Nefarious Planetary Meddling
Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

nw-programmatic-folder-select

1.0.4 • Public • Published

nw-programmatic-folder-select

Build Status

Programmatically open a native "Folder select" dialog in NW.js.

Similar to <input type="file" nwdirectory> but with just JavaScript.

Windows Screenshot from NW.js 0.12.3 Windows Screenshot from NW.js 0.40.0 Ubuntu Screenshot from NW.js 0.40.0

Compatible with all versions of NW.js.

Version Tested
v0.12.3 ✔️
v0.14.7 ✔️
v0.40.0 ✔️

Installation

npm install --save nw-programmatic-folder-select

Basic Usage

const openFolderExplorer = require('nw-programmatic-folder-select');
// The window object, to have access to the browser context, and a callback function with the user's choice
openFolderExplorer(window, (selection) => { console.log(selection); });

Advanced Usage

const openFolderExplorer = require('nw-programmatic-folder-select');
 
const options = {
  // Optional string. The working directory to start in
  directory: 'C:\\',
  // Optional string. A custom title for the OS's folder selection dialog
  title: 'Select a folder to store the settings file in'
};
 
// Optional asynchronous callback function.
// Returns a string to the path, like 'C:\Users\Bob\Desktop', or undefined if no selection made
const callback = function (selection) {
  if (selection) {
    console.log('The user chose ' + selection);
  } else {
    console.log('The user cancelled the dialog.');
  }
}
 
// Window is required to have access to the browser context
// All other arguments are optional
openFolderExplorer(window, options, callback);

Install

npm i nw-programmatic-folder-select

DownloadsWeekly Downloads

132

Version

1.0.4

License

MIT

Unpacked Size

86.2 kB

Total Files

8

Last publish

Collaborators

  • avatar