vant选择器组件添加鼠标滚轮(多种解决方法包括生产环境)

文章讲述了在前端开发中遇到的一个问题,即移动端组件在PC端无法通过滚轮事件操作。作者尝试了使用vant组件库、查看GitHubissues、优快云解答、引入hammerjs等多种方法,但未能直接解决问题。最终,作者选择了修改组件源码,通过监听滚轮事件并在Picker组件中模拟拖拽效果,实现了需求。此外,还介绍了如何使用混入(mixins)使解决方案全局生效,以及通过patch-package对vant组件包打补丁的简便方法。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

背景

平常做前端开发的应该知道,在前端组件中,有两种组件

  • 一种是针对移动端的组件

  • 另一种是针对pc的组件

​ 而pc的组件主要是对鼠标,键盘等操作的支持,而移动端组件常用的事件是触摸等事件

​ 这时,狗血的就来了,业务总是能用各种奇怪的想法让你来回串着开发

​ 我们有一款web是写在企业微信内部的h5网页,他使用的是移动端组件,但是这个应用由于企业微信手机端和电脑端都有,导致了业务也会用电脑操作的需求

​ 这天,他说选项组件为什么不能使用滚轮选择?而是只能使用拖拽?这样不好用,要改成也支持滚轮

解决路径

嫌麻烦,请直接跳到最后的解决方案,前面只是解决路程

vant组件库

​ 首先咱们就去看这个组件,也就是 vant官方库,他有一个能够兼容桌面的
Replaced by Image Uploader
​ 这咱们一看就来劲儿了呀,正好咱们要用鼠标滚轮,肯定能够实现鼠标滚轮模拟拖拽呀,咱们继续往下看下去

image-20230526095415573

​ 然后发现本地项目中已经安了这个插件,但是滚轮效果仍然不生效,于是乎,这种方法不可以

gihtub issues

​ 当然,如果咱们只会查文档解决问题那么咱们就不是合格的程序员了,咱们也要学会去源码项目的issues,于是咱们去看下vant项目源码

​ 看到关于滚轮的有19个已解决,咱们就开心了,看来前人已经把路子探好了,咱们直接copy就行了

image-20230526095841938

​ 然后看到开发大大的回答就哭了,没计划支持,以后也不会支持,

image-20230526100016718

优快云

csdn回答 这种方法也时候也能解决一些问题,但是他通过改node_modules解决的,这种方法涉及到如何把源码包抽离出来,进行更改,然后所有的引入源也更改,比较麻烦,而且害怕涉及到线上问题

hammerjs

​ 再后来就想着使用hammerjs模拟手指操作可以么?滚轮滚一个,然后模拟手指滑动多少距离,这样就不用麻烦判断边界问题和选中问题,但是通过引入hammerjs问题频频。例如获取dom的麻烦等等问题,并且无法监听你是否能够监听你是否模拟成功了,所以这种也不行

换组件!!

​ 换组件的话意味着重写,开发周期起码两天以上,这种特别麻烦

​ 我尝试使用

  • Mint UI
  • Cube UI
  • Vux
  • MUI

等等,但是都没发现,突然我想看看antd-mobile,哭了,发现他有,但是他是react组件,vue和react串着写,肯定不可能呀

image-20230526101205773

chatGPT(解决方案1)

改组件

​ 其实上面换组件,和使用hammerjs都是他给我推荐的,可能是关键词不行?后来一个解决方法不用换组件,可以在原生写

原回答如下

  1. mounted 钩子函数中,获取到 Picker 组件的 DOM 元素,并添加 wheel 事件监听函数。

  2. wheel 事件监听函数中,根据鼠标滚轮滚动的方向来修改 Picker 组件的选中值。可以通过调用 scrollToOption 方法来实现滚动选中值的效果。

<template>
  <div>
    <van-picker
      ref="picker"
      :columns="columns"
      @change="handleChange"
      :default-index="currentIndex"
    />
  </div>

</template>

<script>
 // 如果不是v2记得把 :default-index="currentIndex"属性删掉,虽然我也不知道会出现什么错误
import { Picker } from 'vant';

export default {
  components: {
    [VanPicker.name]: Picker,
  },
  data() {
    return {
      columns: ['A', 'B', 'C', 'D', 'E'],
      currentIndex: 0
    };
  },
  mounted() {
    //获取到picker的dom
    //如果咱们在pouop里面写的话,就应该写到当弹窗出来再获取dom,否则获取不出来
    const pickerEl = this.$refs.picker.$el;
    pickerEl.addEventListener('wheel', this.handleWheel);
  },
  methods: {
    handleChange(value, index) {
      this.currentIndex = index;
      console.log('Selected value(value, index)', value, index);
    },
    handleWheel(event) {
      event.preventDefault();
      //Math.sign()函数,返回+/-1,表示正数还是负数,例如deltaY发现是-100,那么Math.sign返回也是-1,但是传入0那就是0
      const delta = Math.sign(event.deltaY);
      //获取最大下标
      const maxIndex = this.columns.length - 1;
      //计算当前下标,因为滚轮和拖拽是相反的逻辑,我们可以试下,触控板和鼠标滚轮就是相反的,所以要减
      const newIndex = this.currentIndex - delta;
      //边界处理
      if (newIndex >= 0 && newIndex <= maxIndex) {
        this.currentIndex = newIndex;
        //动画可能不流畅
        //vant 4的话
        this.$refs.picker.scrollToOption(newIndex);
        //vant3  this.$refs.picker.scrollToOption(newIndex);
        //vant2 的解决方案,我是以下的解决方法解决的
          //这个是控制动画的时长
         //  this.$refs.picker.$el.getElementsByClassName('van-picker-column__wrapper')[0].style.transitionDuration='800ms'
        //这个是给哪个变化添加属性,由于省事就添加all
      //this.$refs.picker.$el.getElementsByClassName('van-picker-column__wrapper')[0].style.transitionProperty='all'
      }
    }
  },
};
</script>

​ 在这个示例中,我们在 mounted 钩子函数中获取到了 Picker 组件的 DOM 元素,并添加了 wheel 事件监听函数。在 handleWheel 方法中,我们根据鼠标滚轮滚动的方向来修改 Picker 组件的选中值,并调用 scrollToOption 方法来实现滚动选中值的效果。最后,我们在 handleChange 方法中输出了选中的值和索引。

需要注意的是,在 handleWheel 方法中,我们调用了 event.preventDefault() 来阻止浏览器默认的滚动行为,以避免与 Picker 组件的滚动效果冲突。

如何全局生效?

使用混入,以下是全部代码,我的vant是2版本

// mixins.js 文件
//1.picker组件需要添加ref
//2.骗
export const myMixin = {
    methods: {
        //这个事件放到picker弹出的地方
        /***
         * picker滚动事件
         * @param picker picker的ref
         * @param cloum picker的数据
         * @param getCurFn 默认选中的index,是一个函数,因为需要拿到实时的
         * @param setIndex 设置index的方法
         * @returns {Promise<void>}
         */
        async getpicker(picker,cloum,getCurFn,setIndex){

            await new Promise(resolve => {setTimeout(resolve,100)})
            const pickerEl = this.$refs[picker].$el;
            pickerEl.addEventListener('wheel', (event)=>this.handleWheel(event,picker,cloum,getCurFn,setIndex));
            // console.log("pickerEl",pickerEl)
        },
        handleWheel(event,picker,cloum,getCurFn,setIndex) {
            // debugger
            event.preventDefault();
            const delta = Math.sign(event.deltaY);
            // debugger
            const maxIndex = cloum.length - 1;
            const newIndex = getCurFn() + delta;
            // debugger
            this.$refs[picker].$el.getElementsByClassName('van-picker-column__wrapper')[0].style.transitionDuration='800ms'
            this.$refs[picker].$el.getElementsByClassName('van-picker-column__wrapper')[0].style.transitionProperty='all'
            if (newIndex >= 0 && newIndex <= maxIndex) {
                // this.popupData.defaultIndex = newIndex;
                // console.log(" setIndex", setIndex,newIndex)
                setIndex(newIndex)
            }
        },
    }
};

调用(需要再全部引用的地方都调用)

 this.getpicker('picker',this.popupData.comSurList,()=>this.popupData.defaultIndex,(index)=>this.popupData.defaultIndex=index)

我们能够看到他的缺点了,需要再所有的地方都去调用一次

依赖包打补丁(最终解决,最简单)

更新vant到最新版本

​ 更新vant之后,我们可以发现vant的picker组件已经支持滚动滑轮了,但是每个滑轮滑动的过大,可能一次跳过两个选项,我们要进行修改

改源码

​ 改源码的方式有以下几种

  1. 提issues等待作者更新(莫不是在开玩笑)

  2. 将源码粘贴到component文件,然后全局改引用的位置(有一点点麻烦,项目也会变大,也有通过在webpack添加alis添加别名直接全局修改引用)

  3. 将源码仓库fork到自己的仓库,然后修改源码后,然后在自己项目中的npm修改一下包的位置后面的rep改成自己仓库的地址(但是记住千万别删这个仓库,否则以后你的项目就启不起来了)image-20230602113406830

  4. 通过patch-package对源码包打补丁

可以先了解一下patch-package 的介绍

说白了就三步

  1. 装依赖
  2. 直接改源码
  3. 执行命令将改的源码变成diff文件
  4. packagejson添加钩子执行
安装一下patch package
npm i patch-package

yarn add patch-package postinstall-postinstall
改源码

目录 node_modules->vant->picker->PickerColumn.js

在node_modules中找到vant(注意不是@vant,那个可能是vant的一些补丁包)

可以看到他的以下结构

image-20230602112430982

全局搜索一下wheel,找到onMouseWheel的方法,可以除以一个倍数,让其流畅

image-20230602112752942

编译补丁
npx patch-package package-name

此时我们可以看到根目录已经添加了一个patches文件了,查看文件发现是我们修改的相关位置

image-20230602113807614

添加钩子

默认会在packagejson中scripts添加一个钩子函数

"postinstall": "patch-package",

他的意思是安装依赖的时候立马支持patch-package打补丁

此时就可以测试一下,将node_modules删除后测试一下是否成功了

异常解决

pm WARN lifecycle xxx.xxx.com@0.1.0~postinstall: cannot run in wd xxx.xxx.com@0.1.0 patch-package (wd=/node)

我们部署线上的时候可能会出问题,因为有的docker安装依赖的时候工作目录可能不一致,可以尝试将钩子函数添加一个打包前执行,此时就会正常执行了

  "prebuild": "patch-package",

由于项目可能需要有不同环境的打包命令,所以可以以下

image-20230602114340633

 	//开发环境需要
	"postinstall": "patch-package",
	//打包需要
    "prebuild": "patch-package",
    "prebuild:test": "patch-package",
    "prebuild:feature1": "patch-package",
    "prebuild:feature2": "patch-package",
    "prebuild:prod": "patch-package"

于此,这项目就可以告别一段落

<think>好的,我现在需要解决用户在Vue3中实现滚动选择器选中内容固定的问题。首先,我得理解用户的需求。滚动选择器通常是指类似iOS的Picker那样,滚动选项后,选中项会固定在中间位置。用户希望实现这样的效果,可能需要用到第三方库或者自己手动实现。 首先,我应该考虑现有的Vue3组件库是否提供了这样的功能。比如,Vant、Element Plus等可能已经有滚动选择器组件。如果使用第三方库,用户只需要按照文档配置即可,这样比较快捷。但用户可能希望自己实现,或者有定制化的需求,这时候就需要手动开发了。 接下来,手动实现的步骤。首先,结构方面,需要创建一个容器,使用overflow-y: auto来允许滚动。内部包含多个选项项。然后,关键点在于如何让选中的项固定在某个位置,比如中间。可能需要监听滚动事件,当滚动停止时,计算当前最接近中间位置的项,并自动调整滚动位置使其居中。 样式方面,绝对定位可能是一个方法,或者使用transform来调整位置。同时,可能需要动态计算每个选项的位置,并在滚动结束后进行校准。例如,当用户滚动停止时,找到最近的选项,然后通过scrollTo方法平滑滚动到该位置,确保其固定在中间。 另外,触摸事件的处理也需要考虑,特别是在移动端,手指滑动后的惯性滚动结束后,如何触发校准。可能需要使用setTimeout来检测滚动是否停止,或者使用requestAnimationFrame来优化性能。 最后,如果用户需要更复杂的功能,比如联动选择器,可能需要更复杂的状态管理和联动逻辑,这时候建议使用成熟的第三方库会更高效。 总结来说,实现方法有两种:使用现有组件库或手动开发。手动开发的关键点在于滚动监听、位置计算和自动校准。需要结合Vue3的响应式特性和CSS样式来实现固定选中项的效果。</think>在Vue3中实现滚动选择器选中内容固定效果,可通过以下两种方式实现: 一、使用现成组件库(推荐) 1. 推荐使用Vant的Picker组件: ```vue <template> <van-picker :columns="columns" @change="handleConfirm" /> </template> <script setup> import { ref } from 'vue'; const columns = ref([ { text: '杭州', value: 'Hangzhou' }, { text: '宁波', value: 'Ningbo' }, { text: '温州', value: 'Wenzhou' } ]); const handleConfirm = ({ selectedValues }) => { console.log(selectedValues); }; </script> ``` 优点:自带选中项居中固定、惯性滚动、点击确认等功能 二、手动实现核心逻辑 1. 基础结构: ```vue <template> <div class="picker-wrapper" @scroll.passive="handleScroll"> <div v-for="(item, index) in items" :key="index" class="picker-item" > {{ item }} </div> <div class="highlight-line"></div> </div> </template> ``` 2. 核心样式(关键): ```css .picker-wrapper { height: 200px; overflow-y: auto; position: relative; scroll-snap-type: y mandatory; } .picker-item { height: 40px; display: flex; align-items: center; justify-content: center; scroll-snap-align: center; } .highlight-line { position: absolute; top: 50%; left: 0; right: 0; height: 1px; background: #007aff; transform: translateY(-20px); &::after { content: ''; display: block; height: 40px; background: rgba(0,122,255,0.1); transform: translateY(-20px); } } ``` 3. 滚动校准逻辑: ```vue <script setup> import { ref } from 'vue'; const items = ref([...Array(20).keys()].map(i => `选项 ${i + 1}`)); let scrollTimer = null; const handleScroll = (e) => { clearTimeout(scrollTimer); scrollTimer = setTimeout(() => { const container = e.target; const itemHeight = 40; const centerPos = container.scrollTop + container.clientHeight / 2; const selectedIndex = Math.round(centerPos / itemHeight); container.scrollTo({ top: selectedIndex * itemHeight, behavior: 'smooth' }); }, 100); }; </script> ``` 实现要点: 1. 使用CSS的`scroll-snap-type`实现吸附效果 2. 通过计算滚动容器中心位置确定选中项 3. 滚动停止后自动校准位置(使用定时器检测滚动结束) 4. 高亮线使用绝对定位覆盖在选项上方 5. 移动端需增加touch事件处理 进阶优化方向: 1. 添加惯性滚动动画 2. 支持循环滚动 3. 添加震动反馈 4. 实现多列联动 5. 支持鼠标滚轮操作 对于复杂需求,建议直接使用成熟的UI库: - Vant (移动端优先):https://vant-ui.github.io/vant/#/zh-CN - Element Plus (PC端):https://element-plus.org/zh-CN/ - Naive UI:https://www.naiveui.com/zh-CN/light/components/picker
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值