From 5b5f9549f8cee0ec171ca9bdbc064f60166add90 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Tue, 13 Aug 2024 09:48:40 +0800 Subject: [PATCH 01/12] Update index.md --- files/zh-tw/web/api/filesystem/index.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index d65ebb304456ee..67e17fef6e65d8 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -7,9 +7,6 @@ slug: Web/API/FileSystem **`FileSystem`** 實作文件和目錄介面，描述一個檔案系統。在任何檔案系統上，這個物件包含 {{domxref("FileSystemEntry.filesystem", "filesystem")}}的特性。某些網頁瀏覽器提供額外的 API 去創建和管理檔案系統，如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 -> [!NOTE] -> 此介面並非標準 API, 代表規格並未依造標準制定, 因此必須注意並非所有網頁瀏覽器都有實作此介面, 有實作的網頁瀏覽器可能只有實作一小部分. 請在[Browser compatibility](#browser_compatibility) 查看更多細節. - ## 基礎概念 存取 `FileSystem` 物件的兩種方法: @@ -36,7 +33,6 @@ This API has no official W3C or WHATWG specification. ## 參見 -- [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")}} -- MSDN 文章: [WebKitFileSystem object](https://msdn.microsoft.com/library/mt732564) +- [檔案與目錄 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")}} From 15131cd1ddf8e7daa5387248567ed52876b6b146 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Thu, 15 Aug 2024 09:16:59 +0800 Subject: [PATCH 02/12] remove {{non-standard_header}} --- files/zh-tw/web/api/filesystem/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 67e17fef6e65d8..d1e5fc23743434 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -3,8 +3,7 @@ title: FileSystem slug: Web/API/FileSystem --- -{{APIRef("File System API")}} {{non-standard_header}} - +{{APIRef("File System API")}} **`FileSystem`** 實作文件和目錄介面，描述一個檔案系統。在任何檔案系統上，這個物件包含 {{domxref("FileSystemEntry.filesystem", "filesystem")}}的特性。某些網頁瀏覽器提供額外的 API 去創建和管理檔案系統，如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 ## 基礎概念 From d491dbf80f8fdf9f5175c2d6c62aefb7cc1b6295 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Thu, 15 Aug 2024 09:17:50 +0800 Subject: [PATCH 03/12] =?UTF-8?q?remove=20=E2=80=9CThis=20API=20has=20no?= =?UTF-8?q?=20official=20W3C=20or=20WHATWG=20specification.=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/zh-tw/web/api/filesystem/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index d1e5fc23743434..3fabbd74020b11 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -24,7 +24,6 @@ slug: Web/API/FileSystem {{Specifications}} -This API has no official W3C or WHATWG specification. ## 瀏覽器相容性 From 78fe3593aaed2d45eb136db59b3732f84fcc380c Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Thu, 15 Aug 2024 10:53:47 +0800 Subject: [PATCH 04/12] =?UTF-8?q?=E8=99=95=E7=90=86=E7=B5=90=E5=B0=BE?= =?UTF-8?q?=E7=A9=BA=E6=A0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- files/zh-tw/web/api/filesystem/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 3fabbd74020b11..12108276cc49e5 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -3,7 +3,7 @@ title: FileSystem slug: Web/API/FileSystem --- -{{APIRef("File System API")}} +{{APIRef("File System API")}} **`FileSystem`** 實作文件和目錄介面，描述一個檔案系統。在任何檔案系統上，這個物件包含 {{domxref("FileSystemEntry.filesystem", "filesystem")}}的特性。某些網頁瀏覽器提供額外的 API 去創建和管理檔案系統，如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 ## 基礎概念 From 91472a749db05c353083621013954b8116d9682a Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Thu, 15 Aug 2024 10:54:16 +0800 Subject: [PATCH 05/12] =?UTF-8?q?=E8=99=95=E7=90=86=E8=A4=87=E6=95=B8?= =?UTF-8?q?=E7=A9=BA=E7=99=BD=E8=A1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- files/zh-tw/web/api/filesystem/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 12108276cc49e5..185b308d7db971 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -24,7 +24,6 @@ slug: Web/API/FileSystem {{Specifications}} - ## 瀏覽器相容性 {{Compat}} From ff8dd904eafa7010638b1a8538cde7e74fe0dec7 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Thu, 15 Aug 2024 11:30:34 +0800 Subject: [PATCH 06/12] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E5=85=A7=E6=96=87?= =?UTF-8?q?=E7=9A=84=E7=BF=BB=E8=AD=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/zh-tw/web/api/filesystem/index.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 185b308d7db971..6d1b0edad6d756 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -4,21 +4,22 @@ slug: Web/API/FileSystem --- {{APIRef("File System API")}} -**`FileSystem`** 實作文件和目錄介面，描述一個檔案系統。在任何檔案系統上，這個物件包含 {{domxref("FileSystemEntry.filesystem", "filesystem")}}的特性。某些網頁瀏覽器提供額外的 API 去創建和管理檔案系統，如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 + +檔案與目錄 API 的 `FileSystem` 介面是用來處理檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 ## 基礎概念 -存取 `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")}} 物件，用來表示檔案系統的根目錄。透過此物件，你可以取得檔案系統中的所有的檔案與目錄。 ## 規範 From 907a131dca69cc3f063cdfac231f29d6de062e03 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Wed, 28 Aug 2024 12:58:49 +0800 Subject: [PATCH 07/12] Update files/zh-tw/web/api/filesystem/index.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit change to 檔案與目錄 Co-authored-by: A1lo --- files/zh-tw/web/api/filesystem/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 6d1b0edad6d756..871277918ac266 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -32,5 +32,5 @@ slug: Web/API/FileSystem ## 參見 - [檔案與目錄 API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API) -- [檔案系統 API 介紹](/zh-TW/docs/Web/API/File_and_Directory_Entries_API/Introduction) +- [檔案與目錄 API 介紹](/zh-TW/docs/Web/API/File_and_Directory_Entries_API/Introduction) - {{domxref("FileSystemEntry")}}、{{domxref("FileSystemFileEntry")}}、{{domxref("FileSystemDirectoryEntry")}} From 55bc382d22379f55af34c75825cde6cda76d4a92 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Wed, 28 Aug 2024 12:59:07 +0800 Subject: [PATCH 08/12] =?UTF-8?q?Update=20files/zh-tw/web/api/filesystem/i?= =?UTF-8?q?ndex.md,=20change=20to=20=E5=AF=A6=E4=BE=8B=E5=B1=AC=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: A1lo --- files/zh-tw/web/api/filesystem/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 871277918ac266..565b1a7d63bebc 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -14,7 +14,7 @@ slug: Web/API/FileSystem 1. 你可以呼叫 `window.requestFileSystem()`，為你的網頁應用程式建立一個檔案系統的沙盒。如果呼叫成功，將會執行回呼函式，該回呼函式會有個 `FileSystem` 參數來描述檔案系統。 2. 從檔案系統項目物件的 {{domxref("FileSystemEntry.filesystem", "filesystem")}} 屬性中取得。 -## 屬性 +## 實例屬性 - {{domxref("FileSystem.name")}} {{ReadOnlyInline}} - : 代表檔案系統名稱的字串。此名稱在整個檔案的清單中是唯一的。 From c07dd6c63e3dce6c32b2b9c754e528e0fd2b86e3 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Wed, 28 Aug 2024 12:59:33 +0800 Subject: [PATCH 09/12] Update files/zh-tw/web/api/filesystem/index.md Co-authored-by: A1lo --- files/zh-tw/web/api/filesystem/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 565b1a7d63bebc..95db8708f0110b 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -5,7 +5,7 @@ slug: Web/API/FileSystem {{APIRef("File System API")}} -檔案與目錄 API 的 `FileSystem` 介面是用來處理檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 +檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 ## 基礎概念 From af5715423ba0958cabfe0710edff9a6382b3c0f8 Mon Sep 17 00:00:00 2001 From: Tzuyang Tsai <14104502+shiyou0130011@users.noreply.github.com> Date: Wed, 28 Aug 2024 14:11:43 +0800 Subject: [PATCH 10/12] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20filesystem/index.md?= =?UTF-8?q?=20=EF=BC=8C=E7=AC=AC=E4=B8=80=E7=AB=A0=E8=A3=9C=E4=B8=8A?= =?UTF-8?q?=E6=AE=B5=E8=90=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/zh-tw/web/api/filesystem/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 95db8708f0110b..ec0b7ee59ac35e 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -7,6 +7,8 @@ slug: Web/API/FileSystem 檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 +此介面並不會讓你直接存取使用者電腦的檔案系統，而是在瀏覽器的沙盒內建立一個「虛擬磁碟」讓你操作。如果要直接操作使用者的檔案系統，需要向使用者請求，像是安裝 Google Chrome 擴充功能之類的。相關的 Chrome API 可[在此](https://developer.chrome.com/docs/apps/reference/fileSystem)找到。 + ## 基礎概念 存取 `FileSystem` 物件的兩種方法： From de8d19c750e231f78420863a243b5de676d2029d Mon Sep 17 00:00:00 2001 From: A1lo Date: Wed, 28 Aug 2024 16:09:05 +0800 Subject: [PATCH 11/12] Apply suggestions from code review --- files/zh-tw/web/api/filesystem/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index ec0b7ee59ac35e..8c64cf47fee192 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -1,9 +1,11 @@ --- title: FileSystem slug: Web/API/FileSystem +l10n: + sourceCommit: 0c3f18aca2c8a93d3982183f64bf7762c2c310b0 --- -{{APIRef("File System API")}} +{{APIRef("File and Directory Entries API")}} 檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 From a74dd3ba8e20b07ee730b0ec0b6cc33765675a00 Mon Sep 17 00:00:00 2001 From: A1lo Date: Wed, 28 Aug 2024 16:10:15 +0800 Subject: [PATCH 12/12] Update files/zh-tw/web/api/filesystem/index.md --- files/zh-tw/web/api/filesystem/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-tw/web/api/filesystem/index.md b/files/zh-tw/web/api/filesystem/index.md index 8c64cf47fee192..9e99bb68291e56 100644 --- a/files/zh-tw/web/api/filesystem/index.md +++ b/files/zh-tw/web/api/filesystem/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("File and Directory Entries API")}} -檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 +檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 {{domxref("FileSystemEntry.filesystem", "filesystem")}} 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統，例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 此介面並不會讓你直接存取使用者電腦的檔案系統，而是在瀏覽器的沙盒內建立一個「虛擬磁碟」讓你操作。如果要直接操作使用者的檔案系統，需要向使用者請求，像是安裝 Google Chrome 擴充功能之類的。相關的 Chrome API 可[在此](https://developer.chrome.com/docs/apps/reference/fileSystem)找到。