diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index dc27074b626b6a..9e99bb68291e56 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -1,41 +1,40 @@ --- title: FileSystem slug: Web/API/FileSystem +l10n: + sourceCommit: 0c3f18aca2c8a93d3982183f64bf7762c2c310b0 --- -{{APIRef("File System API")}} {{non-standard_header}} +{{APIRef("File and Directory Entries API")}} -**`FileSystem`** 實作文件和目錄介面,描述一個檔案系統。在任何檔案系統上,這個物件包含 {{domxref("FileSystemEntry.filesystem", "filesystem")}}的特性。某些網頁瀏覽器提供額外的 API 去創建和管理檔案系統,如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 +檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 {{domxref("FileSystemEntry.filesystem", "filesystem")}} 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統,例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 -> [!NOTE] -> 此介面並非標準 API, 代表規格並未依造標準制定, 因此必須注意並非所有網頁瀏覽器都有實作此介面, 有實作的網頁瀏覽器可能只有實作一小部分. 請在[Browser compatibility](#browser_compatibility) 查看更多細節. +此介面並不會讓你直接存取使用者電腦的檔案系統,而是在瀏覽器的沙盒內建立一個「虛擬磁碟」讓你操作。如果要直接操作使用者的檔案系統,需要向使用者請求,像是安裝 Google Chrome 擴充功能之類的。相關的 Chrome API 可[在此](https://developer.chrome.com/docs/apps/reference/fileSystem)找到。 ## 基礎概念 -存取 `FileSystem` 物件的兩種方法: +存取 `FileSystem` 物件的兩種方法: -1. 你可以直接要求一個使用`window.requestFileSystem(),`只用在你的網頁應用程式的沙盒類型 `FileSystem 物件。如果要求成功,將會執行`callback handler 去接收描述檔案系統的`FileSystem物件參數。` -2. 你可以從檔案系統接口物件取得,透過他的{{domxref("FileSystemEntry.filesystem", "filesystem")}}特性 +1. 你可以呼叫 `window.requestFileSystem()`,為你的網頁應用程式建立一個檔案系統的沙盒。如果呼叫成功,將會執行回呼函式,該回呼函式會有個 `FileSystem` 參數來描述檔案系統。 +2. 從檔案系統項目物件的 {{domxref("FileSystemEntry.filesystem", "filesystem")}} 屬性中取得。 -## 屬性 +## 實例屬性 - {{domxref("FileSystem.name")}} {{ReadOnlyInline}} - - : {{domxref("USVString")}} 代表檔案系統的名稱. 此名稱在整個已宣告的檔案系統清單中是唯一的。 + - : 代表檔案系統名稱的字串。此名稱在整個檔案的清單中是唯一的。 - {{domxref("FileSystem.root")}} {{ReadOnlyInline}} - - : {{domxref("FileSystemDirectoryEntry")}} 物件表示檔案系統的根目錄。 透過此物件, 你可以取得權限存取所有檔案系統中的文件和目錄 + - : 為一個 {{domxref("FileSystemDirectoryEntry")}} 物件,用來表示檔案系統的根目錄。透過此物件,你可以取得檔案系統中的所有的檔案與目錄。 ## 規範 {{Specifications}} -This API has no official W3C or WHATWG specification. - ## 瀏覽器相容性 {{Compat}} ## 參見 -- [File and Directory Entries API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API) -- [Introduction to the File System API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API/Introduction) -- {{domxref("FileSystemEntry")}}, {{domxref("FileSystemFileEntry")}}, and {{domxref("FileSystemDirectoryEntry")}} +- [檔案與目錄 API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API) +- [檔案與目錄 API 介紹](/zh-TW/docs/Web/API/File_and_Directory_Entries_API/Introduction) +- {{domxref("FileSystemEntry")}}、{{domxref("FileSystemFileEntry")}}、{{domxref("FileSystemDirectoryEntry")}}