更新记录

1.0.0（2026-06-03） 下载此版本

1.0.0

• 新增车牌号输入键盘组件。
• 支持省份简称、字母数字输入、删除、完成和遮罩关闭。
• 新增车牌号规范化、格式化、校验工具函数。

平台兼容性

uni-app(3.7.8)

qcwh-platekeyboard 车牌号专属输入键盘

适用于 uni-app 的车牌号输入键盘组件，按车牌输入顺序限制可选字符：

• 第一位展示省份简称。
• 第二位仅允许大写英文字母。
• 后续位允许大写英文字母和数字。
• 支持 7 位普通车牌和 8 位新能源车牌。
• 提供格式化、规范化、校验工具函数。

安装

从插件市场导入后，组件会放在：

uni_modules/qcwh-platekeyboard

组件符合 easycom 规范，页面中可直接使用：

<qcwh-platekeyboard />

基础用法

<template>
    <view>
        <view @tap="showKeyboard = true">
            {{ formatPlateNumber(carNumber) || '请输入车牌号' }}
        </view>

        <qcwh-platekeyboard
            v-model="carNumber"
            :show="showKeyboard"
            @update:show="showKeyboard = $event"
        />
    </view>
</template>

<script setup>
import { ref } from 'vue'
import { formatPlateNumber, isValidPlateNumber } from '@/uni_modules/qcwh-platekeyboard'

const carNumber = ref('')
const showKeyboard = ref(false)

const submit = () => {
    if (!isValidPlateNumber(carNumber.value, true)) {
        uni.showToast({ title: '请输入正确的车牌号', icon: 'none' })
    }
}
</script>

Props

Events

工具函数

import {
    normalizePlateNumber,
    formatPlateNumber,
    isValidPlateNumber
} from '@/uni_modules/qcwh-platekeyboard'

发布注意

上传插件市场时，只需要提交 uni_modules/qcwh-platekeyboard 目录。不要包含项目根目录的 manifest.json、pages.json、App.vue、main.js，也不要包含 node_modules、unpackage、.git 等目录。