vant/src/password-input/README.zh-CN.md

PasswordInput 密码输入框

介绍

带网格的输入框组件，可以用于输入支付密码、短信验证码等，通常与数字键盘组件配合使用

引入

import Vue from 'vue';
import { PasswordInput, NumberKeyboard } from 'vant';

Vue.use(PasswordInput).use(NumberKeyboard);

代码演示

基础用法

<!-- 密码输入框 -->
<van-password-input
  :value="value"
  info="密码为 6 位数字"
  :focused="showKeyboard"
  @focus="showKeyboard = true"
/>

<!-- 数字键盘 -->
<van-number-keyboard
  :show="showKeyboard"
  @input="onInput"
  @delete="onDelete"
  @blur="showKeyboard = false"
/>

export default {
  data() {
    return {
      value: '123',
      showKeyboard: true
    };
  },

  methods: {
    onInput(key) {
      this.value = (this.value + key).slice(0, 6);
    },
    onDelete() {
      this.value = this.value.slice(0, this.value.length - 1);
    }
  }
}

自定义长度

<van-password-input
  :value="value"
  :length="4"
  :gutter="15"
  :focused="showKeyboard"
  @focus="showKeyboard = true"
/>

明文展示

<van-password-input
  :value="value"
  :mask="false"
  :focused="showKeyboard"
  @focus="showKeyboard = true"
/>

API

Props

参数	说明	类型	默认值	版本
value	密码值	string	''	-
length	密码最大长度	number	6	-
mask	是否隐藏密码内容	boolean	true	-
focused	是否已聚焦，聚焦时会显示光标	boolean	false	2.1.8
info	输入框下方文字提示	string	-	-
error-info	输入框下方错误提示	string	-	-
gutter	输入框格子之间的间距，如 20px 2em，默认单位为px	string | number	0	-

Events

事件名	说明	回调参数
focus	输入框聚焦时触发	-