PasswordInput 密码输入框

介绍

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

引入

  1. import { createApp } from 'vue';
  2. import { PasswordInput, NumberKeyboard } from 'vant';
  3. const app = createApp();
  4. app.use(PasswordInput);
  5. app.use(NumberKeyboard);

代码演示

基础用法

搭配数字键盘组件来实现密码输入功能。

  1. <!-- 密码输入框 -->
  2. <van-password-input
  3. :value="value"
  4. :focused="showKeyboard"
  5. @focus="showKeyboard = true"
  6. />
  7. <!-- 数字键盘 -->
  8. <van-number-keyboard
  9. v-model="value"
  10. :show="showKeyboard"
  11. @blur="showKeyboard = false"
  12. />
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const value = ref('123');
  5. const showKeyboard = ref(true);
  6. return {
  7. value,
  8. showKeyboard,
  9. };
  10. },
  11. };

自定义长度

通过 length 属性来设置密码长度。

  1. <van-password-input
  2. :value="value"
  3. :length="4"
  4. :focused="showKeyboard"
  5. @focus="showKeyboard = true"
  6. />

格子间距

通过 gutter 属性来设置格子之间的间距。

  1. <van-password-input
  2. :value="value"
  3. :gutter="10"
  4. :focused="showKeyboard"
  5. @focus="showKeyboard = true"
  6. />

明文展示

mask 设置为 false 可以明文展示输入的内容,适用于短信验证码等场景。

  1. <van-password-input
  2. :value="value"
  3. :mask="false"
  4. :focused="showKeyboard"
  5. @focus="showKeyboard = true"
  6. />

提示信息

通过 info 属性设置提示信息,通过 error-info 属性设置错误提示,例如当输入六位时提示密码错误。

  1. <van-password-input
  2. :value="value"
  3. info="密码为 6 位数字"
  4. :error-info="errorInfo"
  5. :focused="showKeyboard"
  6. @focus="showKeyboard = true"
  7. />
  8. <van-number-keyboard
  9. v-model="value"
  10. :show="showKeyboard"
  11. @blur="showKeyboard = false"
  12. />
  1. import { ref, watch } from 'vue';
  2. export default {
  3. setup() {
  4. const value = ref('123');
  5. const errorInfo = ref('');
  6. const showKeyboard = ref(true);
  7. watch(value, (newVal) => {
  8. if (newVal.length === 6 && newVal !== '123456') {
  9. errorInfo.value = '密码错误';
  10. } else {
  11. errorInfo.value = '';
  12. }
  13. });
  14. return {
  15. value,
  16. errorInfo,
  17. showKeyboard,
  18. };
  19. },
  20. };

API

Props

参数说明类型默认值
value密码值string‘’
info输入框下方文字提示string-
error-info输入框下方错误提示string-
length密码最大长度number | string6
gutter输入框格子之间的间距,如 20px 2em,默认单位为pxnumber | string0
mask是否隐藏密码内容booleantrue
focused是否已聚焦,聚焦时会显示光标booleanfalse

Events

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

样式变量

组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制

名称默认值描述
@password-input-height50px-
@password-input-margin0 @padding-md-
@password-input-font-size20px-
@password-input-border-radius6px-
@password-input-background-color@white-
@password-input-info-color@gray-6-
@password-input-info-font-size@font-size-md-
@password-input-error-info-color@red-
@password-input-dot-size10px-
@password-input-dot-color@black-

PasswordInput 密码输入框 - 图1