t-keyboard

Keyboard 键盘

组件介绍

自定义键盘组件，支持车牌键盘、数字键盘、身份证键盘，提供安全的输入方式。

平台兼容

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

基础用法

<template>
  <view class="keyboard-demo">
    <t-button type="primary" @click="openCarKeyboard">打开车牌键盘</t-button>
    <t-button type="primary" @click="openNumberKeyboard">打开数字键盘</t-button>
    <t-button type="primary" @click="openIdcardKeyboard">打开身份证键盘</t-button>
    <t-text>输入结果: {{ inputValue }}</t-text>
    
    <t-keyboard ref="keyboardRef" mode="car" @input="handleInput" @confirm="handleConfirm" @cancel="handleCancel"></t-keyboard>
  </view>
</template>

<script setup>
const keyboardRef = ref(null);
const inputValue = ref('');
const currentMode = ref('car');

function openCarKeyboard() {
  currentMode.value = 'car';
  keyboardRef.value.show();
}

function openNumberKeyboard() {
  currentMode.value = 'number';
  keyboardRef.value.show();
}

function openIdcardKeyboard() {
  currentMode.value = 'idcard';
  keyboardRef.value.show();
}

function handleInput(data) {
  console.log('输入:', data);
  inputValue.value = data;
}

function handleConfirm(data) {
  console.log('确认:', data);
  inputValue.value = data;
}

function handleCancel() {
  console.log('取消');
}
</script>

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

Props

属性名	类型	默认值	说明	可选值
size	String	"medium"	组件尺寸	large, medium, small, mini
type	String	"primary"	组件类型	info, primary, error, warning, success
disabled	Boolean	false	组件是否禁用	true, false
hover	Boolean	false	是否有点击效果	true, false
path	String	""	点击组件后跳转的页面路径	-
effect	String	""	组件显示主题	normal, dark, light, plain
mode	String	"car"	键盘类型	car, number, idcard
inactiveColor	String	"#E4E7ED"	键盘未激活时的颜色	-
activeColor	String	""	键盘激活时的颜色	-
value	Array	[]	默认值	-

Events

事件名	说明	回调参数
input	输入时触发	输入的值
back	后退时触发	-
confirm	点击确认时触发	确认的值
cancel	点击取消时触发	-
clear	清除按钮时触发	-
close	关闭时触发	-
click	点击时触发	-
transitionend	动画结束时触发	-
initFinished	组件初始化完成触发	组件的节点信息
touchstart	触摸开始时触发	触摸事件对象
touchend	触摸结束时触发	触摸事件对象
touchmove	触摸移动时触发	触摸事件对象
touchcancel	触摸取消时触发	触摸事件对象

Methods

方法名	说明	参数	返回值
show	显示键盘	无	无
hide	隐藏键盘	无	无

Mode 说明

模式	说明
car	车牌键盘，支持输入车牌号码
number	数字键盘，支持输入数字
idcard	身份证键盘，支持输入身份证号码