FaCarNumber 车牌输入
组合 ElInput 与省份、字母、数字车牌键盘,支持普通车牌和新能源车牌校验,并自动接入 ElForm 校验。
自 2.0.28 起,实例支持 focus()、blur()、select()、clear() 和 resizeTextarea()。clear() 清空车牌并按车牌组件规则更新模型。 车牌输入继续使用车牌组件自己的事件和布局。
车牌选择、清空与禁用状态
可操作示例查看代码
<template>
<div class="demo-stack">
<FaCarNumber v-model="carNumber" clearable style="max-width: 360px" />
<FaCarNumber model-value="粤B12345" disabled style="max-width: 360px" />
<span class="demo-value">当前车牌:{{ carNumber ?? "未选择" }}</span>
</div>
</template>
<script setup lang="ts">
import { ref } from "vue";
const carNumber = ref<string | null>("粤B12345");
</script>FaCarNumber 完整 API
基于 ElInput 组合车牌键盘;除表中列出的 Input Props 外,不透传 ElInput 插槽和 Expose。
Props 属性
EL 默认值取自导入 Fast 前的 Element Plus。 2.14.7
| 属性 | 来源 | 说明 | 类型 | 默认值 |
|---|---|---|---|---|
modelValue | Fast 修改 | v-model 绑定值。 | String | Fast—EL"" |
formatter | Fast 修改 | 显示值格式化函数。 | Function | Fast—EL— |
parser | Fast 修改 | 输入值解析函数,在写入模型前转换显示文本。 | Function | Fast—EL— |
placeholder | Fast 修改 | 占位提示。 | String | Fast请选择EL— |
readonly | Fast 修改 | 是否以只读方式展示输入值。 | Boolean | FastfalseELfalse |
showWordLimit | Fast 修改 | 是否显示字数,仅适用于 text 和 textarea。 | Boolean | FastfalseFast 全局trueELfalse |
id | EL 原生 | 组件根输入元素的原生 id。 | String | — |
size | EL 原生 | 组件尺寸。 | String | — |
disabled | EL 原生 | 是否禁用组件或当前选项。 | Boolean | false |
modelModifiers | EL 原生 | 应用于 v-model 的 Vue 修饰符。 | Object | {} |
maxlength | EL 原生 | 输入长度上限,与原生 maxlength 一致。 | String / Number | — |
minlength | EL 原生 | 输入长度下限,与原生 minlength 一致。 | String / Number | — |
type | EL 原生 | 输入框原生类型。 | String | text |
resize | EL 原生 | 控制是否允许拖动调整文本域尺寸及可调整的方向。 | String | — |
autosize | EL 原生 | 文本域是否自适应高度,也可通过 minRows 和 maxRows 限制行数。 | Boolean / Object | false |
autocomplete | EL 原生 | 输入框原生 autocomplete 属性。 | String | off |
form | EL 原生 | 指定关联表单的 ID,与原生 form 一致。 | String | — |
clearable | EL 原生 | 是否允许清空。 | Boolean | false |
clearIcon | EL 原生 | 清空按钮使用的图标组件。 | String / Object / Function | {"name":"CircleClose","__name":"circle-close"} |
showPassword | EL 原生 | 是否提供切换密码可见性的控件。 | Boolean | false |
wordLimitPosition | EL 原生 | 字数提示的位置,启用 show-word-limit 后生效。 | String | inside |
suffixIcon | EL 原生 | 选择器右侧显示的后缀图标组件。 | String / Object / Function | — |
prefixIcon | EL 原生 | 显示在输入框前部的图标组件。 | String / Object / Function | — |
containerRole | EL 原生 | 输入组合容器的 ARIA role。 | String | — |
tabindex | EL 原生 | 组件输入元素的原生 tabindex。 | String / Number | 0 |
validateEvent | EL 原生 | 模型值变化时是否触发表单校验。 | Boolean | true |
inputStyle | EL 原生 | 应用于 input 或 textarea 元素的样式。 | Object / Array / String / Boolean | {} |
countGraphemes | EL 原生 | 自定义字素计数。设置后绕过原生长度限制。组件可用时使用 Intl.Segmenter,否则按 Unicode 码点计数。 | Function | — |
autofocus | EL 原生 | 是否自动聚焦,与原生 autofocus 一致。 | Boolean | false |
rows | EL 原生 | 文本域行数,仅适用于 textarea。 | Number | 2 |
ariaLabel | EL 原生 | 组件面向辅助技术的可访问名称。 | String | — |
inputmode | EL 原生 | 虚拟键盘的输入模式,与原生 inputmode 一致。 | String | — |
name | EL 原生 | 图标名称、CSS 类名或外部 SVG 地址。 | String | — |
Events 事件
| 名称 | 来源 | 说明 | 参数 / 类型 |
|---|---|---|---|
update:modelValue | EL 原生 | 更新 v-model。 | — |
change | EL 原生 | 值或选择发生变化。 | — |
blur | EL 原生 · 未透传 | 组件失去焦点时触发。 | — |
focus | EL 原生 · 未透传 | 组件获得焦点时触发。 | — |
input | EL 原生 · 未透传 | 输入内容变化时触发。 | — |
clear | EL 原生 · 未透传 | 点击清空按钮并完成清空时触发。 | — |
keydown | EL 原生 · 未透传 | 按下键盘按键时触发。 | — |
mouseleave | EL 原生 · 未透传 | 鼠标离开输入元素时触发。 | — |
mouseenter | EL 原生 · 未透传 | 鼠标进入输入元素时触发。 | — |
compositionstart | EL 原生 · 未透传 | 输入法开始组合输入时触发。 | — |
compositionupdate | EL 原生 · 未透传 | 输入法更新组合内容时触发。 | — |
compositionend | EL 原生 · 未透传 | 输入法结束组合输入时触发。 | — |
Slots 插槽
| 名称 | 来源 | 说明 | 参数 / 类型 |
|---|---|---|---|
prefix | EL 原生 · 未透传 | 自定义选择器输入框前缀内容。 | — |
suffix | EL 原生 · 未透传 | 输入框尾部内容,文本域不可用。 | — |
prepend | EL 原生 · 未透传 | 输入框前置内容,文本域不可用。 | — |
append | EL 原生 · 未透传 | 在表格最后一行之后追加自定义内容。 | — |
password-icon | EL 原生 · 未透传 | 自定义密码显示开关图标,启用 show-password 后可用。visible 表示密码是否可见。 | — |
实例成员
| 名称 | 来源 | 说明 | 参数 / 类型 |
|---|---|---|---|
input | EL 原生 · 未透传 | ElInput 内部 input 元素引用。 | — |
textarea | EL 原生 · 未透传 | ElInput 内部 textarea 元素引用。 | — |
ref | EL 原生 · 未透传 | 底层 Element Plus 组件引用。 | — |
textareaStyle | EL 原生 · 未透传 | ElInput 计算后的 textarea 样式。 | — |
autosize | EL 原生 · 未透传 | 当前输入框的自动高度配置。 | — |
focus | EL 原生 · 未透传 | 让输入或选择组件获得焦点。 | — |
blur | EL 原生 · 未透传 | 让输入或选择组件失去焦点。 | — |
select | EL 原生 · 未透传 | 选中 ElInput 中的全部文本。 | — |
clear | EL 原生 · 未透传 | 清空当前选择值。 | — |
resizeTextarea | EL 原生 · 未透传 | 重新计算 textarea 高度。 | — |
