## 目录
* 10.1 File dialogs简介
* 10.2 打开一个文件对话框
* 10.3 多文件选择对话框
* 10.4 文件类型过滤
* 10.5 选择文件夹
* 10.6 保存文件对话框
* 10.7 FileList8
* 10.8 指定默认路径
* 10.9 小结
## 10.1 File dialogs简介
文件操作是桌面应用最常使用的功能之一，相应的打开或保存文件的文件对话框也是最常用的组件之一。
在html中，我们可以通过
~~~
<input type='file' />
~~~
去打开文件对话框，上传文件到服务端。但是html中的文件对话框对于桌面应用来说，显然是不够的，没有办法知道文件的来源，不能保存文件到本地等。
node-wekit对html的文件对话框做了扩展，本文将对这些特性做详细的说明。下面创建示例应用。
新建dialog.html 和package.json作为本文的示例程序的原型。
dialog.html内容如下：
~~~
<html>
<head>
<title>dialogDemo</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>
<body >
<h1>dialog 测试</h1>
<script>
// Load native UI library
var gui = require('nw.gui');
var win = gui.Window.get();
</script>
</body>
</html>
~~~
package.json内容如下：
~~~
{
"name": "dialog-demo",
"main": "dialog.html",
"nodejs":true,
"window": {
"title": "dialogDemo",
"toolbar": true,
"width": 800,
"height": 600,
"resizable":true,
"show_in_taskbar":true,
"frame":true,
"kiosk":false,
"icon": "2655716405282662783.png"
},
"webkit":{
"plugin":true
}
}
~~~
## 10.2 打开一个文件对话框
修改dialog.html如下：
~~~
<html>
<head>
<title>dialogDemo</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>
<body >
<h1>dialog 测试</h1>
<input id="fileDialog" type="file" />
<script>
var chooser = document.querySelector('#fileDialog');
chooser.addEventListener("change", function (evt) {
apendText(this.value);
}, false);
function apendText(text) {
var element = document.createElement('div');
element.appendChild(document.createTextNode(text));
document.body.appendChild(element);
}
</script>
</body>
</html>
~~~
首先，在代码中添加了“file”类型的input标签。
~~~
<input id="fileDialog" type="file" />
~~~
这就是一个普通的文件选择框，在script中，我们添加对改选择框的选择文件之后的事件监听代码，获取选择文件的路径。
~~~
var chooser = document.querySelector('#fileDialog');
chooser.addEventListener("change", function (evt) {
apendText(this.value);
}, false);
~~~
运行效果如下：
## 10.3 多文件选择对话框
若要支持文件选择框支持多文件，只需要在input标签内添加“`multiple` ”属性即可，这是html5支持的属性。
~~~
<input id="fileDialog" type="file" multiple />
~~~
此时input的value值为所有文件的路径，以分号分隔。运行效果如下：
## 10.4 文件类型过滤
使用accept属性来过滤需要的文件类型，如：
~~~
<input id="fileDialog" type="file" multiple accept=".html"/>
~~~
## 10.5 选择文件夹
选择文件夹，而不是文件，在桌面应用中更有用，因为我们可以通过后端程序(node.js)进行文件遍历。
使用nwdirectory属性，可以是input支持选择文件夹。
~~~
<input id="fileDialog" type="file" nwdirectory />
~~~
运行效果如下：
## 10.6 保存文件对话框
当我们想要把某些内容保存到文档，保存文件对话框就十分重要了，当然这也是传统浏览器应用不具备的功能。
使用`nwsaveas` 属性可以启动保存文件对话框。
~~~
<input id="fileDialog" type="file" nwsaveas />
~~~
运行结果如下：
可以设置默认文件名，如：
~~~
<input id="fileDialog" type="file" nwsaveas="aa.txt"/>
~~~
## 10.7 FileList
在前面我们通过input标签的value属性获取选择的文件，Html5提供了`files` 属性，可以遍历文件。
修改示例程序的script，如下：
~~~
<script>
var chooser = document.querySelector('#fileDialog');
chooser.addEventListener("change", function (evt) {
var files = this.files;
for (var i = 0; i < files.length; ++i)
apendText(files[i].name);
}, false);
function apendText(text) {
var element = document.createElement('div');
element.appendChild(document.createTextNode(text));
document.body.appendChild(element);
}
</script>
~~~
运行结果如下：
在上图中，我们看到程序输出了选择的文件名，但是并没有完整的路径。node-webkit，扩展了一个名为path的属性，通过这个属性，可以获取完整的文件路径。继续修改代码：
~~~
for (var i = 0; i < files.length; ++i)
apendText(files[i].path);
~~~
运行结果如下：
## 10.8 指定默认路径
很多时候，我们需要引导用户从指定的目录打开或者保存文件，比如用户的文档目录，通过nwworkingdir属性可以完成这一需求。
修改input标签如下：
~~~
<input id="fileDialog" type="file" nwworkingdir="D:\xuanhunfile" />
~~~
在应用中打开文件对话框，会从指定目录开始。
## 10.9 小结
本文内容主要参考node-webkit的官方英文文档，做了适当的调整（[https://github.com/rogerwang/node-webkit/wiki/File-dialogs](https://github.com/rogerwang/node-webkit/wiki/File-dialogs)）。
下一篇文章，介绍shell。
- 1.中文WIKI
- 1.1支持列表
- 1.2开始nw.js
- 1.3package.json
- 2.中文教程
- 2.1node-webkit学习(1)hello world
- 2.2node-webkit学习(2)基本结构和配置
- 2.3node-webkit学习(3)Native UI API概览
- 2.4node-webkit学习(4)Native UI API 之window
- 2.5node-webkit教程(5)Native UI API 之Frameless window
- 2.6node-webkit教程(6)Native UI API 之Menu(菜单)
- 2.7node-webkit教程(7)Platform Service之APP
- 2.8node-webkit教程(8)Platform Service之Clipboard
- 2.9node-webkit教程(9)native api 之Tray(托盘)
- 2.10node-webkit教程(10)Platform Service之File dialogs
- 2.11node-webkit教程(11)Platform Service之shell
- 2.12node-webkit教程(12)全屏
- 2.13node-webkit教程(13)gpu支持信息查看
- 2.14node-webkit教程(14)禁用缓存
- 2.15node-webkit教程(15)当图片加载失败的时候
- 2.16node-webkit教程(16)调试typescript