QFile 是一個處理使用者互動以選擇檔案的組件。
提示
如果您還想要一個組件來為您處理上傳,請考慮改用 QUploader。
設計
警告
對於您的 QFile,您只能使用主要設計之一(filled
、outlined
、standout
、borderless
)。您不能同時使用多個,因為它們是互斥的。
裝飾器
色彩
可清除
作為輔助工具,您可以使用 clearable
prop,以便使用者可以透過附加的圖示將模型重設為 null
。以下範例中的第二個 QFile 等同於使用 clearable
。
停用和唯讀
用法
警告
在底層,QFile 使用原生輸入。由於瀏覽器安全策略,不允許以程式方式填寫此類輸入的值。因此,即使您從一開始就將 v-model 設定為值,組件也會顯示這些檔案,但輸入標籤本身不會填入該值。絕對需要使用者互動(點擊/點擊/ENTER 鍵/SPACE 鍵),原生輸入才能包含它們。最好始終將模型的初始值設定為 null
或 undefined/void 0
。
基本
附加檔案
預設情況下,每次使用者透過彈出視窗選擇任何檔案時,QFile 都會替換模型。但是,當您接受多個檔案(multiple
prop)時,您可以變更此行為,並將新選擇附加到模型,而不是替換其舊值。
在下面,您可以多次選擇檔案,並且 QFile 將繼續將它們附加到模型
計數器
使用晶片
使用檔案插槽
下面的範例重點介紹了如何自訂每個檔案的顯示,甚至可以加入可能的上傳進度指示器
限制檔案
您甚至可以結合以上限制。
提示
在上面的範例中,我們正在使用 accept
屬性。其值必須是以逗號分隔的唯一檔案類型規範清單。對應到原生 input type=file 元素的 'accept' 屬性。更多資訊。
警告
accept
屬性的建議格式是 <mediatype>/<extension>
。範例:「image/png」、「image/png」。QFile 在底層使用 <input type="file">
,並且完全依賴主機瀏覽器來觸發檔案選擇器。如果 accept
屬性(應用於輸入)不正確,則螢幕上不會出現檔案選擇器,或將出現但會接受所有檔案類型。
您還可以套用自訂篩選器(在使用者選擇檔案後執行)
原生表單提交
當處理具有 action
和 method
的原生表單時(例如,當將 Quasar 與 ASP.NET 控制器一起使用時),您需要在 QFile 上指定 name
屬性,否則 formData 將不會包含它(如果應該包含)。