今日学习目标
-
能够掌握vant组件库的使用
-
能够掌握vant组件自定义样式能力
-
能够掌握组件库使用和文档使用能力
-
能够完成网易云音乐案例
-
案例-网易云音乐
1.0 网易云音乐-本地接口
目的: 请求网易云音乐服务器API接口-获取数据
总结: 反向代理就是用本地开启cors的服务器去转发请求拿到数据
1.1 网易云音乐-本地接口启动
目的: 启动本地网易云音乐API服务
在今天的笔记铺垫中, 大家自学下载了一个项目启动即可
1.2 网易云音乐-前端项目初始化
目标: 初始化项目, 下载必备包, 引入初始文件, 配置按需自动引入vant, 创建页面组件
- 初始化工程
vue create music-demo - 下载需要的所有第三方依赖包
yarn add axios vant vue-router - 引入笔记代码里准备好的reset.css和flexible.js - 实现样式初始化和适配问题 - 引入到main.js
- 本次vant使用自动按需引入的方式
文档: https://vant-contrib.gitee.io/vant/#/zh-CN/quickstart
yarn add babel-plugin-import -D
在babel.config.js - 添加插件配置
plugins: [
[‘import’, {
libraryName: ‘vant’,
libraryDirectory: ‘es’,
style: true
}, ‘vant’]
]
1.3 网易云音乐-需求分析
根据需求, 创建路由所需要的5个页面的组件
Layout(布局, 顶部导航和底部导航) > 二级路由 Home 和 Search
Play
创建需要的views下的页面组件4个
views/Layout/index.vue - 负责布局(上下导航 - 中间二级路由切换首页和搜索页面)
/* 中间内容区域 - 容器样式(留好上下导航所占位置) */
.main {
padding-top: 46px;
padding-bottom: 50px;
}
views/Home/index.vue - 标题和歌名样式
/* 标题 */
.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; /** 隐藏超出的内容 **/
}
views/Search/index.vue
/* 搜索容器的样式 */
.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;
}
views/Play/index.vue - 直接从预习资料里复制(节省时间) - 可自己扩展阅读代码
1.4 网易云音乐-路由准备
目标: 准备路由配置, 显示不同路由页面
router/index.js - 准备路由 - 以及默认显示Layout, 然后Layout默认显示二级路由的首页
// 路由-相关模块
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'
Vue.use(VueRouter)
const routes = [
{
path: '/',
redirect: '/layout'
},
{
path: '/layout',
component: Layout,
redirect: '/layout/home',
children: [
{
path: 'home',
component: Home,
meta: { // meta保存路由对象额外信息的
title: "首页"
}
},
{
path: 'search',
component: Search,
meta: {
title: "搜索"
}
}
]
},
{
path: '/play',
component: Play
}
]
const router = new VueRouter({
routes
})
export default router
main.js - 引入路由对象, 注册到new Vue中
import router from '@/router'
new Vue({
render: h => h(App),
router
}).$mount('#app')
App.vue中留好router-view显示路由页面
<template>
<div>
<router-view></router-view>
</div>
</template>
总结: 把项目的框搭好, 逐个攻破
1.5 网易云音乐-Tabbar组件
目标: 点击底部导航, 切换路由页面显示
文档: https://vant-contrib.gitee.io/vant/#/zh-CN/tabbar
-
注册Tabbar组件, 在main.js中
import { Tabbar, TabbarItem } from ‘vant’;
Vue.use(Tabbar);
Vue.use(TabbarItem); -
在Layout.vue中使用
首页
搜索
<script> export default { } </script> <style scoped> /* 中间内容区域 - 容器样式(留好上下导航所占位置) */ .main { padding-top: 46px; padding-bottom: 50px; } </style>
-
开启路由模式 route属性, 和to属性指向要切换的路由路径
首页
搜索
总结: van-tabbar开启route
1.6 网易云音乐-NavBar导航组件
目标: 实现顶部标题展示
文档: https://vant-contrib.gitee.io/vant/#/zh-CN/nav-bar
-
main.js - 注册NavBar组件
import { NavBar } from ‘vant’;
Vue.use(NavBar); -
复制文档里的, 然后删删只留标题
<script> export default { activeTitle: "首页" } </script>
1.7 网易云音乐-NavBar标题切换
目标: 实现点击底部导航/刷新非第一页面页面, 导航标题正确显示
- 在router/index.js - 给
r
o
u
t
e
里
需
要
导
航
标
题
的
添
加
m
e
t
a
元
信
息
属
性
p
a
t
h
:
′
/
l
a
y
o
u
t
′
,
c
o
m
p
o
n
e
n
t
:
L
a
y
o
u
t
,
r
e
d
i
r
e
c
t
:
′
/
l
a
y
o
u
t
/
h
o
m
e
′
,
c
h
i
l
d
r
e
n
:
[
p
a
t
h
:
′
h
o
m
e
′
,
c
o
m
p
o
n
e
n
t
:
H
o
m
e
,
m
e
t
a
:
/
/
m
e
t
a
保
存
路
由
对
象
额
外
信
息
的
t
i
t
l
e
:
"
首
页
"
,
p
a
t
h
:
′
s
e
a
r
c
h
′
,
c
o
m
p
o
n
e
n
t
:
S
e
a
r
c
h
,
m
e
t
a
:
t
i
t
l
e
:
"
搜
索
"
]
,
L
a
y
o
u
t
.
v
u
e
中
监
听
route里需要导航标题的添加meta元信息属性 { path: '/layout', component: Layout, redirect: '/layout/home', children: [ { path: 'home', component: Home, meta: { // meta保存路由对象额外信息的 title: "首页" } }, { path: 'search', component: Search, meta: { title: "搜索" } } ] }, Layout.vue中监听
route里需要导航标题的添加meta元信息属性path:′/layout′,component:Layout,redirect:′/layout/home′,children:[path:′home′,component:Home,meta://meta保存路由对象额外信息的title:"首页",path:′search′,component:Search,meta:title:"搜索"],Layout.vue中监听route改变:
给导航active的值设置KaTeX parse error: Expected '}', got 'EOF' at end of input: …iveTitle: this.route.meta.title, // "默认"顶部导航要显示的标题 (默认获取当前路由对象里的meta中title值)
};
},
// 路由切换 - 侦听$route对象改变
watch: {
KaTeX parse error: Expected '}', got 'EOF' at end of input: …veTitle = this.route.meta.title; // 提取切换后路由信息对象里的title显示
},
},
};
总结: 点击底部导航和刷新当前网页, 都能保证导航标题的正确显示
1.8 网易云音乐-网络请求封装
目标: 不想把网络请求散落在各个逻辑页面里, 不然以后找起来改起来很麻烦
-
封装utils/request.js - 基于axios进行二次封装 - 设置基础地址
// 网络请求 - 二次封装
import axios from ‘axios’
axios.defaults.baseURL = “http://localhost:3000”
export default axios -
封装src/api/Home.js
统一封装网络请求方法
// 文件名-尽量和模块页面文件名统一(方便查找)
import request from ‘@/utils/request’// 首页 - 推荐歌单 export const recommendMusic = params => request({ url: '/personalized', params // 将来外面可能传入params的值 {limit: 20} })
-
在src/api/index.js - 统一导出接口供外部使用
// api文件夹下 各个请求模块js, 都统一来到index.js再向外导出
import {recommendMusic} from ‘./Home’export const recommendMusicAPI = recommendMusic // 请求推荐歌单的方法导出
-
在main.js - 测试使用一下.
import { recommendMusicAPI } from ‘@/api/index’
async function myFn(){
const res = await recommendMusicAPI({limit: 6});
console.log(res);
}
myFn();
总结: 封装网络请求方法目的, 方便我们统一管理
1.9 网易云音乐-首页-推荐歌单
接口地址: /personalized
-
布局采用van-row和van-col
布局文档https://vant-contrib.gitee.io/vant/#/zh-CN/col -
使用vant内置的图片组件来显示图片
-
在main.js注册使用的组件
import { Col, Row, Image as VanImage } from ‘vant’;Vue.use(Col); Vue.use(Row); Vue.use(VanImage);
-
在api/index.js下定义推荐歌单的接口方法
// 首页 - 推荐歌单
export const recommendMusic = params => request({
url: ‘/personalized’,
params
// 将来外面可能传入params的值 {limit: 20}
}) -
把数据请求回来, 用van-image和p标签展示推荐歌单和歌单名字
推荐歌单
{{ obj.name }}
<script> import { recommendMusicAPI } from "@/api"; export default { data() { return { reList: [], // 推荐歌单数据 }; }, async created() { const res = await recommendMusicAPI({ limit: 6, }); console.log(res); this.reList = res.data.result; }, }; </script>
1.10 网易云音乐- 首页-最新音乐
目标: van-cell单元格使用
请求地址: /personalized/newsong
-
引入van-cell使用 - 注册组件main.js中
import {Cell} from ‘vant’;
Vue.use(Cell); -
定义接口请求方法 - api/index.js
// 首页 - 推荐最新音乐
export const newMusic = params => request({
url: “/personalized/newsong”,
params
}) -
列表数据铺设 - 插入自定义标签
推荐歌单
{{ obj.name }}
最新音乐
<template #right-icon>
<script> import { recommendMusicAPI, newMusicAPI } from "@/api"; export default { data() { return { reList: [], // 推荐歌单数据 songList: [], // 最新音乐数据 }; }, async created() { const res = await recommendMusicAPI({ limit: 6, }); console.log(res); this.reList = res.data.result; const res2 = await newMusicAPI({ limit: 20 }) console.log(res2); this.songList = res2.data.result }, }; </script>
1.11 网易云音乐-搜索-热搜关键字
目标: 完成热搜关键字铺设
搜索框 – van-search组件
api/Search.js – 热搜关键字 - 接口方法
Search/index.vue引入-获取热搜关键字 - 铺设页面
点击文字填充到输入框
-
准备搜索界面标签
热门搜索
热搜关键字
总结: 写好标签和样式, 拿到数据循环铺设, 点击关键词填入到van-search中
1.12 网易云音乐-搜索-点击热词-搜索结果
目标: 点击热词填充到输入框-出搜索结果
api/Search.js - 搜索结果, 接口方法
Search/index.vue引入-获取搜索结果 - 铺设页面
和热搜关键字容器 – 互斥显示
点击文字填充到输入框, 请求搜索结果铺设
-
搜索结果显示区域标签+样式(直接复制/vant文档找)
<div class="search_wrap"> <!-- 标题 --> <p class="hot_title">最佳匹配</p> <van-cell center title='结果名字' > <template #right-icon> <van-icon name="play-circle-o" size="0.6rem"/> </template> </van-cell> </div>
-
点击 - 获取搜索结果 - 循环铺设页面
热门搜索
总结: 点击热词后, 调用接口传入关键词, 返回数据铺设
1.13 网易云音乐-输入框-搜索结果
目标: 监测输入框改变-拿到搜索结果
观察van-search组件是否支持和实现input事件
绑定@input事件和方法
在事件处理方法中获取对应的值使用
如果搜索不存在的数据-要注意接口返回字段不同
-
绑定@input事件在van-search上
<van-search shape=“round” v-model=“value” placeholder=“请输入搜索关键词” @input=“inputFn”/>
-
实现输入框改变 - 获取搜索结果铺设
async inputFn() {
// 输入框值改变
if (this.value.length === 0) {
// 搜索关键词如果没有, 就把搜索结果清空阻止网络请求发送(提前return)
this.resultList = [];
return;
}
const res = await this.getListFn();
console.log(res);
// 如果搜索结果响应数据没有songs字段-无数据
if (res.data.result.songs === undefined) {
this.resultList = [];
return;
}
this.resultList = res.data.result.songs;
},
总结: 监测输入框改变-保存新的关键词去请求结果回来铺设
1.14 网易云音乐-搜索结果-加载更多
目标: 触底后, 加载下一页数据
观察接口文档: 发现需要传入offset和分页公式
van-list组件监测触底执行onload事件
配合后台接口, 传递下一页的标识
拿到下一页数据后追加到当前数组末尾即可
-
设置van-list组件实现相应的属性和方法, 让page++去请求下页数据
<van-list v-model="loading" :finished="finished" finished-text="没有更多了" @load="onLoad" > <van-cell center v-for="obj in resultList" :key="obj.id" :title="obj.name" :label="obj.ar[0].name + ' - ' + obj.name" > <template #right-icon> <van-icon name="play-circle-o" size="0.6rem" /> </template> </van-cell> </van-list>
总结: list组件负责UI层监测触底, 执行onload函数, page++, 请求下页数据, 和现在数据合并显示更多, 设置loading为false, 确保下次触底还能执行onLoad
1.15 网易云音乐-加载更多-bug修复
目标: 如果只有一页数据/无数据判断
无数据/只有一页数据, finished为true
防止list组件触底再加载更多
还要测试-按钮点击/输入框有数据情况的加载更多
正确代码
async fn(val) {
// 点击热搜关键词
+ this.finished = false; // 点击新关键词-可能有新的数据
this.value = val; // 选中的关键词显示到搜索框
const res = await this.getListFn();
console.log(res);
this.resultList = res.data.result.songs;
+ this.loading = false; // 本次数据加载完毕-才能让list加载更多
},
async inputFn() {
+ this.finished = false // 输入框关键字改变-可能有新数据(不一定加载完成了)
// 输入框值改变
if (this.value.length === 0) {
// 搜索关键词如果没有, 就把搜索结果清空阻止网络请求发送(提前return)
this.resultList = [];
return;
}
const res = await this.getListFn();
console.log(res);
+ // 如果搜索结果响应数据没有songs字段-无数据
+ if (res.data.result.songs === undefined) {
+ this.resultList = [];
+ return;
+ }
this.resultList = res.data.result.songs;
+ this.loading = false;
},
async onLoad() {
// 触底事件(要加载下一页的数据咯), 内部会自动把loading改为true
this.page++;
const res = await this.getListFn();
+ if (res.data.result.songs === undefined) { // 没有更多数据了
+ this.finished = true; // 全部加载完成(list不会在触发onload方法)
+ this.loading = false; // 本次加载完成
+ return;
+ }
this.resultList = [...this.resultList, ...res.data.result.songs];
+ this.loading = false; // 数据加载完毕-保证下一次还能触发onload
},
总结: 在3个函数 上和下, 设置finished还未完成, 最后要把loading改成false, 判断songs字段, 对这里的值要非常熟悉才可以
1.16 网易云音乐-输入框-防抖
目标: 输入框触发频率过高
输入框输入"asdfghjkl"
接着快速的删除
每次改变-马上发送网络请求
网络请求异步耗时 – 数据回来后还是铺设到页面上
解决:
引入防抖功能
async inputFn() {
// 目标: 输入框改变-逻辑代码-慢点执行
// 解决: 防抖
// 概念: 计时n秒, 最后执行一次, 如果再次触发, 重新计时
// 效果: 用户在n秒内不触发这个事件了, 才会开始执行逻辑代码
if (this.timer) clearTimeout(this.timer);
this.timer = setTimeout(async () => {
this.finished = false; // 输入框关键字改变-可能有新数据(不一定加载完成了)
// 输入框值改变
if (this.value.length === 0) {
// 搜索关键词如果没有, 就把搜索结果清空阻止网络请求发送(提前return)
this.resultList = [];
return;
}
const res = await this.getListFn();
console.log(res);
// 如果搜索结果响应数据没有songs字段-无数据
if (res.data.result.songs === undefined) {
this.resultList = [];
return;
}
this.resultList = res.data.result.songs;
this.loading = false;
}, 900);
},
总结: 降低函数执行频率
1.17 网易云音乐-页码bug修复
目标: 第一个关键词page已经+到了10, 再第二个关键词应该从1开始
加载更多时, page已经往后计数了
重新获取时, page不是从第一页获取的
点击搜索/输入框搜索时, 把page改回1
代码如下:
async fn(val) {
// 点击热搜关键词
+ this.page = 1; // 点击重新获取第一页数据
this.finished = false; // 点击新关键词-可能有新的数据
this.value = val; // 选中的关键词显示到搜索框
const res = await this.getListFn();
console.log(res);
this.resultList = res.data.result.songs;
this.loading = false; // 本次数据加载完毕-才能让list加载更多
},
async inputFn() {
// 目标: 输入框改变-逻辑代码-慢点执行
// 解决: 防抖
// 概念: 计时n秒, 最后执行一次, 如果再次触发, 重新计时
// 效果: 用户在n秒内不触发这个事件了, 才会开始执行逻辑代码
if (this.timer) clearTimeout(this.timer);
this.timer = setTimeout(async () => {
+ this.page = 1; // 点击重新获取第一页数据
this.finished = false; // 输入框关键字改变-可能有新数据(不一定加载完成了)
// 输入框值改变
if (this.value.length === 0) {
// 搜索关键词如果没有, 就把搜索结果清空阻止网络请求发送(提前return)
this.resultList = [];
return;
}
const res = await this.getListFn();
console.log(res);
// 如果搜索结果响应数据没有songs字段-无数据
if (res.data.result.songs === undefined) {
this.resultList = [];
return;
}
this.resultList = res.data.result.songs;
this.loading = false;
}, 900);
},
总结: 切换时, 让page页面回到1
1.18 网易云音乐-Layout边距优化
目标: 上下导航会盖住中间内容
我们的头部导航和底部导航挡住了中间内容
给中间路由页面设置上下内边距即可
在Layout/index.vue中
/* 中间内容区域 - 容器样式(留好上下导航所占位置) */
.main {
padding-top: 46px;
padding-bottom: 50px;
}
1.19 网易云音乐-SongItem封装
目标: 把首页和搜索结果的歌曲cell封装起来
创建src/components/SongItem.vue
<template>
<van-cell center :title="name" :label="author + ' - ' + name">
<template #right-icon>
<van-icon name="play-circle-o" size="0.6rem"/>
</template>
</van-cell>
</template>
<script>
export default {
props: {
name: String, // 歌名
author: String, // 歌手
id: Number, // 歌曲id (标记这首歌曲-为将来跳转播放页做准备)
}
};
</script>
<style scoped>
/* 给单元格设置底部边框 */
.van-cell {
border-bottom: 1px solid lightgray;
}
</style>
Home/index.vue - 重构
注意: author字段不同
<SongItem v-for="obj in songList"
:key="obj.id"
:name="obj.name"
:author="obj.song.artists[0].name"
:id="obj.id"
></SongItem>
Search/index.vue - 重构
注意: author字段不同
<SongItem
v-for="obj in resultList"
:key="obj.id"
:name="obj.name"
:author="obj.ar[0].name"
:id="obj.id"
></SongItem>
总结: 遇到重复标签要封装
1.20 网易云音乐-播放音乐
目标: 从预习资料拿到播放的api和页面, 配置好路由规则
时间关系,这个页面不用写, 直接用, 注释在备课代码里写好了
组件SongItem里 – 点击事件
api/Play.js – 提前准备好 – 接口方法
跳转到Play页面 – 把歌曲id带过进去
在SongItem.vue - 点击播放字体图标
methods: {
playFn(){
this.$router.push({
path: '/play',
query: {
id: this.id // 歌曲id, 通过路由跳转传递过去
}
})
}
}
总结: 准备好播放页, 点击播放传歌曲id过去, 到播放页-再请求响应数据和歌曲地址用audio标签播放
1.21 网易云音乐-vant适配
目标: 切换不同机型, 刷新后看看标签大小适配吗
- postcss – 配合webpack翻译css代码
- postcss-pxtorem – 配合webpack, 自动把px转成rem
- 新建postcss.config.js – 设置相关配置
- 重启服务器, 再次观察Vant组件是否适配
-
下载postcss和postcss-pxtorem@5.1.1
postcss作用: 是对css代码做降级处理
postcss-pxtorem: 自动把所有代码里的css样式的px, 自动转rem -
src/新建postcss.config.js
module.exports = {
plugins: {
‘postcss-pxtorem’: {
// 能够把所有元素的px单位转成Rem
// rootValue: 转换px的基准值。
// 例如一个元素宽是75px,则换成rem之后就是2rem。
rootValue: 37.5,
propList: [’*’]
}
}
}
以iphone6为基准, 37.5px为基准值换算rem
今日总结
- 掌握vant组件库的使用 - 找组件, 引组件, 用组件
- 能够对vant组件自带样式进行覆盖自定义
- 遇到重复的标签, 自己也封装了一个复用的组件
- 掌握查询文档和使用每个属性的方式