更新记录

1.0.0(2024-07-10) 下载此版本

新增


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × ×

hbxw-code-input组件

介绍

一个高度可定制的验证码输入组件

使用示例

使用前要以新建一个页面拷贝下面代码做一下测试,熟悉后再使用到项目中


<template>
    <view class="">
        <text class="title">基础使用</text>
        <hbxw-code-input @input="input" />
        <hbxw-code-input styleType="line" />
        <text class="title">双向绑定</text>
        {{codeVal}}
        <hbxw-code-input v-model:value="codeVal" />
        <button size="mini" @click="codeValChange">codeVal change</button>

        <text class="title">父级定宽自动填充</text>
        <view style="width: 480rpx">
            <hbxw-code-input :len="5" />
            <hbxw-code-input :len="5" styleType="line" />
        </view>

        <text class="title">高度自定义</text>
        <hbxw-code-input 
            width="80rpx" 
            cursorColor="red" 
            borderColor="red" 
            bgColor="yellow"
            inputType="text"
            :len="5"
            :itemStyle="{borderRadius: '10rpx','boxShadow': '0 0 5rpx rgba(0,0,0,0.3)'}"
        />
    </view>
</template>

<script>
    export default {
        data() {
            return {
                codeVal: '123'
            }
        },
        watch: {
            codeVal(newVal, oldVal) {
                console.log('---- watch value ----:', newVal);
            }
        },
        methods: {
            input(e) {
                console.log('---- input ----:', e);
            },
            codeValChange() {
                this.codeVal = '456';
            }
        }
    }
</script>

<style scoped>
.title{
    display: flex;
    padding: 20rpx 10rpx;
    font-size: 32rpx;
}
</style>

API

Props

属性名 类型 默认值 必填 说明
value String '' 验证码初始值,支持v-model:value实现双向绑定
len Number 6 验证码长度
inputType String number 验证码input的type设置
height String/Number 80 验证码格子输入框高度
width String/Number '' 验证码格子输入框宽度,默认除去gap值后填满父级
gap String/Number 10 验证码格子输入框间隙
cursorColor String #999 光标颜色
borderColor String #ccc 验证码格子输入框边框颜色
bgColor String transparent 验证码格子输入框背影颜色
fontSize String/Number 40 验证码格子输入框字体大小
itemStyle Object {} 验证码格子输入框样式自定义
styleType String rect 验证码格子输入框款式,rect(格式)/line(下划线)

Events

事件名 说明 返回值
input 验证码输入触发事件 当前验证码值

注意事项

无法单独对某一位验证码执行修改,想改得先删除到指定位置再修改 点击验证框会让最后一位聚焦,而不是当前点击的项

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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