介紹

帶網(wǎng)格的輸入框組件，可以用于輸入密碼、短信驗證碼等場景，通常與數(shù)字鍵盤組件配合使用。

引入

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

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

代碼演示

基礎用法

搭配數(shù)字鍵盤組件來實現(xiàn)密碼輸入功能。

<!-- 密碼輸入框 -->
<van-password-input
  :value="value"
  :focused="showKeyboard"
  @focus="showKeyboard = true"
/>
<!-- 數(shù)字鍵盤 -->
<van-number-keyboard
  v-model="value"
  :show="showKeyboard"
  @blur="showKeyboard = false"
/>

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

自定義長度

通過 length 屬性來設置密碼長度。

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

格子間距

通過 gutter 屬性來設置格子之間的間距。

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

明文展示

將 mask 設置為 false 可以明文展示輸入的內(nèi)容，適用于短信驗證碼等場景。

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

提示信息

通過 info 屬性設置提示信息，通過 error-info 屬性設置錯誤提示，例如當輸入六位時提示密碼錯誤。

<van-password-input
  :value="value"
  info="密碼為 6 位數(shù)字"
  :error-info="errorInfo"
  :focused="showKeyboard"
  @focus="showKeyboard = true"
/>
<van-number-keyboard
  v-model="value"
  :show="showKeyboard"
  @blur="showKeyboard = false"
/>

export default {
  data() {
    return {
      value: '123',
      errorInfo: '',
      showKeyboard: true,
    };
  },
  watch: {
    value(value) {
      if (value.length === 6 && value !== '123456') {
        this.errorInfo = '密碼錯誤';
      } else {
        this.errorInfo = '';
      }
    },
  },
};

API

Props

Events

樣式變量

組件提供了下列 Less 變量，可用于自定義樣式，使用方法請參考主題定制。