更新记录
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