跳到正文

FaCarNumber 车牌输入 ​

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

自 2.0.28 起,实例支持 focus()、blur()、select()、clear() 和 resizeTextarea()。clear() 清空车牌并按车牌组件规则更新模型。 车牌输入继续使用车牌组件自己的事件和布局。

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

可操作示例
查看代码
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 属性

EL 默认值取自导入 Fast 前的 Element Plus。 2.14.7

属性来源说明类型默认值
modelValueFast 修改v-model 绑定值。StringFast—EL""
formatterFast 修改显示值格式化函数。FunctionFast—EL—
parserFast 修改输入值解析函数,在写入模型前转换显示文本。FunctionFast—EL—
placeholderFast 修改占位提示。StringFast请选择EL—
readonlyFast 修改是否以只读方式展示输入值。BooleanFastfalseELfalse
showWordLimitFast 修改是否显示字数,仅适用于 text 和 textarea。BooleanFastfalseFast 全局trueELfalse
idEL 原生组件根输入元素的原生 id。String—
sizeEL 原生组件尺寸。String—
disabledEL 原生是否禁用组件或当前选项。Booleanfalse
modelModifiersEL 原生应用于 v-model 的 Vue 修饰符。Object{}
maxlengthEL 原生输入长度上限,与原生 maxlength 一致。String / Number—
minlengthEL 原生输入长度下限,与原生 minlength 一致。String / Number—
typeEL 原生输入框原生类型。Stringtext
resizeEL 原生控制是否允许拖动调整文本域尺寸及可调整的方向。String—
autosizeEL 原生文本域是否自适应高度,也可通过 minRows 和 maxRows 限制行数。Boolean / Objectfalse
autocompleteEL 原生输入框原生 autocomplete 属性。Stringoff
formEL 原生指定关联表单的 ID,与原生 form 一致。String—
clearableEL 原生是否允许清空。Booleanfalse
clearIconEL 原生清空按钮使用的图标组件。String / Object / Function{"name":"CircleClose","__name":"circle-close"}
showPasswordEL 原生是否提供切换密码可见性的控件。Booleanfalse
wordLimitPositionEL 原生字数提示的位置,启用 show-word-limit 后生效。Stringinside
suffixIconEL 原生选择器右侧显示的后缀图标组件。String / Object / Function—
prefixIconEL 原生显示在输入框前部的图标组件。String / Object / Function—
containerRoleEL 原生输入组合容器的 ARIA role。String—
tabindexEL 原生组件输入元素的原生 tabindex。String / Number0
validateEventEL 原生模型值变化时是否触发表单校验。Booleantrue
inputStyleEL 原生应用于 input 或 textarea 元素的样式。Object / Array / String / Boolean{}
countGraphemesEL 原生自定义字素计数。设置后绕过原生长度限制。组件可用时使用 Intl.Segmenter,否则按 Unicode 码点计数。Function—
autofocusEL 原生是否自动聚焦,与原生 autofocus 一致。Booleanfalse
rowsEL 原生文本域行数,仅适用于 textarea。Number2
ariaLabelEL 原生组件面向辅助技术的可访问名称。String—
inputmodeEL 原生虚拟键盘的输入模式,与原生 inputmode 一致。String—
nameEL 原生图标名称、CSS 类名或外部 SVG 地址。String—

Events 事件

名称来源说明参数 / 类型
update:modelValueEL 原生更新 v-model。—
changeEL 原生值或选择发生变化。—
blurEL 原生 · 未透传组件失去焦点时触发。—
focusEL 原生 · 未透传组件获得焦点时触发。—
inputEL 原生 · 未透传输入内容变化时触发。—
clearEL 原生 · 未透传点击清空按钮并完成清空时触发。—
keydownEL 原生 · 未透传按下键盘按键时触发。—
mouseleaveEL 原生 · 未透传鼠标离开输入元素时触发。—
mouseenterEL 原生 · 未透传鼠标进入输入元素时触发。—
compositionstartEL 原生 · 未透传输入法开始组合输入时触发。—
compositionupdateEL 原生 · 未透传输入法更新组合内容时触发。—
compositionendEL 原生 · 未透传输入法结束组合输入时触发。—

Slots 插槽

名称来源说明参数 / 类型
prefixEL 原生 · 未透传自定义选择器输入框前缀内容。—
suffixEL 原生 · 未透传输入框尾部内容,文本域不可用。—
prependEL 原生 · 未透传输入框前置内容,文本域不可用。—
appendEL 原生 · 未透传在表格最后一行之后追加自定义内容。—
password-iconEL 原生 · 未透传自定义密码显示开关图标,启用 show-password 后可用。visible 表示密码是否可见。—

实例成员

名称来源说明参数 / 类型
inputEL 原生 · 未透传ElInput 内部 input 元素引用。—
textareaEL 原生 · 未透传ElInput 内部 textarea 元素引用。—
refEL 原生 · 未透传底层 Element Plus 组件引用。—
textareaStyleEL 原生 · 未透传ElInput 计算后的 textarea 样式。—
autosizeEL 原生 · 未透传当前输入框的自动高度配置。—
focusEL 原生 · 未透传让输入或选择组件获得焦点。—
blurEL 原生 · 未透传让输入或选择组件失去焦点。—
selectEL 原生 · 未透传选中 ElInput 中的全部文本。—
clearEL 原生 · 未透传清空当前选择值。—
resizeTextareaEL 原生 · 未透传重新计算 textarea 高度。—