目录
一、项目技术二、准备工作1、初始化Vue项目2、配置Vant UI组件库3、下载并使用vue-router库4、接口API5、postcss插件三、分析页面实现功能1、路由页面准备2、封装axios网路请求3、公共组件四、具体页面实现1、Layout组件相关2、Home组件相关① 封装home相关axios请求② Home组件代码3、Search组件相关① 封装search相关axios请求②Search组件代码4、Comment组件相关① 封装comment相关axios请求②Comment组件代码5、Play组件相关① 封装play相关axios请求②Play组件代码6、API统一出口五、Play和Comment组件详解一、项目技术
基于 Vue + Vant UI组件库 实现网易云音乐
Vant UI （有赞团队打造的移动端Vue组件库）地址：https://vant-contrib.gitee.io/vant/#/zh-CN
共项目共实现四个功能：主页Home、搜索页Search、评论页Comment、播放页Play
网易云手机端地址：https://y./m
二、准备工作
1、初始化Vue项目
① 安装Vue脚手架
npm i @vue/cli -g
② 切换到要创建项目的目录，然后创建music项目
vue create music
③ 启动项目
npm run serve
2、配置Vant UI组件库
① 下载vant ui库
注意项：Vant组件库要下载配合Vue2版本的使用
npm i vant@latest-v2
② 配置按需引入样式
在基于 vue-cli 的项目中使用 Vant 时，可以使用unplugin-vue-components 插件，它可以自动引入组件，并按需引入组件的样式。
安装插件
npm i unplugin-vue-components -D
配置插件：在 vue.config.js 文件中配置插件
const {VantResolver } = require('unplugin-vue-components/resolvers');const ComponentsPlugin = require('unplugin-vue-components/webpack');module.exports = {configureWebpack: {plugins: [ComponentsPlugin({resolvers: [VantResolver()],}),],},};
优点：减少代码体积
缺点：使用起来会变得繁琐一些
3、下载并使用vue-router库
① 下载vuex库（vue2中必须使用vue-router3版本）
npm i vue-router@3
② 引入
import VueRouter from "vue-router"
③ 使用VueRouter
Vue.use(VueRouter)
④ 使用VueRouter之后，在创建vm的时候就可以传入一个router配置项
new Vue({//使用VueRouter之后，创建vm的时候可以传入一个router配置项router,render:h=>h(App),}).$mount("#app")
4、接口API
项目地址：/#/
文档地址：https://binaryify.github.io/NeteaseCloudMusicApi/#/
① 安装项目
// 从github上克隆项目到本地git clone git@:Binaryify/NeteaseCloudMusicApi.git// 安装依赖包npm install
② 运行项目
node app.js
③ 本地地址
http://localhost:3000
5、postcss插件
webpack的一个插件，将要px转化为rex插件
中文官网：/
① 安装postcss
npm install postcss
② 安装postcss-pxtorem（最新版本6.0与Vant不兼容，因此安装5.1.1版本）
postcss-pxtorem是postcss插件，把px转换成rem
npm install postcss-pxtorem@5.1.1 --s-d
③ 根目录下创建postcss.config.js文件
module.exports = {plugins: {'postcss-pxtorem': {rootValue: 37.5, // 已设计稿宽度375px为例 vant用的是375的设计稿propList: ['*'],},},};
三、分析页面实现功能
分析：
①根据项目页面构成，我们要创建4个vue组件，分别是views/Home、views/Search、views/Comment、views/Play
②页面之间通过路由跳转，因此要创建文件夹 router/index.js
③页面所需要的数据是通过发送网络请求获取的，因此要创建untils/request.js文件，api/index.js作为统一出口
④首页和搜索页的顶部和底部一样，可以将这部分提取为一个组件，因此要创建views/layout.vue
⑤首页最新新闻和搜索页最佳匹配样式结构一样，因此也可以提取出来，创建components/songItem.vue组件
1、路由页面准备
layout属于一级路由，home和search属于二级路由；comment、play属于一级路由
src/router/index.js文件代码
import Vue from "vue";import VueRouter from "vue-router";import Layout from "@/views/Layout";import Home from "@/views/Home";import Search from "@/views/Search";import Play from "@/views/Play";import Comment from "@/views/Comment"Vue.use(VueRouter);export default new VueRouter({routes:[{path:"/",redirect:'/layout',},{path:"/layout",redirect:'/layout/home',component:Layout,children:[{name:'home',path:'home',component:Home,meta:{title:'首页'}},{name:'search',path:'search',component:Search,meta:{title:'搜索'}}]},{name:'play',path:'/play',component:Play,},{name:'comment',path:'/comment',component:Comment}]})
2、封装axios网路请求
新建untils/request.js
import axios from "axios";// axios.create()创建一个axios对象const request = axios.create({//基础路径，发请求的时候，路径当中会出现api，不用你手写baseURL:'http://localhost:3000',//请求时间超过5秒timeout:5000});export default request
3、公共组件
components/songItem.vue组件
<template><van-cell :id="id" :title="name" :label="autor" @click="getComment(id)"><template #right-icon><van-icon name="play-circle-o" class="search-icon" @touchstart ="playFn(id)"/></template></van-cell></template><script>export default {name:'SongItem',props:{name:String,autor:String,id:Number},methods:{playFn(id){this.$router.push({name:'play',query:{id:id}});console.log(id);},getComment(id){this.$router.push({name:'comment',query:{id}})}}}</script>
四、具体页面实现
1、Layout组件相关
views/Layout/index.vue
<template><div><!-- 顶部 --><van-nav-bar :title="activeTitle" fixed/><!-- 中间部分 --><div class="main"><!-- 缓存组件,当切换路由时不被销毁 --><keep-alive include="Home,Search"><router-view></router-view></keep-alive></div><!-- 底部 --><van-tabbar v-model="active"><van-tabbar-item icon="home-o" to="/layout/home">首页</van-tabbar-item><van-tabbar-item icon="search" to="/layout/search">搜索</van-tabbar-item></van-tabbar></div></template><script>import {ref } from 'vue';export default {name:'Layout',data(){return {activeTitle:this.$route.meta.title,}},setup() {const active = ref(0);return {active,};},// 通过监听路由切换watch:{$route(){this.activeTitle = this.$route.meta.title}}}</script><style scoped>.main {padding-top: 56px;padding-bottom: 66px;}</style>
2、Home组件相关
① 封装home相关axios请求
api/home.js
import request from "@/untils/request";// 推荐音乐export const hotMusic = (params)=>request({url:'/personalized',params})// 最新音乐export const newMusic = (params)=>request({url:'/personalized/newsong',params})
② Home组件代码
views/Home/index.vue
<template><div><p class="title">推荐歌单</p><van-row gutter="10" ><van-col span="8" v-for="m in hotMusic" :key="m.id"><van-image width="100%" height="3rem" :src="m.picUrl"/><p class="song_name">{{m.name}}</p></van-col></van-row><p class="title">最新音乐</p><SongItem v-for="n in newMusic" :key="n.id" :name="n.name" :autor="n.song.artists[0].name + n.name" :id="n.id"></SongItem></div></template><script>import SongItem from "@/components/songItem.vue";import {hotMusicAPI,newMusicAPI} from "@/api";export default {name:'Home',data(){return {hotMusic:[],newMusic:[],}},components:{SongItem},async created(){// 获取推荐歌曲const resHot= await hotMusicAPI({limit:6})this.hotMusic = resHot.data.result;// 获取最新音乐const resNew = await newMusicAPI({limit:20});this.newMusic = resNew.data.result;},}</script><style>/* 标题 */.title {padding: 0.266667rem 0.24rem;margin: 0 0 0.24rem 0;background-color: #eee;color: #333;font-size: 15px;}/* 推荐歌单 - 歌名 */.song_name {font-size: 0.346667rem;padding: 0 0.08rem;margin-bottom: 0.266667rem;word-break: break-all;text-overflow: ellipsis;display: -webkit-box; /** 对象作为伸缩盒子模型显示 **/-webkit-box-orient: vertical; /** 设置或检索伸缩盒对象的子元素的排列方式 **/-webkit-line-clamp: 2; /** 显示的行数 **/overflow: hidden; /** 隐藏超出的内容 **/}</style>
3、Search组件相关
① 封装search相关axios请求
import request from "@/untils/request";//热词export const hotSearch = ()=>request({url:'/search/hot/detail'});// 关键词搜索export const keywordSearch = (params) => request({url:"/cloudsearch",params})
②Search组件代码
<template><div><van-search v-model="searchValue" placeholder="请输入搜索关键词" shape="round"/><!-- 热门搜索关键字 --><div class="search_wrap" v-if="searchValue.length==0"><p class="hot_title">热门搜索</p><div class="hot_name_wrap"><span class="hot_item" v-for="h in hotSearch" :key="h.score" @click="btn(h.searchWord)">{{h.searchWord}}</span></div></div><!-- 搜索结果 --><div class="search_wrap" v-else><p class="hot_title">最佳匹配</p><SongItem v-for="k in keywordSearch" :key="k.id" :name="k.name" :autor="k.ar[0].name + ' / '+ k.al.name" :id="k.id"></SongItem></div></div></template><script>import {hotSearchAPI,keywordSearchAPI} from "@/api";import SongItem from "@/components/songItem.vue";export default {name:'Search',data() {return {searchValue:'', // 搜索框的值hotSearch:[], // 热词keywordSearch:[] //关键词搜索结果}},components:{SongItem},async created(){//获取热搜词const hotSearch = await hotSearchAPI();this.hotSearch = hotSearch.data.data;},methods:{async btn(str){this.searchValue = str;const keywordSearch = await keywordSearchAPI({keywords:this.searchValue,type:1});this.keywordSearch = keywordSearch.data.result.songs;//点击热词不需要等待立即执行setTimeout(()=>{clearTimeout(this.timer);})},},watch:{// 通过监视searchValue的变化来获取输入框的内容searchValue(){if(this.searchValue.length==0) {return this. keywordSearch = []}else{//设置防抖减少向服务器发送请求。类似于王者荣耀回车clearTimeout(this.timer);this.timer = setTimeout(async()=>{const keywordSearch = await keywordSearchAPI({keywords:this.searchValue,type:1});this.keywordSearch = keywordSearch.data.result.songs;},3000)}}}}</script><style scoped>/* 热门搜索容器的样式 */.search_wrap {padding: 0.266667rem;}/*热门搜索文字标题样式 */.hot_title {font-size: 0.32rem;color: #666;}/* 热搜词_容器 */.hot_name_wrap {margin: 0.266667rem 0;}/* 热搜词_样式 */.hot_item {display: inline-block;height: 0.853333rem;margin-right: 0.213333rem;margin-bottom: 0.213333rem;padding: 0 0.373333rem;font-size: 0.373333rem;line-height: 0.853333rem;color: #333;border-color: #d3d4da;border-radius: 0.853333rem;border: 1px solid #d3d4da;}</style>
4、Comment组件相关
① 封装comment相关axios请求
import request from "@/untils/request";// 获取评论export const getComment = (params) =>request ({url:"/comment/hot",params})
②Comment组件代码
<template><div><van-nav-bar title="评论" fixed left-arrow @click-left="$router.back()"/><div><div class="main" ><!-- 下拉刷新 --><van-pull-refresh v-model="refreshing" @refresh="onRefresh" success-text="刷新成功"><van-list v-model="loading" :finished="finished" finished-text="没有更多了" @load="onLoad"><van-cell v-for="(c,index) in list" :key="index"><div class="wrap" ><div class="img_wrap"><img :src="c.user.avatarUrl" alt=""></div><div class="conent_wrap"><div class="header_wrap" ><div class="info_wrap"><p>{{c.user.nickname}}</p><p>{{c.time}}</p></div><div>{{c.likedCount}}点赞</div></div><div class="footer_wrap">{{c.content}}</div></div></div></van-cell></van-list></van-pull-refresh></div></div></div></template><script>import {getCommentAPI} from "@/api";export default {name:'Comment',data(){return {id : this.$route.query.id,commentsInfo:[], // 每次接收20个评论数据page:1, // 页码loading:false, // 下拉加载状态finished:false, // 所有数据是否加载完成状态refreshing:true, // 上拉加载状态list:[] // 所有数据}},methods: {//获取数据async getList(){const getComment = await getCommentAPI({id:this.id,type:0,limit:20,offset:(this.page -1 )*20});mentsInfo = getComment.data.hotComments;mentsInfo.forEach(obj=>this.list.push(obj))this.loading = false;},// 上拉刷新async onLoad(){console.log(this.list.length)if(this.loading){this.getList();this.page++;this.refreshing = false;}if(this.list.length %20 != 0) {this.loading = false;this.finished = true;}},// 下拉刷新async onRefresh(){this.finished = false;this.loading = true;this.onLoad();}},}</script><style scoped>.main {padding-top: 46px;}.wrap {display: flex;}.img_wrap {width: 0.8rem;height: 0.8rem;margin-right: 0.266667rem;}.img_wrap img {width: 100%;height: 100%;border-radius: 50%;}.conent_wrap {flex: 1;}.header_wrap {display: flex;}.info_wrap {flex: 1;}.info_wrap p:first-child {font-size: 0.373333rem;color: #666;}.info_wrap p:last-of-type {font-size: 0.24rem;color: #999;}.header_wrap div:last-of-type {color: #999;font-size: 0.293333rem;}.footer_wrap {font-size: 0.4rem;color: #333;}</style>
5、Play组件相关
① 封装play相关axios请求
import request from "@/untils/request";//获取音乐播放地址export const getSongById = (params)=>request({url:"/song/url/v1",params});//获取歌词export const getLyricById = (params)=>request({url:'/lyric',params});//获取歌曲详情export const getMusicById = (params)=>request({url:'/song/detail',params})
②Play组件代码
<template><div class="play"><!-- 模糊背景(靠样式设置), 固定定位 --><divclass="song-bg" :style="`background-image: url();`"></div><!-- 播放页头部导航 --><div class="header"><van-icon name="arrow-left" size="20" class="left-incon" @click="$router.back()"/></div><!-- 留声机 - 容器 --><div class="song-wrapper"><!-- 留声机本身(靠css动画做旋转) --><div class="song-turn ani" :style="`animation-play-state:${playState ? 'running' : 'paused'}`"><div class="song-img"><!-- 歌曲封面 --><img class="musicImg" :src="musicInfo.al.picUrl"/></div></div><!-- 播放按钮 --><div class="start-box" @click="audioStart"><span class="song-start" v-show="!playState"></span></div><!-- 播放歌词容器 --><div class="song-msg"><!-- 歌曲名 --><h2 class="m-song-h2"><span class="m-song-sname">{{ musicInfo.name }}-{{musicInfo.ar[0].name}}</span></h2><!-- 留声机 - 唱臂 --><div class="needle" :style="`transform: rotate(${needleDeg});`"></div><!-- 歌词部分-随着时间切换展示一句歌词 --><div class="lrcContent"><p class="lrc">{{ curLyric }}</p></div></div></div><!-- 音乐播放地址 --><audio ref="audio" preload="true" :src="songInfo.url" @timeupdate="timeupdate"></audio></div></template><script>// 获取歌曲详情和 歌曲的歌词接口import {getSongByIdAPI, getLyricByIdAPI,getMusicByIdAPI } from '@/api'export default {name: 'play',data() {return {playState: false, // 音乐播放状态(true暂停, false播放)id: this.$route.query.id, // 上一页传过来的音乐idsongInfo: {}, // 歌曲信息musicInfo:"", // 歌曲详情信息lyric: {}, // 歌词枚举对象(需要在js拿到歌词写代码处理后, 按照格式保存到这个对象)curLyric: '', // 当前显示哪句歌词lastLy: '' ,// 记录当前播放歌词}},computed: {needleDeg() {// 留声机-唱臂的位置属性return this.playState ? '-7deg' : '-38deg'}},async created(){// 获取歌曲详情, 和歌词方法const res = await getSongByIdAPI({id:this.id})this.songInfo = res.data.data[0];// 获取歌曲详情const musicInfo =await getMusicByIdAPI({ids:this.id});this.musicInfo = musicInfo.data.songs[0];// 获取-并调用formatLyric方法, 处理歌词const lyrContent = await getLyricByIdAPI({id:this.id});const lyricStr = lyrContent.data.lrc.lyricthis.lyric = this.formatLyric(lyricStr)// 初始化完毕先显示零秒歌词this.curLyric = this.lyric[0]},methods: {formatLyric(lyricStr) {// 可以看network观察歌词数据是一个大字符串, 进行拆分.let reg = /\[.+?\]/g //let timeArr = lyricStr.match(reg) // 匹配所有[]字符串以及里面的一切内容, 返回数组console.log(timeArr); // ["[00:00.000]", "[00:01.000]", ......]let contentArr = lyricStr.split(/\[.+?\]/).slice(1) // 按照[]拆分歌词字符串, 返回一个数组(下标为0位置元素不要,后面的留下所以截取)console.log(contentArr);let lyricObj = {} // 保存歌词的对象, key是秒, value是显示的歌词timeArr.forEach((item, index) => {// 拆分[00:00.000]这个格式字符串, 把分钟数字取出, 转换成秒let ms = item.split(':')[0].split('')[2] * 60// 拆分[00:00.000]这个格式字符串, 把十位的秒拿出来, 如果是0, 去拿下一位数字, 否则直接用2位的值let ss = item.split(':')[1].split('.')[0].split('')[0] === '0' ? item.split(':')[1].split('.')[0].split('')[1] : item.split(':')[1].split('.')[0]// 秒数作为key, 对应歌词作为valuelyricObj[ms + Number(ss)] = contentArr[index]})// 返回得到的歌词对象(可以打印看看)console.log(lyricObj);return lyricObj},// 监听播放audio进度, 切换歌词显示timeupdate(){// console.log(this.$refs.audio.currentTime)let curTime = Math.floor(this.$refs.audio.currentTime)// 避免空白出现if (this.lyric[curTime]) {this.curLyric = this.lyric[curTime]this.lastLy = this.curLyric} else {this.curLyric = this.lastLy}},// 播放按钮 - 点击事件audioStart() {if (!this.playState) {// 如果状态为falsethis.$refs.audio.play() // 调用audio标签的内置方法play可以继续播放声音} else {this.$refs.audio.pause() // 暂停audio的播放}this.playState = !this.playState // 点击设置对立状态},},}</script><style scoped>/* 歌曲封面 */.musicImg {position: absolute;top: 0;left: 0;bottom: 0;right: 0;width: 100%;margin: auto;width: 370rpx;height: 370rpx;border-radius: 50%;}/* 歌词显示 */.scrollLrc {position: absolute;bottom: 280rpx;width: 640rpx;height: 120rpx;line-height: 120rpx;text-align: center;}.header {height: 50px;}.play {position: fixed;top: 0;left: 0;right: 0;bottom: 0;z-index: 1000;}.song-bg {background-color: #161824;background-position: 50%;background-repeat: no-repeat;background-size: auto 100%;transform: scale(1.5);transform-origin: center;position: fixed;left: 0;right: 0;top: 0;height: 100%;overflow: hidden;z-index: 1;opacity: 1;filter: blur(25px); /*模糊背景 */}.song-bg::before{/*纯白色的图片做背景, 歌词白色看不到了, 在背景前加入一个黑色半透明蒙层解决 */content: " ";background: rgba(0, 0, 0, 0.5);position: absolute;left: 0;top: 0;right: 0;bottom:0;}.song-wrapper {position: fixed;width: 247px;height: 247px;left: 50%;top: 50px;transform: translateX(-50%);z-index: 10001;}.song-turn {width: 100%;height: 100%;background: url("./img/bg.png") no-repeat;background-size: 100%;}.start-box {position: absolute;width: 156px;height: 156px;position: absolute;left: 50%;top: 50%;transform: translate(-50%, -50%);display: flex;justify-content: center;align-items: center;}.song-start {width: 56px;height: 56px;background: url("./img/start.png");background-size: 100%;}.needle {position: absolute;transform-origin: left top;background: url("./img/needle-ab.png") no-repeat;background-size: contain;width: 73px;height: 118px;top: -40px;left: 112px;transition: all 0.6s;}.song-img {width: 154px;height: 154px;position: absolute;left: 50%;top: 50%;overflow: hidden;border-radius: 50%;transform: translate(-50%, -50%);}.m-song-h2 {margin-top: 20px;text-align: center;font-size: 18px;color: #fefefe;overflow: hidden;white-space: nowrap;text-overflow: ellipsis;}.lrcContent {margin-top: 50px;}.lrc {font-size: 14px;color: #fff;text-align: center;}.left-incon {position: absolute;top: 10px;left: 10px;font-size: 24px;z-index: 10001;color: #fff;}.ani {animation: turn 5s linear infinite;}@keyframes turn {0% {-webkit-transform: rotate(0deg);}100% {-webkit-transform: rotate(360deg);}}</style>
6、API统一出口
API/index.js
// 统一出口import {hotMusic,newMusic} from "@/api/home";import {hotSearch,keywordSearch} from "@/api/search";import {getSongById,getLyricById,getMusicById} from "@/api/play";import {getComment} from "@/api/comment";//导出推荐歌单方法export const hotMusicAPI = hotMusic//导出新歌方法export const newMusicAPI = newMusic//导入热搜export const hotSearchAPI = hotSearch;//导入关键词搜索export const keywordSearchAPI = keywordSearch;//播放音乐export const getSongByIdAPI = getSongById;//获取歌词export const getLyricByIdAPI = getLyricById;//获取歌曲详情export const getMusicByIdAPI = getMusicById;//获取评论export const getCommentAPI = getComment;
五、Play和Comment组件详解
在做项目的过程中，感觉Play组件歌词同步逻辑有点复杂，还有Comment组件上拉和下拉刷新也有点难，因此专门写了两篇详解，可以看一下~~~
Play组件详解：Play组件播放音乐并实现同步一次显示一行歌词
Comment组件详解：Comment组件评论页上拉和下拉刷新
觉得有用，记得点赞收藏哦~~
