FaCarNumber 车牌输入

组合 ElInput 与省份、字母、数字车牌键盘，支持普通车牌和新能源车牌校验，并自动接入 ElForm 校验。

车牌选择、清空与禁用状态

查看代码

Vue

<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 属性 (33)

Fast 与 Element Plus 2.14.6 的属性已合并展示；Fast 修改项优先排列，未透传的原生属性保留用于兼容性核对。

属性	来源	说明	类型	默认值
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 修改	whether show word count, only works when type is 'text' or 'textarea'	Boolean	FastfalseELtrue
id	EL 原生	组件根输入元素的原生 id。	String	—
size	EL 原生	组件尺寸。	String	—
disabled	EL 原生	是否禁用组件或当前选项。	Boolean	false
modelModifiers	EL 原生	v-model modifiers, reference Vue modifiers	Object	{}
maxlength	EL 原生	same as maxlength in native input	String / Number	—
minlength	EL 原生	same as minlength in native input	String / Number	—
type	EL 原生	输入框原生类型。	String	text
resize	EL 原生	control the resizability	String	—
autosize	EL 原生	whether textarea has an adaptive height, only works when type is 'textarea'. Can accept an object, e.g. { minRows: 2, maxRows: 6 }	Boolean / Object	false
autocomplete	EL 原生	输入框原生 autocomplete 属性。	String	off
form	EL 原生	same as form in native input	String	—
clearable	EL 原生	是否允许清空。	Boolean	false
clearIcon	EL 原生	清空按钮使用的图标组件。	String / Object / Function	{"name":"CircleClose","__name":"circle-close"}
showPassword	EL 原生	whether to show toggleable password input	Boolean	false
wordLimitPosition	EL 原生	word count position, valid when show-word-limit is true	String	inside
suffixIcon	EL 原生	选择器右侧显示的后缀图标组件。	String / Object / Function	—
prefixIcon	EL 原生	prefix icon component	String / Object / Function	—
containerRole	EL 原生	输入组合容器的 ARIA role。	String	—
tabindex	EL 原生	组件输入元素的原生 tabindex。	String / Number	0
validateEvent	EL 原生	模型值变化时是否触发表单校验。	Boolean	true
inputStyle	EL 原生	the style of the input element or textarea element	Object / Array / String / Boolean	{}
countGraphemes	EL 原生	custom function to count graphemes; when set, native maxlength/minlength constraints are bypassed. Component uses Intl.Segmenter (Chrome 87+, Firefox 125+, Safari 14.1+) for proper grapheme clustering; older browsers fall back to Array.from() for code-point iteration	Function	—
autofocus	EL 原生	same as autofocus in native input	Boolean	false
rows	EL 原生	number of rows of textarea, only works when type is 'textarea'	Number	2
ariaLabel	EL 原生	组件面向辅助技术的可访问名称。	String	—
inputmode	EL 原生	same as inputmode in native input	String	—
name	EL 原生	图标名称、CSS 类名或外部 SVG 地址。	String	—

Events 事件（12）

名称	来源	说明	参数 / 类型
update:modelValue	EL 原生	更新 v-model。	—
change	EL 原生	值或选择发生变化。	—
blur	EL 原生 · 未透传	triggers when Input blurs	—
focus	EL 原生 · 未透传	triggers when Input focuses	—
input	EL 原生 · 未透传	triggers when the Input value change	—
clear	EL 原生 · 未透传	triggers when the Input is cleared by clicking the clear button	—
keydown	EL 原生 · 未透传	triggers when a key is pressed down	—
mouseleave	EL 原生 · 未透传	triggers when the mouse leaves the Input element	—
mouseenter	EL 原生 · 未透传	triggers when the mouse enters the Input element	—
compositionstart	EL 原生 · 未透传	triggers when the composition starts	—
compositionupdate	EL 原生 · 未透传	triggers when the composition is updated	—
compositionend	EL 原生 · 未透传	triggers when the composition ends	—

Slots 插槽（5）

名称	来源	说明	参数 / 类型
prefix	EL 原生 · 未透传	content as Input prefix, only works when type is not 'textarea'	—
suffix	EL 原生 · 未透传	content as Input suffix, only works when type is not 'textarea'	—
prepend	EL 原生 · 未透传	content to prepend before Input, only works when type is not 'textarea'	—
append	EL 原生 · 未透传	content to append after Input, only works when type is not 'textarea'	—
password-icon	EL 原生 · 未透传	content as Input password icon, only works when show-password is true. The scope variable is { visible: boolean }	—

Expose 暴露（10）

名称	来源	说明	参数 / 类型
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 高度。	—