n-keyboard-plate 车牌键盘

底部弹层形态的车牌录入键盘（遮罩 + 底部面板 + 双页键区），用于停车缴费、违章查询、加油充电等不想调起系统输入法的车牌录入场景。

1. 双页键区由已输入值驱动：值为空显示省份页（31 个简称按大区分组 + 使字头），有值显示字母数字页（含学警港澳领挂尾字符键）——按下任一字符键自动切页、退格到空自动回切，无需手动切换键；页面切换是键盘自身导航状态，不对外派发事件
2. 按键可用性按真实车牌规范（GA36）随输入位置禁用：1 位发牌机关字母（不含 I/O）、2 位起序号（字母/数字）、学警港澳领挂仅作 7 位牌末位（已输 6 位时可选，输后即满牌）、使馆牌 = 使 + 6 位数字（选使后字母页只出数字，满 7 位即收），I/O 全程禁用——不可选的键置灰显示、点击不生效，不隐藏不移除
3. 值双通道（与 n-input 同构）：绑 v-model 时按键自动拼接、退格自动去尾、超 maxlength 不拼接（input 事件仍上报）；字符组合的业务校验（如机关代号是否真实存在）仍由业务侧完成。maxlength 是组件不变量：运行中收紧上限或外部写入超限值时，组件自动截断收敛并回写 v-model（-1 不限）
4. 受控显隐：visible 置 true 打开；组件不自行收起——点遮罩/关闭按钮派发 close、点完成派发 complete，隐藏由使用者在回调里把 visible 改回 false
5. 功能键文案（删除/完成）随库语言包走；省份简称与字母数字是字符本身，不参与多语言

平台兼容性

App	H5	微信小程序	支付宝小程序	百度小程序	头条小程序	QQ小程序
√	√	√	×	×	×	×

API

属性

参数	说明	类型	默认值	可选值
visible	显隐开关（受控模式：打开后组件不自行收起，隐藏由使用者在回调里改回 false）	Boolean	false	-
model-value	已输入车牌（v-model）：绑定时按键自动拼接/退格去尾，空值显示省份页、非空显示字母数字页	String	""	-
maxlength	已输入值长度上限（默认 8 = 新能源车牌上限，普通车牌业务传 7），超限后按键不再拼接、input 事件仍上报；-1 = 不限	Number	8	-
title	标题栏文字（如 "请输入车牌号"），空串 = 不渲染标题栏	String	""	-
show-close	标题栏右侧显示关闭按钮（点击派发 close 事件；无标题时标题栏只渲染该按钮）	Boolean	false	-
show-value	面板顶部回显条：实时展示已输入车牌（第 2 位后插分隔点）；空值不渲染；弹层常遮挡页面上的槽位框，输入进度需在拇指上方可见；页面已在键盘上方展示输入框时可关掉避免重复	Boolean	true	-
close-on-mask	点击遮罩派发 close 事件；关闭后遮罩点击无响应，只能经完成键/关闭按钮退出	Boolean	true	-
complete-text	完成键文案（查询等场景传 "查询"），空串 = 用库内置文案（随库语言包）	String	""	-
custom-class	挂到根节点的额外 class（类需定义在组件样式表内）	String	""	-
custom-style	根节点行内样式（根节点是弹层全屏透明层，调 z-index 等场景使用）	String	""	与 css 相同
panel-style	微调底部面板的行内样式，如 "background-color:#111111"	String	""	与 css 相同

事件

事件名	说明	回调参数
update:model-value	按键拼接/退格去尾后的新值（v-model 通道，超限不拼接时不发）	新值字符串
input	点击省份/字母/数字/特殊键时触发	键值字符（如 "川"、"A"、"7"、"挂"）
delete	点击删除键时触发（v-model 值已自动去尾，退格到空自动回省份页）	事件对象
close	点击遮罩（closeOnMask 开启时）或标题栏关闭按钮时触发	-
complete	点击完成键时触发（组件不自行收起，隐藏由使用者改 visible）	事件对象

新窗口 ↗

演示加载中…

示例代码加载中…