codecamp

Vant3 PasswordInput 密码输入框

介绍

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

实例演示

引入

通过以下方式来全局注册组件,更多注册方式请参考组件注册

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

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

代码演示

基础用法

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


<!-- 密码输入框 -->
<van-password-input
  :value="value"
  :focused="showKeyboard"
  @focus="showKeyboard = true"
/>
<!-- 数字键盘 -->
<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 位数字"
  :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

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

Events

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

样式变量

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

名称 默认值 描述
--van-password-input-height 50px -
--van-password-input-margin 0 var(--van-padding-md) -
--van-password-input-font-size 20px -
--van-password-input-border-radius 6px -
--van-password-input-background-color var(--van-white) -
--van-password-input-info-color var(--van-gray-6) -
--van-password-input-info-font-size var(--van-font-size-md) -
--van-password-input-error-info-color var(--van-danger-color) -
--van-password-input-dot-size 10px -
--van-password-input-dot-color var(--van-black) -
--van-password-input-cursor-color var(--van-text-color) -
--van-password-input-cursor-width 1px -
--van-password-input-cursor-height 40% -
--van-password-input-cursor-animation-duration 1s -


Vant3 NumberKeyboard 数字键盘
Vant3 Picker 选择器
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

Vant3 废弃内容

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }