Windows Store App JavaScript 开发：选取文件和文件夹

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

前面提到过，文件打开选取器由FileOpenPicker类表示，用于选取或打开文件，而文件夹选取器由FolderPicker类表示，用来选取文件夹。在FileOpenPicker类中，pickSingleFileAsync函数用于选取单个文件，pickMultipleFilesAsync函数用于选取多个文件；而FolderPicker类中只有一个pickSingleFolderAsync函数，用来选取单个文件夹。下面以一个应用程序为例来演示如何选取文件或文件夹。

新建一个JavaScript的Windows应用商店的空白应用程序项目，将其命名为FilePickerApplication。打开default.html文件，在body元素中定义两个div元素，并在第一个div元素中添加一个h2元素和两个按钮，其中，h2元素用于显示页面标题“使用文件选取器选取文件和文件夹”，两个按钮分别为“选取一个文件”和“选取一个文件夹”，“选取一个文件”按钮用来选取文件，“选取一个文件夹”按钮用来选取文件夹；在第二个div元素中添加一个p元素，用于显示提示信息。相应的HTML代码片段如下所示：

<body>

<div>

<h2 class="articleTitle">使用文件选取器选取文件和文件夹</h2>

<br />

<button class="action" id="pickFile">选取一个文件</button>

<button class="action" id="pickFolder">选取一个文件夹</button>

<br />

</div>

<div>

</div>

</body>

在上面的代码中，为了便于设计CSS样式和检索控件，在添加控件时为其设置了类名和ID。其中，设置h2元素的class属性值为articleTitle，“选取一个文件”和“选取一个文件夹”两个按钮的class属性值均为action；同时，设置这两个按钮和p元素的id属性值分别为pickFile、pickFolder和outputText。

为了控制应用程序界面的显示外观，在default.css文件中添加如下代码来设置default.html页面的外观。

/*设置h2元素的字体大小和在应用程序界面中的显示位置*/

.articleTitle {

font-size: x-large;

margin: 20px 15px 10px 30px;

}

/*设置class属性值为action的控件在界面中的显示位置*/

.action {

margin: 0px 15px 10px 57px;

}

/*设置p元素在界面中的显示位置*/

#outputText {

margin: 20px 15px 10px 30px;

}

完成前台界面的布局后，应用程序界面效果如图19-13所示。

图19-13 前台界面效果图

布局好前台界面后，接下来介绍如何实现选取一个文件和一个文件夹。打开default.js文件，在“args.setPromise(WinJS.UI.processAll());”语句后添加如下代码，为“选取一个文件”按钮和“选取一个文件夹”按钮注册click事件处理函数。

document.getElementById("pickFile").addEventListener("click", PickSingleDocument);

document.getElementById("pickFolder").addEventListener("click", PickSingleFolder);

首先以“pickFile”为参数调用document对象的getElementById函数来查找id属性值为pickFile的元素对象，并使用addEventListener函数为该元素对象的click事件注册事件处理函数PickSingleDocument，接着通过相同的方法为id属性值为pickFolder的元素对象注册click事件处理函数PickSingleFolder。下面分别来看一下事件处理函数PickSingleDocument和PickSingleFolder的实现代码。

PickSingleDocument函数用来处理“选取一个文件”按钮的单击事件，实现从文件系统中选取一个文件。该函数的代码添加在default.js文件的“app.onactivated = function (args) {...};”语句后，相应的JavaScript代码片段如下所示：

function PickSingleDocument() {

//判断应用程序是否能够显示文件选取器

var currentState = Windows.UI.ViewManagement.ApplicationView.value;

if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&

!Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {

return;

}

//定义一个FileOpenPicker类型的对象

var filePicker = new Windows.Storage.Pickers.FileOpenPicker();

//设置文件选取器的视图模式

filePicker.viewMode = Windows.Storage.Pickers.PickerViewMode.list;

//设置文件选取器的起始位置为文档库

filePicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.documentsLibrary;

//设置文件类型筛选

filePicker.fileTypeFilter.replaceAll([".txt", ".doc", ".docx"]);

//调用pickSingleFileAsync函数从文件选取器中选取文件

filePicker.pickSingleFileAsync().then(function (file) {

//针对操作结果给出相应的提示信息

if (file) {

// 文件选取成功时显示文件的名称

outputText.innerText = "选取的文档是: " + file.name;

} else {

//在文件选取器界面中，未选取任何文件就取消了操作

outputText.innerText = "没有选取文件，操作取消了！";

}

});

}

在上面的代码中，首先通过Windows.UI.ViewManagement.ApplicationView.value获取应用程序的当前状态，如果应用程序正处于贴靠状态而且尝试取消贴靠失败，那么就不能显示文件选取器，程序停止向下执行；否则新建一个FileOpenPicker类的对象filePicker作为文件选取器，并通过viewMode属性和suggestedStartLocation属性分别设置文件选取器的视图模式为列表模式、起始位置为文档库，同时使用fileTypeFilter属性中的replaceAll函数设置文件选取器中可显示的文件类型，本示例包括.txt、.doc、和.docx文件；最后调用filePicker对象的pickSingleFileAsync函数通过文件选取器选取文件，pickSingleFileAsync函数调用完成之后定义一个匿名函数，在匿名函数中对参数file进行判断，如果file不是空对象，说明成功地选取了一个文件，则在应用程序界面中显示选取的文件，如果file为空对象，说明没有选取到文件，则在应用程序界面中显示“没有选取文件，操作取消了！”。

PickSingleFolder函数用来处理“选取一个文件夹”按钮的单击事件，实现从文件系统中选取一个文件夹。该函数的代码添加在PickSingleDocument函数后，相应的代码片段如下所示：

function PickSingleFolder() {

// 首先判断应用程序是否能够显示文件选取器

var currentState = Windows.UI.ViewManagement.ApplicationView.value;

if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&

!Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {

return;

}

// 定义一个FolderPicker类型的对象

var folderPicker = new Windows.Storage.Pickers.FolderPicker;

//设置文件选取器的起始位置为桌面

folderPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.desktop;

//设置文件类型筛选

folderPicker.fileTypeFilter.replaceAll([".docx", ".doc", ".xlsx", ".pptx"]);

//调用pickSingleFolderAsync函数从文件选取器中选取文件夹

folderPicker.pickSingleFolderAsync().then(function (folder) {

//针对操作结果，给出相应的提示信息

if (folder) {

//文件夹选取成功时，显示文件夹的名称

outputText.innerText = "选取的文件夹是: " + folder.name;

} else {

//在文件选取器界面中，未选取任何文件夹就取消了操作

outputText.innerText = "没有选取文件夹，操作取消了！";

}

});

}

该函数的代码实现与PickSingleFolder函数很相似，同样是首先通过Windows.UI.ViewManagement.ApplicationView.value获取应用程序的当前状态，并对其进行检查，如果应用程序正处于贴靠状态而且尝试取消贴靠失败，那么就不能显示文件选取器，程序停止向下执行；否则新建一个FolderPicker类的对象folderPicker作为文件选取器，并通过suggestedStartLocation属性设置文件选取器的起始位置为桌面，同时使用fileTypeFilter属性中的replaceAll函数设置文件选取器中可显示的文件类型，本示例包括.docx、.doc、.xlsx和.pptx文件；最后调用folderPicker对象的pickSingleFolderAsync函数通过文件选取器选取文件夹，pickSingleFolderAsync函数调用完成之后定义一个匿名函数，在匿名函数中对参数folder进行判断，如果folder不是空对象，说明成功地选取了一个文件夹，那么在应用程序界面中显示所选取的文件夹，如果folder是空对象，说明没有选取到文件夹，则在应用程序界面中显示“没有选取文件夹，操作取消了！”。

启动调试，单击“选取一个文件”按钮，将显示文件选取器窗口，如图19-14所示，可以看到，起始位置为文档库，而且“打开”按钮是灰色的，表示现在不可用。假设想选取桌面上的“多媒体.docx”文件，那么单击“文件”旁边的下拉符号，在下拉列表中选择“桌面”，在项目列表位置就会显示桌面上的内容，然后选中文档“多媒体.docx”，这时“打开”按钮变为可用，单击它就选取了这个文档，得到的效果如图19-15所示。

单击“选取一个文件夹”按钮，此时文件选取器的界面与图19-14中的稍有不同，起始位置是桌面，“打开”按钮换成了“选择这个文件夹”按钮。假设想选取桌面上的“Demo”文件夹，那么选中它，然后单击“选择这个文件夹”按钮，“Demo”文件夹就会显示在文件选取器界面的底端，这时“选择这个文件夹”按钮变成了“确定”按钮，最后单击“确定”按钮回到应用程序界面，得到的效果如图19-16所示。

图19-14 文件选取器界面

图19-15 选取文件的效果

图19-16选取文件夹的效果

如果在文件选取器界面中未选取任何文件或文件夹就单击“取消”按钮结束了操作，那么应用程序界面中会显示提示信息“没有选取文件，操作取消了！”或“没有选取文件夹，操作取消了！”。