一个基于vue的图片轮播组件的实现

1. 在线DEMO
http://va-carousel.xiaoshang.online
Github
2. 首先是一张思维导图
一个基于vue的图片轮播组件的实现
文章图片

3. 然后是以上属性的标注说明
一个基于vue的图片轮播组件的实现
文章图片

4. 代码层
4.1 除去可从父组件接收的属性,组件自身有以下属性:

data() { return { list: [],// 当前显示的图片列表 hover: false, // 鼠标是否悬浮在组件上 timer: null,// 自动切换的 setInterval itemWidth: '',// 每项元素的宽度 isReverse: false // 是否是反向切换,触发prev时,该属性为true } }

4.2 组件挂载之前
  1. 计算每项元素的宽度,即itemWidth的值
  2. 初始化显示的图片列表,即list。这里存储的数据才是真正会被在页面上渲染的。每次切换,实际上就是修改该list中的数据,对应的视图会自动更新,数据驱动视图嘛。
beforeMount() { this.itemWidth = 100 / this.total + '%' this.list = this.items.slice(0, this.total) },

4.3 组件挂在后,检查autoplay属性,若该属性为true,则产生一个计时器
mounted() { if (this.autoplay) { this.startTimer() } },

4.4 startTimer函数很简单,就是间隔一定时间触发一次next(向后)切换
// 开始计时器 startTimer() { if (!this.interval || this.interval <= 0) { return } this.timer = setInterval(this.next, this.interval) }

4.5 next函数
// 下一张 next() { // 如果图片列表小于需要显示的数量,则不进行滚动 if (this.items.length < this.total) { return }// 向后追加一个元素,该元素为: // 显示列表中最后一个元素在原数组中的后一个元素 // 如果已经是最后一个元素,则使用第一个元素let indexOfItems = this.items.findIndex( item => item.id === this.list[this.list.length - 1].id )if (indexOfItems === this.items.length - 1) { // 使用第一个元素 this.list.push(this.items[0]) } else { // 使用后一个元素 this.list.push(this.items[indexOfItems + 1]) } // 移除当前显示图片中的第一个 this.list.shift() this.isReverse = false },

4.6 对应的还有一个prev函数,与next函数逻辑相反,这里就不展示代码了
4.7 点击图片时,向父组件释放事件selectedItem,传递两个参数 item 和 index 分别为当前点击的对象,和该对象在list中的位置
// 点击图片 selectedItem(item, index) { this.$emit('selectedItem', item, index) },

4.8 鼠标悬浮在组件上时,停止自动切换(若autoplay为ture), 鼠标离开时,继续切换
handleMouseEnter() { this.hover = true this.pauseTimer() },handleMouseLeave() { this.hover = false if (this.autoplay) { this.startTimer() } },

4.9 然后是过渡效果的实现
【一个基于vue的图片轮播组件的实现】因为arrow元素也在transition-group中,所以当arrow=‘hover’时,arrow的显示、隐藏也会触发钩子函数,但是我们的钩子函数是针对image-item写的,所以需要在函数中检测是哪个元素触发的,这里通过检查className进行判断。
然后针对向前、向后两种情况设置不同的样式
beforeEnter(el) { // 只对image-item使用过渡 let isImageItem = el.className.indexOf('image-item') > -1 if (isImageItem) { el.style.opacity = 0 if (this.isReverse) { el.style.transform = 'translateX(-100%)' } else { el.style.transform = 'translateX(100%)' } } }

4.10 这里使用了Velocity,这是一个实现动画效果的js库,之所以使用这个库是因为试了n种方案都没能实现预期效果emm
enter(el, done) { // 只对image-item使用过渡 let isImageItem = el.className.indexOf('image-item') > -1 if (isImageItem) { Velocity(el, { opacity: 1, translateX: '0px' }, { complate: done }) } else { done() } }

4.11 然后是对应的beforeLeave、leave函数,这里就不展示了
以上基本就是所有js部分,整体感受就是,一旦实现逻辑搞清楚,代码实现起来还是挺容易的,然后就是框架的熟悉程度。
5. npm包发布
这本是公司业务中的一个功能需求,因为没能在网上找到现成的轮子,找个差不多的效果领导不满意,所以只能自己写了,做都做了不发出来岂不是白写了. . .
npm发布流程简单概括就是
1.注册
去npm官网注册个账号
2.生成npm包 文件夹中有package.json文件就是一个npm包
3.在终端使用npm publish发布包,成功之后,该项目文件夹下所有文件都会上传至npm官网,当用户使用npm install安装后,就会将整个文件夹下载至node_modules文件夹中,对于这个项目,就是一个使用vue-cli生成的vue项目,组件路径src/components/VaCarousel.vue,所以使用npm install va-carousel安装之后,只需要在项目中像这样导入即可使用(前提是你的项目也是使用vue-cli生成的,对于其他方式建立的项目可能会出现一些错误):import VaCarousel from 'va-carousel/src/components/VaCarousel.vue'
以上

    推荐阅读