更新记录

1.2.0(2026-11-18)

  • 乱序模式扩展:开启 random-keyboard 时,字母页全部 26 个字母也参与随机重排(功能键位置固定)
  • 数字页与字母页共用同一次乱序种子,每次弹出键盘同步重新洗牌
  • 输入区域改为强制单行排版:支付方格等分不换行,普通密码框超长横向滚动
  • 关闭乱序时字母页按 QWERTY 常规布局排列(非 a-z 顺序)
  • 修复字母键点击无灰色反馈的问题:改用专用 hover class 并提高优先级,数字/字母/功能键现均有按下变灰效果

平台兼容性

uni-app(4.51)

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

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× √ √ ×

muzi-inputPaswd 密码输入组件

双模式密码输入组件,两种模式均使用自绘自定义键盘,基于 Vue2 Options API + uni-app 官方组件实现,无第三方 UI 库依赖。兼容 Android App(最低 Android 10)、iOS App(最低 iOS 12)、微信小程序。

功能特性

  • 支付模式 mode="pay":密码方格 + 数字键盘,支持乱序/常规、输满自动提交或手动确认
  • 普通模式 mode="normal":密码显示框 + 数字/字母可切换键盘,支持大小写切换、显隐切换、清空
  • 安全乱序:randomKeyboard 控制数字键与字母键一起打乱,每次弹出重新洗牌,功能键位置固定
  • 双提交方式:autoComplete=true 输满自动提交(pay);false 时显示确认键(pay);normal 模式始终显示确认键
  • 错误反馈:error=true 自动抖动、清空并展示错误文案(可分别关闭抖动/清空)
  • 三保险主题:theme="auto" 跟随系统 prefers-color-scheme,theme="dark"/"light" 强制切换
  • 宽屏适配:组件与弹层均限制 max-width: 560px 并居中,pad 上不被拉伸
  • 完整事件与方法:所有交互均预留日志与事件,密码日志自动脱敏

基础用法

支付密码(数字键盘,输满自动提交):

<muzi-inputPaswd
  v-model="payPwd"
  mode="pay"
  :maxlength="6"
  :random-keyboard="true"
  :error="payError"
  @complete="onPayComplete"
/>

普通密码(数字/字母可切换键盘,点确认提交):

<muzi-inputPaswd
  v-model="loginPwd"
  mode="normal"
  placeholder="请输入密码"
  :maxlength="20"
  :random-keyboard="true"
  @confirm="onConfirm"
/>

两种模式都通过 v-model 获取明文密码,由使用方提交到服务端校验;校验失败将 error 置 true 即可触发错误反馈。

Props

参数 类型 默认值 说明
value String '' 密码值,支持 v-model
mode String 'pay' pay 支付方格 / normal 普通密码框,两者均用自定义键盘
maxlength Number 6 密码最大位数;normal 模式可传更大值(如 20)
autoComplete Boolean true 仅 pay 模式:输满是否自动提交;false 时显示确认键
randomKeyboard Boolean true 数字键与字母键是否乱序,每次弹出重新洗牌;功能键位置固定
error Boolean false 错误状态,置 true 触发抖动+清空+提示;对应事件为 error-tip
errorText String 密码错误,请重新输入 错误提示文字
title String 请输入支付密码 弹出面板标题
tipText String '' 面板提示文字,空时自动生成
confirmText String 确认 确认键文字
placeholder String 请输入密码 normal 模式占位文字
showToggle Boolean true normal 模式是否显示显隐切换
showClear Boolean true normal 模式是否显示清空按钮
disabled Boolean false 禁用输入与键盘
theme String 'auto' auto / light / dark
shakeOnError Boolean true 错误时是否抖动
clearOnError Boolean true 错误时是否清空

Events

事件名 回调参数 说明
input value 值变化(配合 v-model)
change value 值变化
complete value pay 模式密码输满并完成提交
confirm value normal 模式点击确认键 / pay 模式手动确认键
keydown {type, value} 按键按下;type 为 number / letter,value 为对应字符
delete - 删除键按下
clear - 清空按钮/方法触发
error-tip value 错误反馈触发(不命名为 error 是为避免与同名 prop 在 uni-app 编译器中冲突)
open / close - 键盘弹出 / 收起
focus / blur - 键盘弹出(获得焦点)/ 收起(失去焦点)
visible-change boolean normal 模式密码显隐切换

Methods(通过 ref 调用)

方法 说明
clear() 清空密码
openKeyboard() 唤起键盘(两种模式一致)
closeKeyboard() 收起键盘
focus() 唤起键盘
triggerError() 主动触发错误反馈

键盘说明

  • 数字页:3 列 4 行,randomKeyboard=true 时每次弹出重排 0-9,功能键位置固定;false 时为 1-9、0 常规顺序。
  • 字母页(仅 normal 模式):randomKeyboard=true 时每次弹出将全部 26 个字母随机重排到 26 个键位(仍按 10/9/7 三行排布);false 时按 QWERTY 常规布局(qwertyuiop / asdfghjkl / zxcvbnm);功能键(123/大小写/删除)位置固定;提供「大写/小写」切换,点击「123」返回数字页。
  • normal 模式每次弹出键盘默认从数字页开始;同一次弹出期间数字/字母来回切换时键位保持不变,再次弹出才重新乱序。
  • 两种模式共用同一个底部弹出层,点击遮罩或「完成」均可收起。
  • 所有按键(数字键、字母键、功能键)按下时均有变灰反馈,松开自动恢复。

平台兼容说明

  • App(Android 10+ / iOS 12+)与微信小程序均已适配,组件内无平台特有 API。
  • 暗黑模式:auto 依赖 prefers-color-scheme 媒体查询。微信小程序如需自动跟随系统主题,请在 app.json 增加 "darkmode": true;也可直接使用 theme="dark" 强制深色。
  • 键盘弹层为自绘 fixed 遮罩,非原生组件,三端表现一致;已通过 @touchmove.stop.prevent 阻止滚动穿透。

联系方式

  • 本人从事软件开发,如有问题或者开发需求请***:980823367

隐私、权限声明

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

无

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

无

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

无

暂无用户评论。