Vant NumberKeyboard 數(shù)字鍵盤(pán)

2022-05-31 11:58 更新

介紹

數(shù)字鍵盤(pán),提供兩種樣式風(fēng)格,可以與密碼輸入框或自定義的輸入框組件配合使用

引入

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

Vue.use(NumberKeyboard);

代碼演示

默認(rèn)樣式

<van-button @touchstart.stop="show = true">
  彈出默認(rèn)鍵盤(pán)
</van-button>
<van-number-keyboard
  :show="show"
  extra-key="."
  close-button-text="完成"
  @blur="show = false"
  @input="onInput"
  @delete="onDelete"
/>
import { Toast } from 'vant';

export default {
  data() {
    return {
      show: true
    }
  },
  methods: {
    onInput(value) {
      Toast(value);
    },
    onDelete() {
      Toast('刪除');
    }
  }
}

自定義樣式

<van-number-keyboard
  :show="show"
  theme="custom"
  extra-key="."
  close-button-text="完成"
  @blur="show = false"
  @input="onInput"
  @delete="onDelete"
/>

雙向綁定

可以通過(guò)v-model綁定鍵盤(pán)當(dāng)前輸入值

<van-field
  readonly
  clickable
  :value="value"
  @touchstart.native.stop="show = true"
/>

<van-number-keyboard
  v-model="value"
  :show="show"
  :maxlength="6"
  @blur="show = false"
/>
export default {
  data() {
    return {
      show: false,
      value: ''
    }
  }
}

左下角按鍵內(nèi)容

通過(guò)extra-key屬性可以設(shè)置左下角按鍵內(nèi)容

<van-button plain type="primary" @touchstart.stop="show = true'">
  彈出身份證號(hào)碼鍵盤(pán)
</van-button>

<van-number-keyboard
  :show="show"
  close-button-text="完成"
  extra-key="X"
  @blur="show = false"
  @input="onInput"
  @delete="onDelete"
/>

鍵盤(pán)標(biāo)題

通過(guò)title屬性可以設(shè)置鍵盤(pán)標(biāo)題

<van-button plain type="info" @touchstart.stop="show = true'">
  彈出自定義標(biāo)題鍵盤(pán)
</van-button>

<van-number-keyboard
  :show="show"
  close-button-text="完成"
  title="鍵盤(pán)標(biāo)題"
  extra-key="."
  @blur="show = false"
  @input="onInput"
  @delete="onDelete"
/>

API

Props

參數(shù)說(shuō)明類(lèi)型默認(rèn)值
v-model v2.0.2當(dāng)前輸入值string-
show是否顯示鍵盤(pán)boolean-
theme樣式風(fēng)格,可選值為 default customstringdefault
title鍵盤(pán)標(biāo)題string-
maxlength v2.0.2輸入值最大長(zhǎng)度number | string-
transition是否開(kāi)啟過(guò)場(chǎng)動(dòng)畫(huà)booleantrue
z-index鍵盤(pán) z-indexnumber | string100
extra-key左下角按鍵內(nèi)容string''
close-button-text關(guān)閉按鈕文字,空則不展示string-
delete-button-text刪除按鈕文字string刪除
show-delete-key是否展示刪除按鈕booleantrue
hide-on-click-outside點(diǎn)擊外部時(shí)是否收起鍵盤(pán)booleantrue
safe-area-inset-bottom是否開(kāi)啟 底部安全區(qū)適配booleantrue

Events

事件名說(shuō)明回調(diào)參數(shù)
input點(diǎn)擊按鍵時(shí)觸發(fā)key: 按鍵內(nèi)容
delete點(diǎn)擊刪除鍵時(shí)觸發(fā)-
close點(diǎn)擊關(guān)閉按鈕時(shí)觸發(fā)-
blur點(diǎn)擊關(guān)閉按鈕或非鍵盤(pán)區(qū)域時(shí)觸發(fā)-
show鍵盤(pán)完全彈出時(shí)觸發(fā)-
hide鍵盤(pán)完全收起時(shí)觸發(fā)-

Slots

名稱(chēng)說(shuō)明
delete自定義刪除按鍵內(nèi)容
extra-key自定義左下角按鍵內(nèi)容
title-left自定義標(biāo)題欄左側(cè)內(nèi)容

常見(jiàn)問(wèn)題

在桌面端無(wú)法操作組件?

參見(jiàn)在桌面端使用。


實(shí)例演示

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)