Vue3 + ElementPlus 2.4.x 自定义指令：解决el-select滚动加载3大坑点-北京尧图网络

Vue3 ElementPlus 2.4.x 自定义指令解决el-select滚动加载3大坑点在Vue3项目中ElementPlus的el-select组件因其丰富的功能和良好的兼容性成为开发者处理下拉选择需求的首选。然而当面对大数据量场景时直接一次性渲染所有选项会导致严重的性能问题。滚动加载Infinite Scroll是解决这一问题的有效方案但在实际开发中我们往往会遇到几个棘手的坑点。1. Teleport机制带来的DOM结构变化ElementPlus 2.4.x版本中el-select的下拉菜单默认通过Teleport挂载到body元素下。这一变化导致传统的DOM查询方式失效我们需要调整自定义指令的实现逻辑。export default { beforeMount(el, binding) { // 使用popper-class作为查询选择器 const selectWrap document.querySelector( .${binding.arg} .el-select-dropdown__wrap ) const scrollHandler function() { const isBottom this.scrollHeight - this.scrollTop this.clientHeight 5 if (isBottom) { binding.value() } } selectWrap?.addEventListener(scroll, scrollHandler) el._scrollHandler scrollHandler el._selectWrap selectWrap }, beforeUnmount(el) { el._selectWrap?.removeEventListener(scroll, el._scrollHandler) } }关键调整点不再直接查询.el-select-dropdown__wrap而是通过传入的popper-class定位添加5px的容差阈值避免精确匹配导致的触发不灵敏将DOM引用和事件处理器挂载到el上便于卸载时清理提示建议为每个el-select设置唯一的popper-class避免多个下拉框互相干扰。2. 事件监听与内存泄漏防范滚动加载的核心是监听滚动事件但如果处理不当很容易造成内存泄漏。以下是常见的三种问题场景及解决方案2.1 事件未正确移除// 错误示例直接添加匿名函数无法移除 selectWrap.addEventListener(scroll, function() { // ... }) // 正确做法使用具名函数引用 const handler function() { /*...*/ } selectWrap.addEventListener(scroll, handler) // 卸载时 selectWrap.removeEventListener(scroll, handler)2.2 组件卸载时未清理{ beforeUnmount(el) { // 必须检查元素是否存在 if (el._selectWrap el._scrollHandler) { el._selectWrap.removeEventListener(scroll, el._scrollHandler) } // 清除引用 delete el._selectWrap delete el._scrollHandler } }2.3 动态popper-class处理当popper-class是动态生成时需要特殊处理template el-select :popper-classselect-${uniqueId} v-select-loadmore:[select-${uniqueId}]loadMore !-- options -- /el-select /template script setup import { nanoid } from nanoid const uniqueId nanoid() /script3. 性能优化与用户体验提升单纯的滚动加载实现可能还不够我们需要考虑以下优化点3.1 防抖处理import { debounce } from lodash-es const scrollHandler debounce(function() { const isBottom this.scrollHeight - this.scrollTop this.clientHeight 5 if (isBottom !loading.value) { binding.value() } }, 200, { leading: true, trailing: true })参数说明参数类型默认值说明leadingbooleanfalse是否在延迟开始前调用trailingbooleantrue是否在延迟结束后调用maxWaitnumber-最大等待时间3.2 加载状态反馈template el-select v-select-loadmoreloadMore el-option v-foritem in options :valueitem.value :labelitem.label / template #footer div v-ifloading classloading-more el-icon classis-loadingLoading //el-icon 加载中... /div div v-else-ifnoMore classno-more没有更多了/div /template /el-select /template style .loading-more, .no-more { padding: 8px 0; text-align: center; color: var(--el-text-color-secondary); font-size: 12px; } /style3.3 数据分页策略推荐的后端接口参数设计const loadMore async () { if (loading.value || noMore.value) return loading.value true try { const res await api.getList({ page: page.value 1, pageSize: 20, keyword: searchKeyword.value }) if (res.data.length) { options.value.push(...res.data) page.value } else { noMore.value true } } finally { loading.value false } }分页参数对比分页方式优点缺点适用场景页码分页实现简单数据新增时可能重复数据变动不频繁游标分页避免重复实现复杂实时数据流时间分页自然排序依赖时间字段时间序列数据4. 完整实现与最佳实践下面是一个生产环境可用的完整实现方案4.1 自定义指令封装// directives/selectLoadmore.js import { debounce } from lodash-es export default { beforeMount(el, binding) { const { arg: popperClass, value: callback } binding if (typeof callback ! function) { console.warn([v-select-loadmore] 必须传入函数) return } const selectWrap document.querySelector( .${popperClass} .el-select-dropdown__wrap ) if (!selectWrap) { console.warn([v-select-loadmore] 未找到下拉框容器请检查popper-class: ${popperClass}) return } const checkBottom function() { const { scrollHeight, scrollTop, clientHeight } this return scrollHeight - scrollTop clientHeight 5 } const scrollHandler debounce(function() { if (checkBottom.call(this)) { callback() } }, 200) selectWrap.addEventListener(scroll, scrollHandler) // 存储引用以便清理 el._selectLoadmore { selectWrap, scrollHandler } }, beforeUnmount(el) { const { selectWrap, scrollHandler } el._selectLoadmore || {} if (selectWrap scrollHandler) { selectWrap.removeEventListener(scroll, scrollHandler) } delete el._selectLoadmore } }4.2 全局注册// main.js import { createApp } from vue import App from ./App.vue import selectLoadmore from ./directives/selectLoadmore const app createApp(App) app.directive(select-loadmore, selectLoadmore) app.mount(#app)4.3 组件使用示例template el-select v-modelselectedValue filterable remote :remote-methodhandleSearch :popper-classselectPopperClass v-select-loadmore:[selectPopperClass]loadMore visible-changehandleVisibleChange el-option v-foritem in options :keyitem.value :labelitem.label :valueitem.value / template #footer div v-ifloading classselect-footer el-icon classis-loadingLoading //el-icon span加载中.../span /div div v-else-ifisEnd classselect-footer没有更多数据了/div /template /el-select /template script setup import { ref, onMounted } from vue import { nanoid } from nanoid const selectPopperClass select-${nanoid()} const selectedValue ref() const options ref([]) const loading ref(false) const isEnd ref(false) const pageInfo ref({ page: 1, pageSize: 20, keyword: }) const fetchData async (reset false) { if (loading.value) return loading.value true try { const res await api.getData({ ...pageInfo.value, page: reset ? 1 : pageInfo.value.page }) if (reset) { options.value res.data isEnd.value false } else { options.value.push(...res.data) } if (res.data.length pageInfo.value.pageSize) { isEnd.value true } else if (!reset) { pageInfo.value.page } } finally { loading.value false } } const loadMore () { if (!isEnd.value !loading.value) { fetchData() } } const handleSearch (keyword) { pageInfo.value.keyword keyword fetchData(true) } const handleVisibleChange (visible) { if (!visible) { // 重置状态 pageInfo.value.page 1 isEnd.value false } } onMounted(() { fetchData(true) }) /script style .select-footer { padding: 8px 16px; text-align: center; color: var(--el-text-color-secondary); font-size: 12px; display: flex; align-items: center; justify-content: center; gap: 6px; } /style在实际项目中我们还需要考虑以下细节网络错误时的重试机制空数据状态展示移动端触摸事件优化多选模式下的特殊处理

Vue3 + ElementPlus 2.4.x 自定义指令：解决el-select滚动加载3大坑点

相关推荐

下载大文件总被限速？这款全能下载软件，BT磁力链全通吃，10任务+16线程快到飞起！

企业微信外部群机器人自动化：基于RPA的高效管理方案与实现思路

3步配置GitHub智能DNS加速，让代码下载速度提升300%

更多资讯

电工证可以每年退税吗你真以为含金量是天上掉下来的

工地太忙根本没时间复习考试？宾阳电工证考试网上查询攻略来了

电工证和教师待遇怎么比？证书过期了不知道怎么复审延期，官方报名入口帮你搞定

韶关电工证培训学校值不值得考？电工证是刚需还是鸡肋？

办理宾阳电工证考试需要什么材料

汽车维修电工证补贴值不值得考？郑州人避坑全攻略

今日更新

GUI自动化测试中的ScreenLayout：从硬编码坐标到声明式画面地图

LLC谐振变换器12V25A 300W开关电源设计与调试全攻略

ESP32多应用Flash数据隔离：分区表与NVS namespace实战

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？

相关推荐

下载大文件总被限速？这款全能下载软件，BT磁力链全通吃，10任务+16线程快到飞起！

企业微信外部群机器人自动化：基于RPA的高效管理方案与实现思路

3步配置GitHub智能DNS加速，让代码下载速度提升300%

更多资讯

电工证可以每年退税吗 你真以为含金量是天上掉下来的

工地太忙根本没时间复习考试？宾阳电工证考试网上查询攻略来了

电工证和教师待遇怎么比？证书过期了不知道怎么复审延期，官方报名入口帮你搞定

韶关电工证培训学校值不值得考？电工证是刚需还是鸡肋？

办理宾阳电工证考试需要什么材料

汽车维修电工证补贴值不值得考？郑州人避坑全攻略

今日更新

GUI自动化测试中的ScreenLayout：从硬编码坐标到声明式画面地图

LLC谐振变换器12V25A 300W开关电源设计与调试全攻略

ESP32多应用Flash数据隔离：分区表与NVS namespace实战

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？

电工证可以每年退税吗你真以为含金量是天上掉下来的