t-keyboard-idcard

KeyboardIdcard 身份证键盘

组件介绍

t-keyboard-idcard 基于 Canvas 绘制的身份证专用键盘，支持数字输入和 X 字符，右侧带有确认和退格按钮，适用于身份证号输入场景。

平台兼容

Harmony	H5	Android	iOS	小程序	UTS
✅	✅	✅	✅	✅	✅

基础用法

基础用法参考 demo/keyboard/keyboard.uvue。

<template>
  <view class="keyboard-idcard-demo">
    <t-input v-model="idcard" placeholder="请输入身份证号" readonly @click="showKeyboard = true"></t-input>
    
    <t-popup v-model="showKeyboard" direction="bottom">
      <t-keyboard-idcard 
        type="primary"
        @input="onInput"
        @back="onBack"
        @confirm="onConfirm">
      </t-keyboard-idcard>
    </t-popup>
  </view>
</template>

<script setup>
const idcard = ref('');
const showKeyboard = ref(false);

function onInput(val) {
  if (idcard.value.length < 18) {
    idcard.value += val;
  }
}

function onBack() {
  idcard.value = idcard.value.slice(0, -1);
}

function onConfirm() {
  console.log('身份证号:', idcard.value);
  showKeyboard.value = false;
}
</script>

<style scoped>
.keyboard-idcard-demo {
  padding: 40rpx;
}
</style>

Props

属性名	说明	类型	默认值
path	点击组件后跳转的页面路径；为空时仅响应事件	string	''
hover	是否启用点击效果	boolean	false
type	组件主题类型，可选 info、primary、error、warning、success	string	'primary'
disabled	是否禁用	boolean	false
effect	组件显示主题，可选 normal、dark、light、plain	string	'normal'
size	组件尺寸，可选 large、medium、small、mini	string	'medium'

Events

事件名	说明	回调参数
input	输入时触发	string（输入的字符）
back	点击退格时触发	-
confirm	点击确认按钮时触发	-