Vant Search 搜索

2022-05-31 11:58 更新

引入

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

Vue.use(Search);

代碼演示

基礎(chǔ)用法

v-model 用于控制搜索框中的文字,background 可以自定義搜索框外部背景色

<van-search v-model="value" placeholder="請(qǐng)輸入搜索關(guān)鍵詞" />

事件監(jiān)聽

Search 組件提供了search和cancel事件,search事件在點(diǎn)擊鍵盤上的搜索/回車按鈕后觸發(fā),cancel事件在點(diǎn)擊搜索框右側(cè)取消按鈕時(shí)觸發(fā)

<form action="/">
  <van-search
    v-model="value"
    show-action
    placeholder="請(qǐng)輸入搜索關(guān)鍵詞"
    @search="onSearch"
    @cancel="onCancel"
  />
</form>
import { Toast } from 'vant';

export default {
  data() {
    return {
      value: ''
    };
  },
  methods: {
    onSearch(val) {
      Toast(val);
    },
    onCancel() {
      Toast('取消');
    }
  }
}
Tips: 在 van-search 外層增加 form 標(biāo)簽,且 action 不為空,即可在 iOS 輸入法中顯示搜索按鈕

搜索框內(nèi)容對(duì)齊

通過 input-align 屬性設(shè)置搜索框內(nèi)容的對(duì)齊方式,可選值為center、right

<van-search
  v-model="value"
  placeholder="請(qǐng)輸入搜索關(guān)鍵詞"
  input-align="center"
/>

禁用搜索框

通過disabled屬性禁用搜索框

<van-search
  v-model="value"
  disabled
  placeholder="請(qǐng)輸入搜索關(guān)鍵詞"
/>

自定義背景色

通過background屬性可以設(shè)置搜索框外部的背景色,通過shape屬性設(shè)置搜索框的形狀,可選值為round

<van-search
  v-model="value"
  shape="round"
  background="#4fc08d"
  placeholder="請(qǐng)輸入搜索關(guān)鍵詞"
/>

自定義按鈕

使用action插槽可以自定義右側(cè)按鈕的內(nèi)容。使用插槽后,cancel事件將不再觸發(fā)

<van-search
  v-model="value"
  show-action
  placeholder="請(qǐng)輸入搜索關(guān)鍵詞"
  @search="onSearch"
>
  <div slot="action" @click="onSearch">搜索</div>
</van-search>

API

Props

參數(shù)說明類型默認(rèn)值
label搜索框左側(cè)文本string-
shape搜索框形狀,可選值為 roundstringsquare
background搜索框外部背景色string#f2f2f2
maxlength輸入的最大字符數(shù)number | string-
placeholder占位提示文字string-
clearable是否啟用清除控件booleantrue
autofocus是否自動(dòng)聚焦,iOS 系統(tǒng)不支持該屬性booleanfalse
show-action是否在搜索框右側(cè)顯示取消按鈕booleanfalse
action-text v2.2.2取消按鈕文字boolean取消
disabled是否禁用輸入框booleanfalse
readonly是否將輸入框設(shè)為只讀booleanfalse
error是否將輸入內(nèi)容標(biāo)紅booleanfalse
input-align輸入框內(nèi)容對(duì)齊方式,可選值為 center rightstringleft
left-icon輸入框左側(cè) 圖標(biāo)名稱 或圖片鏈接stringsearch
right-icon輸入框右側(cè) 圖標(biāo)名稱 或圖片鏈接string-

Events

事件名說明回調(diào)參數(shù)
search確定搜索時(shí)觸發(fā)value: 輸入框當(dāng)前值
input輸入框內(nèi)容變化時(shí)觸發(fā)value: 輸入框當(dāng)前值
focus輸入框獲得焦點(diǎn)時(shí)觸發(fā)event: Event
blur輸入框失去焦點(diǎn)時(shí)觸發(fā)event: Event
clear點(diǎn)擊清除按鈕后觸發(fā)event: Event
cancel點(diǎn)擊取消按鈕時(shí)觸發(fā)-

Slots

名稱說明
label自定義搜索框左側(cè)文本
action自定義搜索框右側(cè)按鈕,設(shè)置show-action屬性后展示
left-icon自定義輸入框左側(cè)圖標(biāo)
right-icon自定義輸入框右側(cè)圖標(biāo)


實(shí)例演示

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

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)