使用Vue自定義指令實(shí)現(xiàn)Select組件
本篇文章教大家寫一個(gè)非常簡(jiǎn)單的Select組件,想必很多人都寫過Select,畢竟它太常用了,但是本篇文章的示例使用到了Vue的自定義指令,如果你對(duì)Vue自定義指令不怎么熟悉的話,本篇文章或許會(huì)讓您有所收獲!
完成的效果圖如下:
一、首先,我們簡(jiǎn)單布局一下:
<template> <div class="select"> <div class="inner"> <div class="inputWrapper"> <input type="text" readonly placeholder="請(qǐng)選擇菜品"> <span class="iconfont icon-zhankaishangxia"></span> </div> <ul class="options"> <li v-for="(item, index) in options" :key="index">{{item.value}}</li> </ul> </div> </div> </template> ...... data() { return { options: [ { value: '西紅柿雞蛋' }, { value: '青椒抱雞蛋' }, { value: '回鍋肉' }, { value: '宮保雞丁' }, { value: '地三鮮' } ], } }
效果是這樣:
下面可供選擇的options用的是絕對(duì)定位;同時(shí)input設(shè)置了readonly,使input變的不可輸入,整體布局很簡(jiǎn)單。
二、開始添加功能
接下來,我們要添加兩個(gè)功能:
- 點(diǎn)擊上面的input框,可以切換顯示下面的options
- 選擇options里的某個(gè)選項(xiàng)后讓它展示在input里,同時(shí)讓選項(xiàng)部分消失
這兩項(xiàng)目功能都挺簡(jiǎn)單,先來完成第一個(gè),點(diǎn)擊input框切換顯示options,借助v-show就好。
<div class="inputWrapper" @click="showOptions = !showOptions"> <input type="text" readonly placeholder="請(qǐng)選擇菜品"> <span class="iconfont icon-zhankaishangxia"></span> </div> <ul class="options" v-show="showOptions" v-show="showOptions"> //添加v-show <li v-for="(item, index) in options" :key="index">{{item.value}}</li> </ul> ...... data() { showOptions: false }
如上所示,在選項(xiàng)里添加 v-show="showOptions"
并將 showOptions 初始化為 false 。同時(shí),在包裹 input 的 div 上添加 click 事件來回切換 showOptions 的布爾值。
效果如下:
第二個(gè),點(diǎn)擊下面的選項(xiàng),將被選擇的展示到input里,同時(shí)讓options消失,也不難。
<div class="inputWrapper" @click="showOptions = !showOptions"> <input type="text" readonly placeholder="請(qǐng)選擇菜品" :value="selected"> //這里用value綁定一個(gè)data值selected <span class="iconfont icon-zhankaishangxia"></span> </div> <ul class="options" v-show="showOptions"> <li v-for="(item, index) in options" :key="index" @click="choose(item.value)">{{item.value}}</li> </ul> ...... data() { return { ...... showOptions: false selected: '' } }, methods: { choose(value) { this.showOptions = false if (value !== this.selected) { this.selected = value } } }
邏輯很簡(jiǎn)單,在input里用value綁定一個(gè)data值,點(diǎn)擊選擇某個(gè)選項(xiàng)后,將選項(xiàng)的內(nèi)容賦給這個(gè)data值即可,同時(shí),隱藏整個(gè)選項(xiàng)內(nèi)容。
效果如下:
從上面的效果圖中可以看到,已經(jīng)可以正常選擇了,但是有一個(gè)問題,就是它選項(xiàng)內(nèi)容展示的時(shí)候,我們希望點(diǎn)擊其它空白的地方也可以讓選擇內(nèi)容隱藏,但是上面的代碼并沒有解決這個(gè)問題,接下來我們來用兩種辦法來解決它。
3、常規(guī)的DOM操作 VS Vue自定義指令
其實(shí),實(shí)現(xiàn)這個(gè)功能并不難,只是要想解決它就需要操作DOM
<div class="inputWrapper" @click.stop="showOptions = !showOptions"> //注意這里的stop修飾器 <input type="text" readonly placeholder="請(qǐng)選擇菜品" :value="selected"> <span class="iconfont icon-zhankaishangxia"></span> </div> <ul class="options" v-show="showOptions"> <li v-for="(item, index) in options" :key="index" @click.stop="choose(item.value)">{{item.value}}</li> //還有這里的stop修飾器 </ul> ... data() { return { ...... showOptions: false } } mounted() { let that = this document.addEventListener('click', function() { that.showOptions = false }) }
上面的代碼有兩點(diǎn):一個(gè)是在mounted后面給整個(gè)document添加了點(diǎn)擊事件,這樣在點(diǎn)擊時(shí)候就可以將options隱藏,但是,我們?cè)邳c(diǎn)擊輸入框部分和選項(xiàng)內(nèi)容時(shí),我們不希望它觸發(fā),而是讓它走我們之前寫好的邏輯,所以給兩個(gè) click 事件都添加了 stop 修飾器來阻止冒泡,這樣,點(diǎn)擊到它們的時(shí)候就不會(huì)冒泡到 document 上面了。效果如下:
到這里基本功能都寫完了,可以通過添加 $emit 和 props 來進(jìn)行數(shù)據(jù)傳遞,讓它更加通用些。但是最后關(guān)于點(diǎn)擊其它地方讓選項(xiàng)部分消失的功能,我們還可以再完善下,可以考慮使用Vue指令的方式實(shí)現(xiàn)。
關(guān)于Vue指令,官方文檔里有比較清楚的說明,如果不是特別明白可以點(diǎn)擊這里先看看!
關(guān)于Vue自定義指令,在這個(gè)例子中需要明白以下基本知識(shí)點(diǎn):
它是用來操作DOM的,所以所有Vue指令都會(huì)掛在 template 里的某個(gè)元素上
它有4個(gè)鉤子函數(shù),一是 bind ,它在指令第一次綁定到元素上調(diào)用而且只調(diào)用一次,這個(gè)鉤子很重要,我們?cè)谶@個(gè)例子里會(huì)用到;第二個(gè)是 inserted ,它在元素插入到父元素的時(shí)候調(diào)用,官方文檔里給了一個(gè) v-focus 的例子就用到了它;第三個(gè)和第四個(gè)分別是 update 和 componentUpdated ,前者是在 vNode 更新時(shí)調(diào)用,后者是在更新完成后調(diào)用;最后是 unbind ,在指令和元素解綁時(shí)調(diào)用。
這4個(gè)鉤子函數(shù)可以 都至少可以傳3個(gè)參數(shù) ,第一是 el 就是被綁定指令的元素,第二個(gè) binding , 它是個(gè)對(duì)象 ,而且 它的一些屬性特別有用 ,它的屬性包括 name , expression 和 value 等,當(dāng)然不只這三個(gè),但是我們這個(gè)例子要用。舉個(gè)例子: 假如我寫一個(gè)自定義指令 v-example="test" ,而這個(gè) test 是我在 methods 里寫的一個(gè)方法,那么就可以通過 binding.name 拿到 example 字符串,可以通過 binding.value 拿到 test 函數(shù)本身并且執(zhí)行。如果這里不明白沒關(guān)系接下來我們會(huì)說到。
如果仔細(xì)觀察,它們非常像 Vue 本身的生命周期鉤子函數(shù),只是它們是作用在指令上與元素的上的。從 bind 最開始綁定到最后 unbind 解綁完成了一個(gè)完整的周期。
好了,我們把之前 mounted 寫的DOM操作相關(guān)的東西都刪掉,開始動(dòng)手寫一個(gè)自定義指令。
<ul class="options" v-show="showOptions" v-clickOut="test"> //這里使用了下面的自定義指令,并將一個(gè)test方法傳遞進(jìn)去了 <li v-for="(item, index) in options" :key="index" @click.stop="choose(item.value)">{{item.value}}</li> </ul> ... methods: { ...... test() { //test函數(shù),它作為參數(shù)傳遞給了指令 console.log('這是一個(gè)測(cè)試函數(shù)') } }, directives: { //這里是自定義指令 clickOut: { // 這里是自定義的v-clickOut指令 bind: function(el, binding) { // bind鉤子函數(shù),當(dāng)它與元素綁定的時(shí)候就會(huì)執(zhí)行 console.log('el===>', el) console.log('binding.name===>', binding.name) console.log('binding.expression===>', binding.expression) console.log('binding.value===>', binding.value) } } }
上面的代碼都有清楚的注釋說明,我們自定義了一個(gè) clickOut 的指令,并且把它掛到了一個(gè)元素上,而且給它傳了一個(gè) test 方法,我們來看看 console.log 出的東西都是些啥。
從上面的圖片可以看出當(dāng)指令和元素綁定的時(shí)候即 bind 的時(shí)候,它會(huì)執(zhí)行bind函數(shù)獲得很多有用的東西,上面我們講了 bind 函數(shù)里有幾個(gè)重要的參數(shù),從打印出的結(jié)果里我們非常清楚地看到,el就是指令綁定的元素本身,binding是一個(gè)對(duì)象,它獲得了很多有用的東西,包括傳遞進(jìn)來的函數(shù)。
明白了它的基本構(gòu)造,我們就來繼續(xù)完善這個(gè)指令。
<ul class="options" v-show="showOptions" v-clickOut="test"> <li v-for="(item, index) in options" :key="index" @click.stop="choose(item.value)">{{item.value}}</li> </ul> ... methods: { test() { this.showOptions = false } }, directives: { clickOut: { bind: function(el, binding) { document.addEventListener('click', function(e) { if (el.contains(e.target)) return false if (binding.expression) { binding.value() } }) } }
看下上面改寫過的代碼做了些啥? 說下邏輯:當(dāng)我們自定的 v-clickOut 與選項(xiàng)部分的ul元素綁定的時(shí)候,我們監(jiān)聽document的click事件,如果點(diǎn)擊的元素是被指令綁定的元素的子元素或是被綁定元素本身,那就什么都不做;如果不是,那就執(zhí)行傳遞進(jìn)來的test函數(shù)。而test函數(shù)執(zhí)行的結(jié)果就是把選項(xiàng)部分隱藏。
邏輯很清楚。
當(dāng)然我們可以繼續(xù)完善它。我們給 document.addEventListener
了,也可以在 合適的時(shí)候 removeEventListener
,這個(gè)合適的時(shí)候就是 unbind 鉤子函數(shù)。
所以我們可以完善下:
...... directives : { clickOut: { bind: function(el, binding) { function handler(e) { if (el.contains(el.target)) return false if (binding.expression) { binding.value() } } el.handler = handler document.addEventListener('click', el.handler) }, unbind: function(el) { document.removeEventListener('click', el.handler) } } }
代碼如上,效果如下:
簡(jiǎn)單總結(jié)一下:這是一個(gè)非常簡(jiǎn)單的小例子,因?yàn)樾枰僮鱀OM,所以我們選擇使用自定義來完成,當(dāng)然我們也可以使用其它方法。只是,在我們用Vue的時(shí)候,如果遇到需要操作DOM的時(shí)候,那么可以想想可不可以通過自定義指令來實(shí)現(xiàn)呢!
相關(guān)文章
vue3中路由傳參query、params及動(dòng)態(tài)路由傳參詳解
vue3中的傳參方式和vue2中一樣,都可以用query和params傳參,下面這篇文章主要給大家介紹了關(guān)于vue3中路由傳參query、params及動(dòng)態(tài)路由傳參的相關(guān)資料,需要的朋友可以參考下2022-09-09Element?UI表單驗(yàn)證規(guī)則動(dòng)態(tài)失效問題的解決辦法
這篇文章主要給大家介紹了關(guān)于Element?UI表單驗(yàn)證規(guī)則動(dòng)態(tài)失效問題的解決辦法,Element UI提供了強(qiáng)大的表單驗(yàn)證功能,可以輕松地對(duì)表單進(jìn)行驗(yàn)證,需要的朋友可以參考下2023-09-09Vue3導(dǎo)航欄組件封裝實(shí)現(xiàn)方法
這篇文章主要為大家詳細(xì)介紹了Vue3導(dǎo)航欄組件封裝的實(shí)現(xiàn)方法,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2021-09-09