dialog模块

dialog模块提供了api来展示原生的系统对话框，例如打开文件框，alert框，所以web应用可以给用户带来跟系统应用相同的体验.

对话框例子，展示了选择文件和目录:

var win = ...;  // BrowserWindow in which to show the dialog
const dialog = require('electron').dialog;
console.log(dialog.showOpenDialog({ properties: 
[ 'openFile', 'openDirectory', 'multiSelections' ]}));

OS X 上的注意事项: 如果你想像sheets一样展示对话框，只需要在browserWindow参数中提供一个BrowserWindow的引用对象.

方法

dialog模块有以下方法:

dialog.showOpenDialog([browserWindow, ]options[, callback])

成功使用这个方法的话，就返回一个可供用户选择的文件路径数组，失败返回undefined.

filters当需要限定用户的行为的时候，指定一个文件数组给用户展示或选择. 例如:

{
  filters: [
    { name: 'Images', extensions: ['jpg', 'png', 'gif'] },
    { name: 'Movies', extensions: ['mkv', 'avi', 'mp4'] },
    { name: 'Custom File Type', extensions: ['as'] },
   { name: 'All Files', extensions: ['*'] }
  ]
}

extensions数组应当只包含扩展名，不应该包含通配符或'.'号 (例如'png'正确，但是'.png'和'.png'不正确). 展示全部文件的话, 使用''通配符 (不支持其他通配符).

如果callback被调用, 将异步调用 API ，并且结果将用过callback(filenames)展示.

注意:在 Windows 和 Linux ，一个打开的 dialog 不能既是文件选择框又是目录选择框, 所以如果在这些平台上设置properties的值为['openFile', 'openDirectory'], 将展示一个目录选择框.

dialog.showSaveDialog([browserWindow, ]options[, callback])

成功使用这个方法的话，就返回一个可供用户选择的文件路径数组，失败返回undefined.

filters指定展示一个文件类型数组, 例子dialog.showOpenDialog.

如果callback被调用, 将异步调用 API ，并且结果将用过callback(filenames)展示.

dialog.showMessageBox([browserWindow, ]options[, callback])

展示 message box, 它会阻塞进程，直到 message box 关闭为止.返回点击按钮的索引值.

如果callback被调用, 将异步调用 API ，并且结果将用过callback(response)展示.

dialog.showErrorBox(title, content)

展示一个传统的包含错误信息的对话框.

+

在app模块触发ready事件之前，这个 api 可以被安全调用，通常它被用来在启动的早期阶段报告错误.

在 Linux 上，如果在app模块触发ready事件之前调用，message 将会被触发显示stderr，并且没有实际GUI 框显示.

可使用的修饰符

可使用的键盘符