输入遮罩

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 表示数字字符，* 表示字母数字字符。此外，还接受 (、)、- 等格式化字符。

社会安全号码

电话

序列号


<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 属性自定义。


<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>
    <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>

Ifta 标签 #

IftaLabel 用于创建内联顶部对齐标签。有关更多信息，请访问 IftaLabel 文档。

社会安全号码


<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 组件呈现一个本机 input 元素，该元素隐式包含任何传递的 prop。用于描述组件的值可以通过 label 标签与 id prop 组合提供，也可以使用 aria-labelledby、aria-label prop 提供。


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

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

<InputMask aria-label="Age" />

键盘支持

按键	功能
tab	将焦点移动到输入框。