更新记录

0.1.3(2025-09-15) 下载此版本

  • fix: 修复uniapp 无法显示的问题

0.1.2(2025-08-31) 下载此版本

  • chore: 更新文档

0.1.1(2025-05-09) 下载此版本

  • fix: 设置格子宽度不生效的问题
  • feat: 组件增加提示
查看更多

平台兼容性

uni-app(4.74)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- 5.0
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - -

uni-app x(4.75)

Chrome Safari Android iOS 鸿蒙 微信小程序
5.0

其他

多语言 暗黑模式 宽屏模式
× ×

lime-code-input 验证码输入框

一个验证码输入框组件,也可用作密码输入框,支持明文和密文显示,可自定义长度、间距和样式。

插件依赖:lime-sharedlime-style

文档链接

📚 组件详细文档请访问以下站点:

安装方法

  1. 在uni-app插件市场中搜索并导入lime-code-input
  2. 首次导入可能需要重新编译

代码演示

基础使用

通过v-model双向绑定值

<l-code-input v-model="value"></l-code-input>
const value = ref('')

自定义长度

通过length属性来设置码长度

<l-code-input v-model="value"></l-code-input>
const value = ref('')

明文展示

mask 设置为 false 可以明文展示输入的内容,适用于短信验证码等场景。

<l-code-input v-model="value" :mask="false"></l-code-input>
const value = ref('')

提示信息

通过 info 属性设置提示信息,通过 error-info 属性设置错误提示,例如当输入六位时提示密码错误。

<l-code-input v-model="value" info="请输入验证码" :error-info="errorInfo"></l-code-input>
const value = ref('')
const errorInfo = ref('')

watch(value, (newVal) => {
    if (newVal.length == 6 && newVal != '***') {
        errorInfo.value = '密码错误';
    } else {
        errorInfo.value = '';
    }
});

Vue2使用说明

本插件使用了composition-api,请按照官方教程配置。

关键配置代码(在main.js中添加):

// main.js
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

快速预览

导入插件后,可以直接使用以下标签查看演示效果:

<!-- 代码位于 uni_modules/lime-code-input/components/lime-code-input -->
<lime-code-input />

插件标签说明

  • l-code-input:验证码输入框组件
  • lime-code-input:演示标签

API文档

Props

参数 说明 类型 默认值
v-model 密码值 string -
value 密码值 string -
info 输入框下方文字提示 string -
errorInfo 输入框下方错误提示 string -
length 密码最大长度 number 6
gutter 输入框格子之间的间距,如 20px 20rpx,默认单位为px string 20rpx
mask 是否隐藏密码内容 boolean true
focused 是否已聚焦,聚焦时会显示光标 boolean false
line 是否使用下划线模式 boolean false
borderColor 描边色 string -
width 格子宽度 string -
height 格子高度 string -
radius 格子圆角 string -
fontSize 字体大小 string -
activeBgColor 激活格子背景色 string -
activeBorderColor 激活格子描边色 string -
color 文本色 string -
bgColor 格子背景色 string -
cursorColor 光标色 string -
disabledKeyboard 禁用系统键盘 boolean false
disabledDot 禁输入. boolean true
insertAt 指定位置插入符号,{index:2, symbol:'*'} object -
lastElementStyle 最后一个元素样式 string -
lastElementPlaceholder 最后一个元素占位提示 string -
lastElementPlaceholderStyle 最后一个元素占位提示样式 string -
type input的类型,参考input组件 string -

Events

事件名 说明 回调参数
change 值变化时触发 event: string
focus 聚焦时触发 -
finish 完成时 event: string

Slots

插槽名 说明 回调参数
line 线条 active: boolean

主题定制

组件提供了下列CSS变量,可用于自定义样式。

变量名称 默认值 说明
code-input-height 50px 输入框整体高度
code-input-font-size 20px 输入文字大小
code-input-radius $spacer-tn 输入框圆角半径
code-input-bg-color $gray-1 输入框背景色
code-input-text-color $text-color-1 输入文字颜色
code-input-info-color $text-color-3 提示文字颜色
code-input-error-info-color $error-color 错误提示颜色
code-input-dot-color $text-color-1 密码点颜色
code-input-cursor-color $text-color-1 光标颜色
code-input-dot-size 10px 密码点大小
code-input-info-font-size $font-size 提示文字大小
code-input-cursor-width 1px 光标宽度
code-input-cursor-height 40% 光标高度比例
code-input-cursor-duration 1s 光标闪烁速度

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者: 支付宝赞助 微信赞助

隐私、权限声明

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

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

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

许可协议

MIT协议