MessageInput 验证码输入

该组件一般用于验证用户短信验证码的场景,也可以结合uView的键盘组件使用

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过mode参数模式,可取如下值:
  • box(默认)-输入位置位一个方框
  • bottomLine-底部显示一条横线
  • middleLine-中部显示一条横线
  1. <u-message-input mode="bottomLine"></u-message-input>

设置最大长度和初始值

  • 通过maxlength参数配置可输入的方框个数,如5位验证码,该值设置为5即可
  • 如果需要显示默认值,请通过value参数配置
  1. <u-message-input maxlength="5" value="46821"></u-message-input>

是否自动获取焦点

如果需要一打开页面,就自动弹出键盘获取焦点,请配置focus值为true,否则需要用户手动点击输入区域才能唤起键盘

  1. <u-message-input :focus="true"></u-message-input>

配置呼吸灯效果

配置breathetrue,当前激活输入框的样式会有一个类似光标一闪一闪的由浅到深的效果

  1. <u-message-input :breathe="true"></u-message-input>

用”●”替代输入内容

dot-fill参数配置后,输入内容将不可见,用点替代,事件回调中会返回真实值

  1. <u-message-input :dot-fill="true"></u-message-input>

事件回调

  • 每当输入内容发生改变,会回调一个change事件,内容为当前输入的字符串,如”395”
  • 当输入的内容长度(字符个数)达到maxlength值后,会触发finish事件,同时也会触发change事件
  1. <template>
  2. <view>
  3. <u-message-input @change="change" @finish="finish"></u-message-input>
  4. </view>
  5. </template>
  6. <script>
  7. export default {
  8. methods: {
  9. change(e) {
  10. console.log('内容改变,当前值为:' + e);
  11. },
  12. finish(e) {
  13. console.log('输入结束,当前值为:' + e);
  14. },
  15. }
  16. }
  17. </script>

API

Props

参数说明类型默认值可选值
maxlength输入字符个数String | Number4-
dot-fill是否用圆点填充Booleanfalsetrue
mode模式选择,见上方”基本使用”说明StringboxbottomLine / middleLine
value预置值String | Number--
breathe是否开启呼吸效果,见上方说明Booleantruefalse
focus是否自动获取焦点Booleanfalsetrue
bold字体和输入横线是否加粗Booleantruefalse
font-size字体大小,单位rpxString | Number60-
active-color当前激活输入框的样式String#2979ff-
focus非激活输入框的样式,文字颜色同此值String#606266-
width输入框的宽度(高等于宽),单位rpxString | Number80-

Events

事件名说明回调参数版本
change输入内容发生改变时触发,具体见上方说明value:当前输入的值-
finish输入字符个数达maxlength值时触发,见上方说明value:当前输入的值-