InputMask

InputMask 元件用於以特定格式輸入，例如數字、日期、貨幣、電子郵件和電話。

匯入 #


import InputMask from 'primevue/inputmask';

基本 #

InputMask 與v-model屬性一起使用，進行雙向值繫結。


<InputMask id="basic" v-model="value" mask="99-999999" placeholder="99-999999" />

表單 #

InputMask 與 PrimeVue 表單程式庫無縫整合。


<Form v-slot="$form" :resolver="resolver" :initialValues="initialValues" @submit="onFormSubmit" class="flex flex-col gap-4 w-full sm:w-56">
    <div class="flex flex-col gap-1">
        <InputMask name="serialNumber" mask="99-999999" placeholder="99-999999" fluid />
        <Message v-if="$form.serialNumber?.invalid" severity="error" size="small" variant="simple">{{ $form.serialNumber.error?.message }}</Message>
    </div>
    <Button type="submit" severity="secondary" label="Submit" />
</Form>

遮罩 #

遮罩格式可以是以下定義的組合；a 代表字母字元，9 代表數字字元，而 * 代表字母數字字元。此外，也接受格式化字元，例如 (、) 、 -。

SSN

電話

序號


<div class="flex-auto">
    <label for="ssn" class="font-bold block mb-2">SSN</label>
    <InputMask id="ssn" v-model="value1" mask="999-99-9999" placeholder="999-99-9999" fluid />
</div>

<div class="flex-auto">
    <label for="phone" class="font-bold block mb-2">Phone</label>
    <InputMask id="phone" v-model="value2" mask="(999) 999-9999" placeholder="(999) 999-9999" fluid />
</div>

<div class="flex-auto">
    <label for="serial" class="font-bold block mb-2">Serial</label>
    <InputMask id="serial" v-model="value3" mask="a*-999-a999" placeholder="a*-999-a999" fluid />
</div>

可選 #

當輸入未完成遮罩定義時，預設會清除它。使用 autoClear 屬性來控制此行為。此外，? 用於將問號之後的任何內容標記為可選。


<InputMask v-model="value" mask="(999) 999-9999? x99999" placeholder="(999) 999-9999? x99999" />

SlotChar #

遮罩的預設佔位符是底線，可以使用 slotChar 屬性進行自訂。


<InputMask id="basic" v-model="value" placeholder="99/99/9999" mask="99/99/9999" slotChar="mm/dd/yyyy" />

填滿 #

將 variant 屬性指定為 filled，以顯示比預設 outlined 樣式具有更高視覺強調的元件。


<InputMask id="basic" v-model="value" variant="filled" mask="99-999999" placeholder="99-999999" />

浮動標籤 #

FloatLabel 將標籤與其表單元素視覺整合。有關更多資訊，請瀏覽浮動標籤文件。

在上方標籤在內標籤已開啟標籤


<FloatLabel>
    <InputMask id="over_label" v-model="value1" mask="999-99-9999" />
    <label for="over_label">Over Label</label>
</FloatLabel>

<FloatLabel variant="in">
    <InputMask id="in_label" v-model="value2" mask="999-99-9999" variant="filled" />
    <label for="in_label">In Label</label>
</FloatLabel>

<FloatLabel variant="on">
    <InputMask id="on_label" v-model="value3" mask="999-99-9999" />
    <label for="on_label">On Label</label>
</FloatLabel>

內嵌頂部標籤 #

IftaLabel 用於建立內嵌頂部對齊標籤。有關更多資訊，請瀏覽內嵌頂部標籤文件。

SSN


<IftaLabel>
    <InputMask id="ssn" v-model="value" mask="999-99-9999" variant="filled" />
    <label for="ssn">SSN</label>
</IftaLabel>

尺寸 #

InputMask 提供 small 和 large 尺寸作為基本尺寸的替代方案。


<InputMask v-model="value1" placeholder="Small" size="small" mask="99-999999" />
<InputMask v-model="value2" placeholder="Normal" mask="99-999999" />
<InputMask v-model="value3" placeholder="Large" size="large" mask="99-999999" />

無效 #

無效狀態使用 invalid 屬性顯示，表示驗證失敗。在與表單驗證程式庫整合時，您可以使用此樣式。


<InputMask v-model="value1" mask="99-999999" placeholder="Serial Key" :invalid="!value1" />
<InputMask v-model="value2" mask="99-999999" placeholder="Serial Key" :invalid="!value2" variant="filled" />

已停用 #

當存在 disabled 時，無法編輯和聚焦元素。


<InputMask mask="99-999999" placeholder="Disabled" disabled />

無障礙 #

螢幕閱讀器

InputMask 元件會轉譯原生輸入元素，該元素會隱含包含任何傳遞的屬性。用於描述元件的值可以透過 label 標籤結合 id 屬性或使用 aria-labelledby、aria-label 屬性來提供。


<label for="date">Date</label>
<InputMask id="date" />

<span id="phone">Phone</span>
<InputMask aria-labelledby="phone" />

<InputMask aria-label="Age" />

鍵盤支援

按鍵	功能
tab	將焦點移至輸入欄位。