更新记录
0.0.1(2024-12-06)
下载此版本
首次发布
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.95 app-vue app-nvue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
√ |
√ |
√ |
√ |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
PanKeyboard 组件文档
概述
PanKeyboard
是一个自定义键盘组件,适用于需要数字输入的场景。支持小数输入、数值限制及自定义提交按钮文本等功能。
属性 (Props)
属性名 |
类型 |
默认值 |
描述 |
isDecimal |
Boolean |
true |
是否允许输入小数 |
submitButtonText |
String |
'确定' |
提交按钮的文本 |
toFixed |
String 或 Number |
2 |
小数点后的保留位数,最大为3 |
maxValue |
String 或 Number |
100000000 |
输入的最大值,默认为1亿 |
isCheck |
Boolean |
true |
提交按钮是否通过校验 |
方法 (Methods)
方法名 |
参数 |
描述 |
setKeyboard(e) |
e (String 或 Number) |
直接设置输入框的值,并触发 onChange 事件 |
事件 (Events)
事件名 |
参数 |
描述 |
onChange |
value (Object) |
输入值发生变化时触发,返回当前输入值的详细信息 |
onSubmit |
value (Object) |
点击提交按钮且通过校验时触发,返回当前输入值的详细信息 |
onError |
error (String) |
发生错误时触发,返回错误信息 |
返回值 (Return Value)
当触发 onChange
和 onSubmit
事件时,返回值是一个对象,包含以下属性:
属性名 |
类型 |
描述 |
valueToLocaleString |
String |
输入值的本地化字符串表示 |
valueNumber |
Number |
输入值的数字表示 |
valueText |
String |
输入值的大写表示 |
enterAmount |
String |
原始输入值 |
示例用法
<template>
<div>
<pan-keyboard
:isDecimal="true"
:submitButtonText="'确认'"
:toFixed="2"
:maxValue="10000"
:isCheck="true"
@onChange="handleInputChange"
@onSubmit="handleSubmit"
@onError="handleError"
/>
</div>
</template>
<script>
export default {
data() {
return {
};
},
methods: {
handleInputChange(value) {
console.log('Input changed:', value);
},
handleSubmit(value) {
console.log('Form submitted:', value);
},
handleError(error) {
console.error('Error occurred:', error);
}
}
};
</script>
注意事项
- 小数输入:当
isDecimal
为 false
时,键盘将不显示小数点按键。
- 数值限制:输入值不能超过
maxValue
,否则会触发 onError
事件。
- 提交按钮:提交按钮的状态由
isCheck
控制,未通过校验时按钮将不可点击。
- 设置初始值: 调用组件实例
this.$refs.PanKeyboard.setKeyboard(1000)
希望这份文档能帮助你更好地理解和使用 PanKeyboard
组件。如果有任何问题或建议,请随时联系。