chrome.fileBrowserHandler

清单文件
实现文件浏览器处理程序
类型
1. FileHandlerExecuteEventDetails
方法
1. selectFile
事件
1. onExecute

描述：	使用 `chrome.fileBrowserHandler` API 扩展 Chrome OS 的文件浏览器。例如，您可以使用这一 API 让用户向您的网站上传文件。
可用版本：	从 Chrome 12 开始稳定支持。
权限：	"fileBrowserHandler"

重要提示：该 API 仅在 Chrome OS 中可用。

当用户按下 Ctrl+M 或连接外部存储设备，例如 SD 卡、USB 密钥、外部磁盘驱动器或数码相机时，Chrome OS 文件浏览器将会出现。除了显示外部设备中的文件，文件浏览器也会显示用户以前保存在系统中的文件。

当用户选定一个或多个文件时，文件浏览器中会出现代表这些文件的有效处理程序的按钮。例如，在如下的屏幕截图中，选定一个具有“.jpg”后缀的文件后将出现一个“上传到 Picasa”按钮，用户可以单击它

file browser screenshot

清单文件

您必须在扩展程序的清单文件中声明 "fileBrowserHandler" 权限，并且您必须使用 "file_browser_handler" 字段，将您的扩展程序注册为至少一种文件类型的处理程序，您还应该提供一个 16×16 像素的图标显示在按钮上。例如：

{
  "name": "我的扩展程序",
  ...
  "file_browser_handlers": [
    {
      "id": "upload",
      "default_title": "保存至照片库", // 按钮上显示的文字
      "file_filters": [
        "filesystem:*.jpg", // 要匹配所有文件，请使用 "filesystem:*.*"
        "filesystem:*.jpeg",
        "filesystem:*.png"
      ]
    }
  ],
  "permissions" : [
    "fileBrowserHandler"
  ],
  "icons": { "16": "icon16.png",
             "48": "icon48.png",
            "128": "icon128.png" },
  ...
}

注意：您可以在 "default_title" 的值中指定语言相关的字符串，有关细节请参见国际化支持（i18n）。

实现文件浏览器处理程序

要使用这一 API，您必须实现一个函数，处理 chrome.fileBrowserHandler 的 onExecute 事件。在用户单击了代表您的文件浏览器处理程序的按钮后，将会调用您的函数。在您的函数中，使用 HTML5 文件系统 API（英文）访问文件内容。例如：

chrome.fileBrowserHandler.onExecute.addListener(function(id, details) {
  if (id == 'upload') {
    var fileEntries = details.entries;
    for (var i = 0, entry; entry = fileEntries[i]; ++i) {
      entry.file(function(file) {
        // 将文件发送至某处
      });
    }
  }
});

您的事件处理函数将包含两个参数：

id: 来自清单文件的 "id" 值。如果您的扩展程序实现了多个处理程序，您可以检查 id 的值判断触发了哪一个处理程序。
details: 描述事件的对象。您可以从这一对象的 entries 属性中获得用户选定的文件，entries 属性为一个数组，包含文件系统 Entry 对象。