Vant4 PasswordInput 密碼輸入框

介紹

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

引入

通過(guò)以下方式來(lái)全局注冊(cè)組件，更多注冊(cè)方式請(qǐng)參考組件注冊(cè)。

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

const app = createApp();
app.use(PasswordInput);
app.use(NumberKeyboard);

代碼演示

基礎(chǔ)用法

搭配數(shù)字鍵盤組件來(lái)實(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,
    };
  },
};

自定義長(zhǎng)度

通過(guò) ?length? 屬性來(lái)設(shè)置密碼長(zhǎng)度。

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

格子間距

通過(guò) ?gutter? 屬性來(lái)設(shè)置格子之間的間距。

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

明文展示

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

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

提示信息

通過(guò) ?info? 屬性設(shè)置提示信息，通過(guò) ?error-info? 屬性設(shè)置錯(cuò)誤提示，例如當(dāng)輸入六位時(shí)提示密碼錯(cuò)誤。

<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 = '密碼錯(cuò)誤';
      } else {
        errorInfo.value = '';
      }
    });

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

API

Props

Events

類型定義

組件導(dǎo)出以下類型定義：

import type { PasswordInputProps } from 'vant';

主題定制

樣式變量

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