Vant3 PasswordInput 密碼輸入框

介紹

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

實例演示

引入

通過以下方式來全局注冊組件，更多注冊方式請參考組件注冊。

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

const app = createApp();
app.use(PasswordInput);
app.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"
/>

import { ref } from 'vue';

export default {
  setup() {
    const value = ref('123');
    const showKeyboard = ref(true);

    return {
      value,
      showKeyboard,
    };
  },
};

自定義長度

通過 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 可以明文展示輸入的內容，適用于短信驗證碼等場景。

<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"
/>

import { ref, watch } from 'vue';

export default {
  setup() {
    const value = ref('123');
    const errorInfo = ref('');
    const showKeyboard = ref(true);

    watch(value, (newVal) => {
      if (newVal.length === 6 && newVal !== '123456') {
        errorInfo.value = '密碼錯誤';
      } else {
        errorInfo.value = '';
      }
    });

    return {
      value,
      errorInfo,
      showKeyboard,
    };
  },
};

API

Props

Events

樣式變量

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