更新记录

0.0.1(2024-12-06) 下载此版本

首次发布

  • 键盘组件;转账静态页面

平台兼容性

Vue2 Vue3
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 StringNumber 2 小数点后的保留位数,最大为3
maxValue StringNumber 100000000 输入的最大值,默认为1亿
isCheck Boolean true 提交按钮是否通过校验

方法 (Methods)

方法名 参数 描述
setKeyboard(e) e (String 或 Number) 直接设置输入框的值,并触发 onChange 事件

事件 (Events)

事件名 参数 描述
onChange value (Object) 输入值发生变化时触发,返回当前输入值的详细信息
onSubmit value (Object) 点击提交按钮且通过校验时触发,返回当前输入值的详细信息
onError error (String) 发生错误时触发,返回错误信息

返回值 (Return Value)

当触发 onChangeonSubmit 事件时,返回值是一个对象,包含以下属性:

属性名 类型 描述
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>

注意事项

  1. 小数输入:当 isDecimalfalse 时,键盘将不显示小数点按键。
  2. 数值限制:输入值不能超过 maxValue,否则会触发 onError 事件。
  3. 提交按钮:提交按钮的状态由 isCheck 控制,未通过校验时按钮将不可点击。
  4. 设置初始值: 调用组件实例this.$refs.PanKeyboard.setKeyboard(1000)

希望这份文档能帮助你更好地理解和使用 PanKeyboard 组件。如果有任何问题或建议,请随时联系。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问