為什麼捐款
API 瀏覽器
檔案選擇器

QFile 是一個處理使用者互動以選擇檔案的組件。

提示

如果您還想要一個組件來為您處理上傳,請考慮改用 QUploader

載入 QFile API...

設計

警告

對於您的 QFile,您只能使用主要設計之一(filledoutlinedstandoutborderless)。您不能同時使用多個,因為它們是互斥的。

設計概觀



裝飾器

裝飾器



色彩

色彩



可清除

作為輔助工具,您可以使用 clearable prop,以便使用者可以透過附加的圖示將模型重設為 null。以下範例中的第二個 QFile 等同於使用 clearable

可清除



停用和唯讀

停用和唯讀



用法

警告

在底層,QFile 使用原生輸入。由於瀏覽器安全策略,不允許以程式方式填寫此類輸入的值。因此,即使您從一開始就將 v-model 設定為值,組件也會顯示這些檔案,但輸入標籤本身不會填入該值。絕對需要使用者互動(點擊/點擊/ENTER 鍵/SPACE 鍵),原生輸入才能包含它們。最好始終將模型的初始值設定為 nullundefined/void 0

基本

單一檔案



多個檔案



附加檔案

預設情況下,每次使用者透過彈出視窗選擇任何檔案時,QFile 都會替換模型。但是,當您接受多個檔案(multiple prop)時,您可以變更此行為,並將新選擇附加到模型,而不是替換其舊值。

在下面,您可以多次選擇檔案,並且 QFile 將繼續將它們附加到模型

附加檔案



計數器

基本計數器



計數器標籤



使用晶片

帶有晶片



使用檔案插槽

下面的範例重點介紹了如何自訂每個檔案的顯示,甚至可以加入可能的上傳進度指示器

帶有進度指示器



限制檔案

基本限制



您甚至可以結合以上限制。

提示

在上面的範例中,我們正在使用 accept 屬性。其值必須是以逗號分隔的唯一檔案類型規範清單。對應到原生 input type=file 元素的 'accept' 屬性。更多資訊

警告

accept 屬性的建議格式是 <mediatype>/<extension>。範例:「image/png」、「image/png」。QFile 在底層使用 <input type="file">,並且完全依賴主機瀏覽器來觸發檔案選擇器。如果 accept 屬性(應用於輸入)不正確,則螢幕上不會出現檔案選擇器,或將出現但會接受所有檔案類型。

您還可以套用自訂篩選器(在使用者選擇檔案後執行)

篩選器



原生表單提交

當處理具有 actionmethod 的原生表單時(例如,當將 Quasar 與 ASP.NET 控制器一起使用時),您需要在 QFile 上指定 name 屬性,否則 formData 將不會包含它(如果應該包含)。

原生表單