👉 慕课网学习地址: http://coding.imooc.com/class/107.html
👉 项目演示地址: https://bxm0927.github.io/vue-music-webapp/dist/ (在 GitHub Pages 中,通过 jsonp 请求的数据会被正常渲染,而由于无 node 服务,通过 axios 请求的数据不会被正常渲染)
基于 Vue 全家桶 (2.x) 制作的移动端音乐 WebApp ,一个媲美原生的移动端音乐 App,项目完整、功能完备、UI美观、交互一流。
【前端】
Vue
:用于构建用户界面的 MVVM 框架。它的核心是响应的数据绑定和组系统件vue-router
:为单页面应用提供的路由系统,项目上线前使用了Lazy Loading Routes
技术来实现异步加载优化性能vuex
:Vue 集中状态管理,在多个组件共享某些状态时非常便捷vue-lazyload
:第三方图片懒加载库,优化页面加载速度better-scroll
:iscroll 的优化版,使移动端滑动体验更加流畅Sass(Scss)
:css 预编译处理器ES6
:ECMAScript 新一代语法,模块化、解构赋值、Promise、Class 等方法非常好用
【后端】
Node.js
:利用 Express 起一个本地测试服务器jsonp
:服务端通讯。抓取 QQ音乐(移动端)数据axios
:服务端通讯。结合 Node.js 代理后端请求,抓取 QQ音乐(PC端)数据
【自动化构建及其他工具】
vue-cli
:Vue 脚手架工具,快速初始化项目代码eslint
:代码风格检查工具,规范代码书写vConsole
:移动端调试工具,在移动端输出日志
- 总结了一套 Vue 通用组件,可以在其它项目中复用的 10+ 个基础组件、15+ 个业务组件
- 总结了一套常用的 SCSS mixin 库
- 总结了一套常用的 JS 工具函数库
- 体会到组件化、模块化开发带来的便捷
- 体会到将对象封装成类(ES6 class) 的便捷性,以及利用工厂方式初始化类实例
- 学会利用
js
编写过渡效果及动画效果制作良好的用户交互体验
- 歌曲数据全部来自 QQ 音乐,接口改变了可能就要修改
jsonp
和axios
代码 - 由于项目的应用级状态不多(10个左右),所以就没有将
action
、mutation
、和getters
分割到单独的文件。但这样架构并不便于维护
主要页面:播放器内核页、推荐页、歌单详情页、歌手页、歌手详情页、排行页、搜索页、添加歌曲页、个人中心页等。
核心页面:播放器内核页
组件树
<app> ................... 根组件
<my-player> ........... 全局的播放器内核组件
<my-header> ........... 头部组件
<my-tab> .............. 导航栏组件
<router-view> ......... 路由
<recommend> ......... 推荐页
<singer> ............ 歌手页
<rank> .............. 排行页
<search> ............ 搜索页
推荐页
上部分是一个轮播图组件,使用第三方库 better-scroll
辅助实现,使用 jsonp
抓取 QQ音乐(移动端)数据
下部分是一个歌单推荐列表,使用 axios + Node.js
代理后端请求,绕过主机限制 (伪造 headers),抓取 QQ音乐(PC端)数据
歌单推荐列表图片,使用图片懒加载技术 vue-lazyload
,优化页面加载速度
为了更好的用户体验,当数据未请求到时,显示 loading
组件
推荐页 -> 歌单详情页
由于歌手的状态多且杂,这里使用 vuex
集中管理歌手状态
这个组件更加注重 UX,做了很多类原生 APP 动画,如下拉图片放大、跟随推动、ios 渐进增强的高斯模糊效果 backdrop-filter
等
歌手页
左右联动是这个组件的难点
左侧是一个歌手列表,使用 jsonp
抓取 QQ音乐(PC端)歌手数据并重组 JSON 数据结构
列表图片使用懒加载技术 vue-lazyload
,优化页面加载速度
右侧是一个字母列表,与左侧歌手列表联动,滚动固定标题实现
歌手页 -> 歌手详情页
复用歌单详情页,只改变传入的参数,数据同样爬取自 QQ音乐
播放器内核页
核心组件。用 vuex
管理各种播放时状态,播放、暂停等功能调用 audio API
播放器可以最大化和最小化
中部唱片动画使用第三方 JS 动画库 create-keyframe-animation
实现
底部操作区图标使用 iconfonts
。
抽象了一个横向进度条组件和一个圆形进度条组件,横向进度条可以拖动小球和点击进度条来改变播放进度,圆形进度条组件使用 SVG <circle>
元素
播放模式有:顺序播放、单曲循环、随机播放,原理是调整歌单列表数组
歌词的爬取利用 axios
代理后端请求,伪造 headers
来实现,先将歌词 jsonp 格式转换为 json 格式,再使用第三方库 js-base64
进行 Base64 解码操作,最后再使用第三方库 lyric-parser
对歌词进行格式化
实现了侧滑显示歌词、歌词跟随进度条高亮等交互效果
增加了当前播放列表组件,可在其中加入/删除歌曲
排行页
普通组件,没什么好说的
排行页 -> 歌单详情页
复用歌单详情页,没什么好说的
搜索页
抓数据,写组件,另外,根据抓取的数据特征,做了上拉刷新的功能
考虑到数据量大且频繁的问题,对请求做了节流处理
考虑到移动端键盘占屏的问题,对滚动前的 input
做了 blur()
操作
对搜索历史进行了 localstorage
缓存,清空搜索历史时使用了改装过的 confirm
组件
支持将搜索的歌曲添加到播放列表
个人中心
将 localstorage
中 “我的收藏” 和 “最近播放” 反映到界面上
其他
此应用的全部数据来自 QQ音乐,推荐页的歌单列表及歌词是利用 axios
结合 node.js
代理后端请求抓取的。
全局通用的应用级状态使用 vuex
集中管理
全局引入 fastclick
库,消除 click 移动浏览器300ms延迟
页面是响应式的,适配常见的移动端屏幕,采用 flex
布局
# clone the repo into your disk.
$ git clone https://github.com/bxm0927/music-app.git
# install dependencies
$ npm install
# serve with hot reload at localhost:8080
$ npm run dev
# build for production with minification
$ npm run build
The code is available under the MIT license.