Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[zh-tw] update filesystem #23069

Merged
merged 13 commits into from
Aug 28, 2024
29 changes: 14 additions & 15 deletions files/zh-tw/web/api/filesystem/index.md
Original file line number Diff line number Diff line change
@@ -1,41 +1,40 @@
---
title: FileSystem
slug: Web/API/FileSystem
l10n:
sourceCommit: 0c3f18aca2c8a93d3982183f64bf7762c2c310b0
---
yin1999 marked this conversation as resolved.
Show resolved Hide resolved

{{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`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 `filesystem` 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統,例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法
yin1999 marked this conversation as resolved.
Show resolved Hide resolved

> [!NOTE]
> 此介面並非標準 API, 代表規格並未依造標準制定, 因此必須注意並非所有網頁瀏覽器都有實作此介面, 有實作的網頁瀏覽器可能只有實作一小部分. 請在[Browser compatibility](#browser_compatibility) 查看更多細節.
此介面並不會讓你直接存取使用者電腦的檔案系統,而是在瀏覽器的沙盒內建立一個「虛擬磁碟」讓你操作。如果要直接操作使用者的檔案系統,需要向使用者請求,像是安裝 Google Chrome 擴充功能之類的。相關的 Chrome API 可[在此](https://developer.chrome.com/docs/apps/reference/fileSystem)找到。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里还缺一段,最好能补上

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @yin1999
缺少的段落已經補上了

## 基礎概念
yin1999 marked this conversation as resolved.
Show resolved Hide resolved

存取 `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")}}
Loading