QTime 組件提供了一種輸入時間的方法。
提示
若要處理日期和/或時間,也請查看 Quasar 日期工具。
用法
請注意,模型僅為字串。
基本
提示
對於橫向模式,您可以將其與 $q.screen
一起使用,使 QTime 具有響應性。範例::landscape="$q.screen.gt.xs"
。更多資訊:Quasar Screen Plugin。
功能
24 小時制格式的應用取決於您設定的 Quasar 語言包,但您也可以強制使用,如下例所示。
點擊「現在」按鈕會將時間設定為目前使用者時間
模型遮罩
預設模型遮罩為 HH:mm
(或使用 with-seconds
prop 時為 HH:mm:ss
),但您也可以使用自訂遮罩。
mask
prop 的 tokens 可以在 Quasar 工具 > 日期工具 中找到。
SSR 注意事項
在遮罩中使用 x
或 X
(時間戳記) 可能會在客戶端造成 hydration 錯誤,因為解碼模型字串必須使用 new Date()
,這會將本地時區納入考量。因此,如果伺服器與客戶端位於不同的時區,則伺服器呈現的輸出將與客戶端的不同,因此 hydration 將會失敗。
波斯曆注意事項
當使用波斯曆時,QTime 的遮罩會強制設定為 HH:mm
或 HH:mm:ss
(如果指定了 with-seconds
)。
如果您想在遮罩中插入字串(包括 [
和 ]
字元),請確保用 [
和 ]
將它們包圍起來以進行轉義,否則這些字元可能會被解釋為格式 tokens。
使用遮罩將 QDate 和 QTime 連接到同一個模型
自訂臨時語言環境
如果由於某些原因,您需要使用自訂臨時語言環境而不是目前已設定的 Quasar 語言包,則可以使用 locale
prop
顏色
限制選項
- 您可以使用
hour-options
、minute-options
和second-options
props 來限制使用者只能選擇特定時間。 - 或者,為了更深入地限制選項,您也可以將函數(如下面的第二個範例)提供給
options-fn
prop。
與 QInput 一起使用
在 QInput 上將 QDate 和 QTime 與同一個模型連接
以下是 QInput mask
和 rules
props 的helpers。您可以使用這些 helpers 以方便使用,或編寫字串來指定您的自訂需求。
範例:「date」、「time」、「fulltime」。
更多資訊:QInput。
帶有額外按鈕
您可以使用預設 slot 來新增按鈕
原生表單提交
當處理具有 action
和 method
的原生表單時(例如,當將 Quasar 與 ASP.NET controllers 一起使用時),您需要在 QTime 上指定 name
property,否則 formData 將不會包含它(如果應該包含)。