1. 在线DEMO
http://va-carousel.xiaoshang.online
Github
2. 首先是一张思维导图
3. 然后是以上属性的标注说明
4. 代码层
4.1 除去可从父组件接收的属性,组件自身有以下属性:
data() {
return {
list: [], // 当前显示的图片列表
hover: false, // 鼠标是否悬浮在组件上
timer: null, // 自动切换的 setInterval
itemWidth: '',// 每项元素的宽度
isReverse: false // 是否是反向切换,触发prev时,该属性为true
}
}
4.2 组件挂载之前
- 计算每项元素的宽度,即itemWidth的值
- 初始化显示的图片列表,即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 然后是过渡效果的实现
因为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'
以上