vue-auto-focus: 控制自動(dòng)聚焦行為的 vue 指令方法
在網(wǎng)頁(yè)的表單中,經(jīng)常需要用程序來(lái)控制input和textarea的自動(dòng)聚焦行為。例如我最近做的一個(gè)項(xiàng)目,有個(gè)裝箱出庫(kù)的流程,input框自動(dòng)聚焦的流程如下:頁(yè)面進(jìn)入時(shí)自動(dòng)聚焦到訂單號(hào)輸入框->訂單號(hào)掃描完畢聚焦到商品條碼輸入框->掃描完一個(gè)商品條碼后依然停留在條碼輸入框->所有條碼掃描完畢聚焦到訂單號(hào)輸入框。
為了應(yīng)付這種需求,就做了這個(gè)指令,github地址: vue-auto-focus ,歡迎star。
example
<template>
<form v-auto-focus="focusCtrl" :data-current="currentIndex" :data-action="actionType">
<input @focus="setFocusIndex(0)" type="text" data-index="0">
<input @focus="setFocusIndex(1)" type="text" data-index="1">
<textarea @focus="setFocusIndex(2)" name="" id="" cols="30" rows="10" data-index="2"></textarea>
<input @focus="setFocusIndex(3)" type="text" data-index="3">
</form>
</template>
<style scoped>
</style>
<script type="text/babel">
export default {
data() {
return {
focusCtrl: 0, // 自動(dòng)聚焦控制,變動(dòng)時(shí),執(zhí)行自動(dòng)聚焦指令
currentIndex: 0, // 當(dāng)前聚焦元素的索引
actionType: 'next', // 自動(dòng)聚焦的行為類型
}
},
methods: {
/**
* 控制自動(dòng)聚焦指令執(zhí)行
* @param actionType {string} 自動(dòng)聚焦類型 it can be 'next'/'prev'/'first'/'last'/'jump'
* @param index {string} 當(dāng)actionType為'jump'時(shí),需要傳入將要聚焦元素的索引
**/
setFocus(actionType,index) {
if (actionType === 'jump') {
this.currentIndex = index
}
this.focusCtrl++
this.actionType = actionType
},
/**
* 元素聚焦時(shí),獲取當(dāng)前聚焦元素的索引
* @param index {number} 當(dāng)前聚焦的索引
**/
setFocusIndex(index) {
this.currentIndex = index
},
}
}
</script>
行為控制
next 聚焦到下一個(gè)元素
prev 聚焦到上一個(gè)元素
first 聚焦到第一個(gè)元素
last 聚焦到最后一個(gè)元素
jump 聚焦到指定的元素
聚焦行為控制邏輯
/**
* 聚焦行為控制
* next 聚焦到下一個(gè)元素
* prev 聚焦到上一個(gè)元素
* first 聚焦到第一個(gè)元素
* last 聚焦到最后一個(gè)元素
* jump 跳轉(zhuǎn)到指定的元素
* @param el
*/
const focusCtrl = function (el) {
const action = el.dataset.action
const allFocusEls = getAllFocusEls(el)
const focusLen = allFocusEls.length
let current = getTargetIndex(el,allFocusEls)
switch (action) {
case 'next': // 如果action為next,則聚焦到下一個(gè)輸入框
if (current >= focusLen - 1) {
current = focusLen - 1
} else {
current++
}
autoFocus(allFocusEls[current])
break
case 'prev': // 如果action為prev,則聚焦到上一個(gè)輸入框
if (current <= 0) {
current = 0
} else {
current--
}
autoFocus(allFocusEls[current])
break
case 'first': // 如果為first,則聚焦到第一個(gè)輸入框
current = 0
autoFocus(allFocusEls[current])
break;
case 'last': // 如果為last,則聚焦到最后一個(gè)輸入框
current = focusLen - 1
autoFocus(allFocusEls[current])
break
case 'jump': // 如果為jump,則獲取focusIndex,跳轉(zhuǎn)到對(duì)應(yīng)的輸入框
if (current >= 0 && current < focusLen) {
autoFocus(allFocusEls[current])
}
break
}
}
必須在需要控制的元素上添加data-index屬性,需要在父元素上添加data-action屬性和data-current屬性,data-action為指令行為的類型(值為next,prev等),data-current為當(dāng)前聚焦元素的data-index值, getAllFocusEls 方法其實(shí)就是獲取所有屬性為data-index的元素,代碼如下:
/**
* 獲取需要聚焦的所有元素
* @param el {Node} 指令掛載的元素
* @returns {NodeList} 需要聚焦的元素列表
*/
const getAllFocusEls = function (el) {
return el.querySelectorAll('[data-index]')
}
getTargetIndex 方法用來(lái)獲取當(dāng)前聚焦元素的在集合中的索引值,代碼如下:
/**
* 獲取當(dāng)前聚焦元素在集合中的位置
* @param el
* @param collection
* @returns {number}
*/
const getTargetIndex = function(el,collection) {
const target = document.querySelector(`[data-index="${el.dataset.current}"]`)
return Array.from(collection).indexOf(target)
}
inserted
指令掛載時(shí),自動(dòng)聚焦到指定的元素
/**
* 進(jìn)入頁(yè)面時(shí),根據(jù)設(shè)置的data-index索引值,聚焦到對(duì)應(yīng)的輸入框
* @param el
*/
inserted: function (el) {
const allFocusEls = getAllFocusEls(el) // 獲取需要聚焦的input元素組
let current = getTargetIndex(el,allFocusEls)
if (!current || current < 0 || current >= allFocusEls.length) { // 如果沒(méi)有設(shè)置data-current,或者current的數(shù)值范圍不符合要求,則默認(rèn)聚焦到第一個(gè)輸入框
current = 0
}
const currentEl = allFocusEls[current]
autoFocus(currentEl)
},
update
通過(guò)指令的value值控制指令的執(zhí)行,如果值有變動(dòng),則執(zhí)行指定的操作,聚焦到指定的元素
/**
* 更新時(shí),如果focusCtrl有變動(dòng),則根據(jù)actionType來(lái)判斷聚焦的行為,聚焦到對(duì)應(yīng)的元素
* @param el
* @param value
* @param oldValue
*/
update: function (el,{value,oldValue}) {
if (value !== oldValue) {
focusCtrl(el)
}
},
以上這篇vue-auto-focus: 控制自動(dòng)聚焦行為的 vue 指令方法就是小編分享給大家的全部?jī)?nèi)容了,希望能給大家一個(gè)參考,也希望大家多多支持腳本之家。
相關(guān)文章
通過(guò)命令行創(chuàng)建vue項(xiàng)目的方法
這篇文章主要介紹了通過(guò)命令創(chuàng)建vue項(xiàng)目的方法,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-07-07
vue項(xiàng)目實(shí)現(xiàn)添加圖片裁剪組件
這篇文章主要為大家詳細(xì)介紹了vue項(xiàng)目實(shí)現(xiàn)添加圖片裁剪組件,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-03-03
移動(dòng)端調(diào)試神器vConsole使用詳解
vConsole?是框架無(wú)關(guān)的,可以在?Vue、React?或其他任何框架中使用,今天通過(guò)本文給大家介紹移動(dòng)端調(diào)試神器vConsole使用,感興趣的朋友一起看看吧2022-04-04
Vuex 使用及簡(jiǎn)單實(shí)例(計(jì)數(shù)器)
這篇文章主要介紹了Vuex 使用及簡(jiǎn)單實(shí)例(計(jì)數(shù)器),小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-08-08
詳解vue computed的緩存實(shí)現(xiàn)原理
這篇文章主要介紹了vue computed的緩存實(shí)現(xiàn)原理,幫助大家更好的理解和學(xué)習(xí)使用vue,感興趣的朋友可以了解下2021-04-04
vue中如何動(dòng)態(tài)設(shè)置css樣式的hover
這篇文章主要介紹了vue中如何動(dòng)態(tài)設(shè)置css樣式的hover,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-10-10

