
在Vue自定义多选组件中,当需要检测组件整体失去焦点以关闭选项列表时,使用`blur`事件可能无法达到预期效果,尤其是在组件内部输入框被聚焦后。这是因为`blur`事件不具备事件冒泡特性。本教程将详细解释为何`blur`不适用,并推荐使用`focusout`事件,它能够正确地在父元素上捕获子元素或父元素本身失去焦点的事件,从而实现组件焦点管理的需求。
在开发复杂的UI组件,如自定义多选下拉框时,一个常见的需求是当用户点击组件外部区域时,自动关闭下拉选项列表。这通常通过监听组件的焦点丢失事件来实现。然而,在组件内部包含可交互元素(如输入框)时,如何正确判断“组件整体”是否失去焦点,而非仅仅是内部某个元素失去焦点,是一个容易混淆的问题。
考虑一个多选组件,它包含一个输入框用于搜索和显示已选项目,以及一个下拉列表显示可选项目。当用户点击输入框,然后点击组件外部时,我们希望下拉列表关闭。但如果用户点击输入框,然后点击下拉列表中的某个选项,我们不希望列表关闭,因为用户仍在与组件交互。
在DOM事件模型中,blur事件在元素失去焦点时触发。然而,blur事件的一个关键特性是它不冒泡。这意味着,如果一个子元素失去了焦点,它的blur事件只会在该子元素上触发,而不会向上层父元素传播。
立即学习“前端免费学习笔记(深入)”;
例如,在以下Vue组件结构中:
<div @blur="showOptions = false" :tabindex="tabIndex"> <!-- ... 其他组件内容 ... --> <input type="text" v-model="searchInput" /> <!-- ... 选项列表 ... --> </div>
当用户点击input字段,然后点击组件外部时,input字段会失去焦点。此时,input元素会触发一个blur事件。但由于blur事件不冒泡,div元素上监听的@blur事件永远不会被触发。因此,showOptions = false这条逻辑也就无法执行,导致下拉列表无法关闭。
为了让父元素能够感知到其内部任何子元素失去焦点的情况,我们需要一个具有冒泡特性的焦点事件。
focusout事件是解决上述问题的理想选择。与blur事件不同,focusout事件会冒泡。当元素本身或其内部的任何子元素失去焦点时,focusout事件都会在元素上触发,并且会向上冒泡到其祖先元素。
这意味着,将@focusout事件监听器放置在组件的根容器上,可以有效地检测到组件整体何时失去了焦点。
要修正多选组件的焦点管理行为,只需将父元素上的@blur事件替换为@focusout:
<template>
<div class="flex flex-col relative w-full">
<span v-if="label" class="font-jost-medium mb-2">{{ label }}</span>
<div>
<!-- 将 @blur 替换为 @focusout -->
<div @focusout="showOptions = false" :tabindex="tabIndex">
<div
class="border border-[#EAEAEA] bg-white rounded-md flex flex-col w-full"
>
<div
v-if="selectedOptions.length"
class="flex flex-wrap px-4 py-2 border-b gap-2"
>
<div
v-for="option in selectedOptions"
class="border bg-secondary rounded-full py-1 px-2 flex items-center"
>
<span>{{ option.text }}</span>
<vue-feather
type="x"
class="h-3 w-3 ml-1.5 cursor-pointer"
@click="onDeleteOption(option)"
/>
</div>
</div>
<div
class="flex flex-row justify-end items-center px-4 cursor-pointer"
:class="selectedOptions.length ? 'py-2' : 'p-4'"
@click="showOptions = !showOptions"
>
<MagnifyingGlassIcon class="h-5 w-5 mr-2" />
<input
class="focus:outline-0 w-full"
type="text"
v-model="searchInput"
/>
<vue-feather type="chevron-down" class="h-5 w-5" />
</div>
</div>
<div v-if="showOptions && optionsMap.length" class="options-list">
<ul role="listbox" class="w-full overflow-auto">
<li
class="hover:bg-primary-light px-4 py-2 rounded-md cursor-pointer"
role="option"
v-for="option in optionsMap"
@mousedown="onOptionClick(option)"
>
{{ option.text }}
</li>
</ul>
</div>
<div
id="not-found"
class="absolute w-full italic text-center text-inactive-grey"
v-else-if="!optionsMap.length"
>
No records found
</div>
</div>
</div>
</div>
</template>
<script lang="ts">
import { defineComponent, PropType, ref, watch } from "vue";
import { IconNameTypes } from "@/types/enums/IconNameTypes";
import { AppIcon } from "@/components/base/index";
import { MagnifyingGlassIcon } from "@heroicons/vue/24/outline";
export default defineComponent({
name: "AppAutocomplete",
components: {
AppIcon,
MagnifyingGlassIcon,
},
props: {
modelValue: {
type: String,
},
label: {
type: String,
default: "",
},
tabIndex: {
type: Number,
default: 0,
},
options: {
type: Array as PropType<{ text: string; value: string }[]>,
required: true,
},
},
setup(props, { emit }) {
const showOptions = ref(false);
const optionsMap = ref(props.options);
const selectedOptions = ref<{ text: string; value: string }[]>([]);
const searchInput = ref("");
watch(searchInput, () => {
optionsMap.value = props.options.filter((option1) => {
return (
!selectedOptions.value.some((option2) => {
return option1.text === option2.text;
}) &&
option1.text.toLowerCase().includes(searchInput.value.toLowerCase())
);
});
sortOptionsMapList();
});
const onOptionClick = (option: { text: string; value: string }) => {
searchInput.value = "";
selectedOptions.value.push(option);
optionsMap.value = optionsMap.value.filter((option1) => {
return !selectedOptions.value.some((option2) => {
return option1.text === option2.text;
});
});
sortOptionsMapList();
emit("update:modelValue", option.value);
};
const onDeleteOption = (option: { text: string; value: string }) => {
selectedOptions.value = selectedOptions.value.filter((option2) => {
return option2.text !== option.text;
});
optionsMap.value.push(option);
sortOptionsMapList();
};
const sortOptionsMapList = () => {
optionsMap.value.sort(function (a, b) {
return a.text.localeCompare(b.text);
});
};
sortOptionsMapList();
// 移除或调整此处的全局点击监听器,因为它可能与focusout逻辑冲突或不必要
// document.addEventListener("click", () => {
// console.log(document.activeElement);
// });
return {
showOptions,
optionsMap,
searchInput,
selectedOptions,
IconNameTypes,
onOptionClick,
onDeleteOption,
};
},
});
</script>
<style scoped lang="scss">
.options-list,
#not-found {
box-shadow: 0 0 50px 0 rgb(19 19 28 / 12%);
@apply border border-[#EAEAEA] rounded-md p-4 mt-1 absolute bg-white z-10 w-full;
}
ul {
@apply max-h-52 #{!important};
}
</style>通过将@blur="showOptions = false"更改为@focusout="showOptions = false",当组件内部的input字段失去焦点,并且焦点转移到组件外部的任何元素时,div上的focusout事件就会触发,从而正确地关闭选项列表。
在Vue自定义组件中处理焦点丢失事件时,选择正确的事件至关重要。blur事件因其不冒泡的特性,不适合用于检测父级容器的整体焦点丢失。相反,focusout事件因其冒泡特性,能够完美地解决这一问题,允许父元素感知到其内部任何子元素或自身失去焦点的事件,从而实现准确的UI行为控制,如自动关闭下拉选项列表。通过将@blur替换为@focusout并确保父元素具有tabindex,可以构建出更健壮、用户体验更佳的自定义组件。
以上就是Vue自定义多选组件中焦点丢失事件的正确处理的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号