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-07vue項(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-04Vuex 使用及簡(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-04vue中如何動(dòng)態(tài)設(shè)置css樣式的hover
這篇文章主要介紹了vue中如何動(dòng)態(tài)設(shè)置css樣式的hover,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-10-10