4. 分类
简要描述:
请求URL:
https://api-ugo-web.itheima.net/api/public/v1/categories
请求方式:
- GET
参数: 无
返回示例
{
"message": [
{
"cat_id": 1,
"cat_name": "大家电",
"cat_pid": 0,
"cat_level": 0,
"cat_deleted": false,
"cat_icon": "",
"children": [
{
"cat_id": 3,
"cat_name": "电视",
"cat_pid": 1,
"cat_level": 1,
"cat_deleted": false,
"cat_icon": "",
"children": [
{
"cat_id": 5,
"cat_name": "曲面电视",
"cat_pid": 3,
"cat_level": 2,
"cat_deleted": false,
"cat_icon": "https://api-ugo-web.itheima.net/full/2fb113b32f7a2b161f5ee4096c319afedc3fd5a1.jpg"
}
]
}
]
}
],
"meta": {
"msg": "获取成功",
"status": 200
}
}
返回参数说明
参数名 | 类型 | |
---|---|---|
cat_id | int | 分类id |
cat_name | string | 分类名称 |
children | array | 子节点 |
cat_icon | string | 图标 |
4.0 创建 cate 分支
运行如下的命令,基于 master
分支在本地创建 cate
子分支,用来开发分类页面相关的功能:
git checkout -b cate
4.1 渲染分类页面的基本结构
定义页面结构如下:
<template> <view> <view class="scroll-view-container"> <!-- 左侧的滚动视图区域 --> <scroll-view class="left-scroll-view" scroll-y :style="{height: wh + 'px'}"> <view class="left-scroll-view-item active">xxx</view> <view class="left-scroll-view-item">xxx</view> <view class="left-scroll-view-item">xxx</view> <view class="left-scroll-view-item">xxx</view> <view class="left-scroll-view-item">xxx</view> <view class="left-scroll-view-item">多复制一些节点,演示纵向滚动效果...</view> </scroll-view> <!-- 右侧的滚动视图区域 --> <scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}"> <view class="left-scroll-view-item">zzz</view> <view class="left-scroll-view-item">zzz</view> <view class="left-scroll-view-item">zzz</view> <view class="left-scroll-view-item">zzz</view> <view class="left-scroll-view-item">多复制一些节点,演示纵向滚动效果</view> </scroll-view> </view> </view> </template>
动态计算窗口的剩余高度:
<script> export default { data() { return { // 窗口的可用高度 = 屏幕高度 - navigationBar高度 - tabBar 高度 wh: 0 }; }, onLoad() { // 获取当前系统的信息 const sysInfo = uni.getSystemInfoSync() // 为 wh 窗口可用高度动态赋值 this.wh = sysInfo.windowHeight } } </script>
美化页面结构:
.scroll-view-container { display: flex; .left-scroll-view { width: 120px; .left-scroll-view-item { line-height: 60px; background-color: #f7f7f7; text-align: center; font-size: 12px; // 激活项的样式 &.active { background-color: #ffffff; position: relative; // 渲染激活项左侧的红色指示边线 &::before { content: ' '; display: block; width: 3px; height: 30px; background-color: #c00000; position: absolute; left: 0; top: 50%; transform: translateY(-50%); } } } } }
4.2 获取分类数据
在
data
中定义分类数据节点:data() { return { // 分类数据列表 cateList: [] } }
调用获取分类列表数据的方法:
onLoad() { // 调用获取分类列表数据的方法 this.getCateList() }
定义获取分类列表数据的方法:
methods: { async getCateList() { // 发起请求 const { data: res } = await uni.$http.get('/api/public/v1/categories') // 判断是否获取失败 if (res.meta.status !== 200) return uni.$showMsg() // 转存数据 this.cateList = res.message } }
4.3 动态渲染左侧的一级分类列表
循环渲染列表结构:
<!-- 左侧的滚动视图区域 --> <scroll-view class="left-scroll-view" scroll-y :style="{height: wh + 'px'}"> <block v-for="(item, i) in cateList" :key="i"> <view class="left-scroll-view-item">{{item.cat_name}}</view> </block> </scroll-view>
<block/>
标签上,以渲染一个包含多节点的结构块。在
data
中定义默认选中项的索引:data() { return { // 当前选中项的索引,默认让第一项被选中 active: 0 } }
循环渲染结构时,为选中项动态添加
.active
类名:<block v-for="(item, i) in cateList" :key="i"> <view :class="['left-scroll-view-item', i === active ? 'active' : '']">{{item.cat_name}}</view> </block>
为一级分类的
Item
项绑定点击事件处理函数activeChanged
:<block v-for="(item, i) in cateList" :key="i"> <view :class="['left-scroll-view-item', i === active ? 'active' : '']" @click="activeChanged(i)">{{item.cat_name}}</view> </block>
定义
activeChanged
事件处理函数,动态修改选中项的索引:methods: { // 选中项改变的事件处理函数 activeChanged(i) { this.active = i } }
4.4 动态渲染右侧的二级分类列表
在
data
中定义二级分类列表的数据节点:data() { return { // 二级分类列表 cateLevel2: [] } }
修改
getCateList
方法,在请求到数据之后,为二级分类列表数据赋值:async getCateList() { const { data: res } = await uni.$http.get('/api/public/v1/categories') if (res.meta.status !== 200) return uni.$showMsg() this.cateList = res.message // 为二级分类赋值 this.cateLevel2 = res.message[0].children }
修改
activeChanged
方法,在一级分类选中项改变之后,为二级分类列表数据重新赋值:activeChanged(i) { this.active = i // 为二级分类列表重新赋值 this.cateLevel2 = this.cateList[i].children }
循环渲染右侧二级分类列表的 UI 结构:
<!-- 右侧的滚动视图区域 --> <scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}"> <view class="cate-lv2" v-for="(item2, i2) in cateLevel2" :key="i2"> <view class="cate-lv2-title">/ {{item2.cat_name}} /</view> </view> </scroll-view>
美化二级分类的标题样式:
.cate-lv2-title { font-size: 12px; font-weight: bold; text-align: center; padding: 15px 0; }
4.5 动态渲染右侧的三级分类列表
在二级分类的 组件中,循环渲染三级分类的列表结构:
<!-- 右侧的滚动视图区域 --> <scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}"> <view class="cate-lv2" v-for="(item2, i2) in cateLevel2" :key="i2"> <view class="cate-lv2-title">/ {{item2.cat_name}} /</view> <!-- 动态渲染三级分类的列表数据 --> <view class="cate-lv3-list"> <!-- 三级分类 Item 项 --> <view class="cate-lv3-item" v-for="(item3, i3) in item2.children" :key="i3"> <!-- 图片 --> <image :src="item3.cat_icon"></image> <!-- 文本 --> <text>{{item3.cat_name}}</text> </view> </view> </view> </scroll-view>
美化三级分类的样式:
.cate-lv3-list { display: flex; flex-wrap: wrap; .cate-lv3-item { width: 33.33%; margin-bottom: 10px; display: flex; flex-direction: column; align-items: center; image { width: 60px; height: 60px; } text { font-size: 12px; } } }
4.6 切换一级分类后重置滚动条的位置
在
data
中定义 滚动条距离顶部的距离:data() { return { // 滚动条距离顶部的距离 scrollTop: 0 } }
动态为右侧的
<scroll-view>
组件绑定scroll-top
属性的值:<!-- 右侧的滚动视图区域 --> <scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}" :scroll-top="scrollTop"></scroll-view>
切换一级分类时,动态设置
scrollTop
的值:// 选中项改变的事件处理函数 activeChanged(i) { this.active = i this.cateLevel2 = this.cateList[i].children // 让 scrollTop 的值在 0 与 1 之间切换 this.scrollTop = this.scrollTop === 0 ? 1 : 0 // 可以简化为如下的代码: // this.scrollTop = this.scrollTop ? 0 : 1 }
4.7 点击三级分类跳转到商品列表页面
为三级分类的
Item
项绑定点击事件处理函数如下:<view class="cate-lv3-item" v-for="(item3, i3) in item2.children" :key="i3" @click="gotoGoodsList(item3)"> <image :src="item3.cat_icon"></image> <text>{{item3.cat_name}}</text> </view>
定义事件处理函数如下:
// 点击三级分类项跳转到商品列表页面 gotoGoodsList(item3) { uni.navigateTo({ url: '/subpkg/goods_list/goods_list?cid=' + item3.cat_id }) }
4.8 分支的合并与提交
将
cate
分支进行本地提交:git add . git commit -m "完成了分类页面的开发"
将本地的
cate
分支推送到码云:git push -u origin cate
将本地
cate
分支中的代码合并到master
分支:git checkout master git merge cate git push
删除本地的
cate
分支:git branch -d cate
5. 搜索
接口描述:
- 搜索建议查询
请求URL:
https://api-ugo-web.itheima.net/api/public/v1/goods/qsearch
请求方式:
- GET
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
query | 是 | string | 关键字 |
返回示例
{
"message": [
{
"goods_id": 57444,
"goods_name": "创维(Skyworth)42X6 42英寸10核智能酷开网络平板液晶电视(黑色)"
}
],
"meta": {
"msg": "获取成功",
"status": 200
}
}
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
goods_id | number | 商品id |
goods_name | string | 商品名称 |
5.0 创建 search 分支
运行如下的命令,基于 master 分支在本地创建 search 子分支,用来开发搜索相关的功能:
git checkout -b search
5.1 自定义搜索组件
5.1.1 自定义 my-search 组件
- 在项目根目录的
components
目录上,鼠标右键,选择新建组件
,填写组件信息后,最后点击创建
按钮:
>项目根目录如果没有`components`文件夹,自己手动建一个就行
在分类页面的 UI 结构中,直接以标签的形式使用
my-search
自定义组件:<!-- 使用自定义的搜索组件 --> <my-search></my-search>
定义
my-search
组件的 UI 结构如下:<template> <view class="my-search-container"> <!-- 使用 view 组件模拟 input 输入框的样式 --> <view class="my-search-box"> <!--uni图标组件--> <uni-icons type="search" size="17"></uni-icons> <text class="placeholder">搜索</text> </view> </view> </template>
注意:在当前组件中,我们使用
view
组件模拟input
输入框的效果;并不会在页面上渲染真正的input
输入框。uni-icons
图标组件详情请见:链接美化自定义
search
组件的样式:.my-search-container { background-color: #c00000; height: 50px; padding: 0 10px; display: flex; align-items: center; } .my-search-box { height: 36px; background-color: #ffffff; border-radius: 15px; width: 100%; display: flex; align-items: center; justify-content: center; .placeholder { font-size: 15px; margin-left: 5px; } }
由于自定义的
my-search
组件高度为50px
,因此,需要重新计算分类页面窗口的可用高度:onLoad() { const sysInfo = uni.getSystemInfoSync() // 可用高度 = 屏幕高度 - navigationBar高度 - tabBar高度 - 自定义的search组件高度 this.wh = sysInfo.windowHeight - 50 }
5.1.2 通过自定义属性增强组件的通用性
为了增强组件的通用性,我们允许使用者自定义搜索组件的 背景颜色
和 圆角尺寸
。
通过
props
定义bgcolor
和radius
两个属性,并指定值类型和属性默认值://my-search.vue //和data节点平级 props: { // 背景颜色 bgcolor: { type: String, default: '#C00000' }, // 圆角尺寸 radius: { type: Number, // 单位是 px default: 18 } }
通过属性绑定的形式,为
.my-search-container
盒子和.my-search-box
盒子动态绑定style
属性:<view class="my-search-container" :style="{'background-color': bgcolor}"> <view class="my-search-box" :style="{'border-radius': radius + 'px'}"> <uni-icons type="search" size="17"></uni-icons> <text class="placeholder">搜索</text> </view> </view>
移除对应 scss 样式中的 背景颜色 和 圆角尺寸:
.my-search-container { // 移除背景颜色,改由 props 属性控制 // background-color: #C00000; height: 50px; padding: 0 10px; display: flex; align-items: center; } .my-search-box { height: 36px; background-color: #ffffff; // 移除圆角尺寸,改由 props 属性控制 // border-radius: 15px; width: 100%; display: flex; align-items: center; justify-content: center; .placeholder { font-size: 15px; margin-left: 5px; } }
5.1.3 为自定义组件封装 click 事件
在
my-search
自定义组件内部,给类名为.my-search-box
的view
绑定click
事件处理函数:<view class="my-search-box" :style="{'border-radius': radius + 'px'}" @click="searchBoxHandler"> <uni-icons type="search" size="17"></uni-icons> <text class="placeholder">搜索</text> </view>
在
my-search
自定义组件的methods
节点中,声明事件处理函数如下:methods: { // 点击了模拟的 input 输入框 searchBoxHandler() { // 触发外界通过 @click 绑定的 click 事件处理函数 this.$emit('click') } }
- 在
subpkg
分包目录下新建search
分包页面 在分类页面中使用
my-search
自定义组件时,即可通过@click
为其绑定点击事件处理函数:<!-- 使用自定义的搜索组件 --> <my-search @click="gotoSearch"></my-search>
同时在分类页面中,定义
gotoSearch
事件处理函数如下:methods: { // 跳转到分包中的搜索页面 gotoSearch() { uni.navigateTo({ url: '/subpkg/search/search' }) } }
为自定义组件封装 click
事件目的是解决在==自定义组件上直接绑定点击事件@click
无效==的问题
- 你可以试试在
my-search
组件内部不做处理,直接在分类页面为该组件绑定点击事件,你就会发现绑定的这个gotoSearch
事件无效
实际在my-search
组件内部做的处理就是利用了父子组件通信:
@click="gotoSearch"
相当于分类页面向my-search
传了一个名为click
的参数my-search
可以通过emit('click')
调用这个参数(调用该参数就会执行分类页面的gotoSearch
方法)- 这里的
click
只是一个自定义的参数名,你可以写成其它的,比如(@myclick="gotoSearch"
,emit('myclick')
)只要emit
调用的参数与传来的一致就行
**其实有一种非常简单的方法可以不利用父子组件通信解决这种问题:
在对组件添加点击事件时加上**.native
@click.native="gotoSearch"
5.1.4 实现首页搜索组件的吸顶效果
在 home 首页定义如下的 UI 结构:
<!-- 使用自定义的搜索组件 --> <view class="search-box"> <my-search @click="gotoSearch"></my-search> </view>
在 home 首页定义如下的事件处理函数:
gotoSearch() { uni.navigateTo({ url: '/subpkg/search/search' }) }
通过如下的样式实现吸顶的效果:
.search-box { // 设置定位效果为“吸顶” position: sticky; // 吸顶的“位置” top: 0; // 提高层级,防止被轮播图覆盖 z-index: 999; }
5.2 搜索建议
5.2.1 渲染搜索页面的基本结构
定义如下的 UI 结构:
<!-- search.vue --> <view class="search-box"> <!-- 使用 uni-ui 提供的搜索组件 --> <uni-search-bar @input="input" :radius="100" cancelButton="none"></uni-search-bar> </view>
uni-search-bar
组件: 点击查看修改
uni_modules-> uni-search-bar -> components-> uni-search-bar.vue
组件,将默认的白色搜索背景改为#C00000
的红色背景:.uni-searchbar { /* #ifndef APP-NVUE */ display: flex; /* #endif */ flex-direction: row; position: relative; padding: 10px; //修改颜色 background-color: #C00000; }
实现搜索框的吸顶效果:
// search.vue .search-box { position: sticky; top: 0; z-index: 999; }
定义如下的
input
事件处理函数:methods: { input(e) { // e是最新的搜索内容 console.log(e) } }
5.2.2 实现搜索框自动获取焦点
给
uni-search-bar
组件添加:focus="true"
即可<uni-search-bar @input="input" :radius="100" cancelButton="none" :focus="true"></uni-search-bar>
- 使用手机扫码预览,即可在真机上查看效果。
5.2.3 实现搜索框的防抖处理
在
data
中定义防抖的延时器timerId
如下:// search.vue data() { return { // 延时器的 timerId timer: null, // 搜索关键词 kw: '' } }
修改
input
事件处理函数如下:input(e) { // 清除 timer 对应的延时器 clearTimeout(this.timer) // 重新启动一个延时器,并把 timerId 赋值给 this.timer this.timer = setTimeout(() => { // 如果 500 毫秒内,没有触发新的输入事件,则为搜索关键词赋值 this.kw = e console.log(this.kw) }, 500) }
5.2.4 根据关键词查询搜索建议列表
在
data
中定义如下的数据节点,用来存放搜索建议的列表数据:data() { return { // 搜索结果列表 searchResults: [] } }
在防抖的
setTimeout
中,调用getSearchList
方法获取搜索建议列表:this.timer = setTimeout(() => { //去除输入值的前后空格 this.kw = e.trim() // 根据关键词,查询搜索建议列表 this.getSearchList() }, 500)
在
methods
中定义getSearchList
方法如下:// 根据搜索关键词,搜索商品建议列表 async getSearchList() { // 判断关键词是否为空 if (this.kw === '') { this.searchResults = [] return } // 发起请求,获取搜索建议列表 const { data: res } = await uni.$http.get('/api/public/v1/goods/qsearch', { query: this.kw }) if (res.meta.status !== 200) return uni.$showMsg() this.searchResults = res.message }
5.2.5 渲染搜索建议列表
定义如下的 UI 结构:
<!-- 搜索建议列表 --> <view class="sugg-list"> <view class="sugg-item" v-for="(item, i) in searchResults" :key="i" @click="gotoDetail(item.goods_id)"> <view class="goods-name">{{item.goods_name}}</view> <uni-icons type="arrowright" size="16"></uni-icons> </view> </view>
美化搜索建议列表:
.sugg-list { padding: 0 5px; .sugg-item { font-size: 12px; padding: 13px 0; border-bottom: 1px solid #efefef; display: flex; align-items: center; justify-content: space-between; .goods-name { // 文字不允许换行(单行文本) white-space: nowrap; // 溢出部分隐藏 overflow: hidden; // 文本溢出后,使用 ... 代替 text-overflow: ellipsis; margin-right: 3px; } } }
点击搜索建议的
Item
项,跳转到商品详情页面:gotoDetail(goods_id) { uni.navigateTo({ // 指定详情页面的 URL 地址,并传递 goods_id 参数 url: '/subpkg/goods_detail/goods_detail?goods_id=' + goods_id }) }
5.3 搜索历史
5.3.1 渲染搜索历史记录的基本结构
在
data
中定义搜索历史的假数据:data() { return { // 搜索关键词的历史记录 historyList: ['a', 'app', 'apple'] } }
渲染搜索历史区域的 UI 结构:
<!-- 搜索历史 --> <view class="history-box"> <!-- 标题区域 --> <view class="history-title"> <text>搜索历史</text> <uni-icons type="trash" size="17"></uni-icons> </view> <!-- 列表区域 --> <view class="history-list"> <uni-tag :inverted="true" type="error" :text="item" v-for="(item, i) in historyList" :key="i"></uni-tag> </view> </view>
美化搜索历史区域的样式:
.history-box { padding: 0 5px; .history-title { display: flex; justify-content: space-between; align-items: center; height: 40px; font-size: 13px; border-bottom: 1px solid #efefef; } .history-list { display: flex; flex-wrap: wrap; .uni-tag { margin-top: 5px; margin-right: 5px; } } }
5.3.2 实现搜索建议和搜索历史的按需展示
- 当搜索结果列表的长度不为 0的时候(
searchResults.length !== 0
),需要展示搜索建议区域,隐藏搜索历史区域 - 当搜索结果列表的长度等于 0的时候(
searchResults.length === 0
),需要隐藏搜索建议区域,展示搜索历史区域 使用 v-if 和 v-else 控制这两个区域的显示和隐藏,示例代码如下:
<!-- 搜索建议列表 --> <view class="sugg-list" v-if="searchResults.length !== 0"> <!-- 省略其它代码... --> </view> <!-- 搜索历史 --> <view class="history-box" v-else> <!-- 省略其它代码... --> </view>
5.3.3 将搜索关键词存入 historyList
直接将搜索关键词
push
到historyList
数组中即可methods: { // 根据搜索关键词,搜索商品建议列表 async getSearchList() { // 省略其它不必要的代码... // 1. 查询到搜索建议之后,调用 saveSearchHistory() 方法保存搜索关键词 this.saveSearchHistory() }, // 2. 保存搜索关键词的方法 saveSearchHistory() { // 2.1 直接把搜索关键词 push 到 historyList 数组中 this.historyList.push(this.kw) } }
- 上述实现思路存在的问题:
2.1 关键词前后顺序的问题(可以调用数组的
reverse
() 方法对数组进行反转)2.2 关键词重复的问题(可以使用
Set 对象
进行去重操作)
5.3.4 解决关键字前后顺序的问题
data
中的historyList
不做任何修改,依然使用push
进行末尾追加定义一个计算属性
historys
,将historyList
数组reverse
反转之后,就是此计算属性的值:computed: { historys() { // 注意:由于数组是引用类型,所以不要直接基于原数组调用 reverse 方法,以免修改原数组中元素的顺序 // 而是应该新建一个内存无关的数组,再进行 reverse 反转 return [...this.historyList].reverse() } }
页面中渲染搜索关键词的时候,不再使用
data
中的historyList
,而是使用计算属性historys
:<view class="history-list"> <uni-tag :text="item" v-for="(item, i) in historys" :key="i"></uni-tag> </view>
5.3.5 解决关键词重复的问题
修改
saveSearchHistory
方法如下:// 保存搜索关键词为历史记录 saveSearchHistory() { // this.historyList.push(this.kw) // 1. 将 Array 数组转化为 Set 对象 const set = new Set(this.historyList) // 2. 调用 Set 对象的 delete 方法,移除对应的元素 set.delete(this.kw) // 3. 调用 Set 对象的 add 方法,向 Set 中添加元素 set.add(this.kw) // 4. 将 Set 对象转化为 Array 数组 this.historyList = Array.from(set) }
5.3.6 一行代码解决上述保存关键字顺序和重复的问题
<!-- 搜索历史列表区域 -->
<view class="history-list">
<uni-tag @click="gotoGoodsList(item)" :inverted="true" type="error" :text="item" v-for="(item,i) in historyList"
:key="i"></uni-tag>
</view>
// 保存搜索关键词的方法
saveSearchHistory() {
this.historyList=[...new Set([this.kw,...this.historyList])]
}
注意:这个种方法是我自己想的,并不是黑马教程里老师讲的,不知道为什么老师要用那么复杂的方法,知道的大佬还请解答一下🤓
5.3.6 将搜索历史记录持久化存储到本地
修改
saveSearchHistory
方法如下:// 保存搜索关键词为历史记录 saveSearchHistory() { const set = new Set(this.historyList) set.delete(this.kw) set.add(this.kw) this.historyList = Array.from(set) // 调用 uni.setStorageSync(key, value) 将搜索历史记录持久化存储到本地 uni.setStorageSync('kw', JSON.stringify(this.historyList)) }
在
onLoad
生命周期函数中,加载本地存储的搜索历史记录:onLoad() { this.historyList = JSON.parse(uni.getStorageSync('kw') || '[]') }
5.3.7 清空搜索历史记录
为清空的图标按钮绑定
click
事件:<uni-icons type="trash" size="17" @click="cleanHistory"></uni-icons>
在
methods
中定义cleanHistory
处理函数:// 清空搜索历史记录 cleanHistory() { // 清空 data 中保存的搜索历史 this.historyList = [] // 清空本地存储中记录的搜索历史 uni.setStorageSync('kw', '[]') }
5.3.8 点击搜索历史跳转到商品列表页面
为搜索历史的
Item
项绑定click
事件处理函数:<uni-tag :text="item" v-for="(item, i) in historys" :key="i" @click="gotoGoodsList(item)"></uni-tag>
在
methods
中定义gotoGoodsList
处理函数:// 点击跳转到商品列表页面 gotoGoodsList(kw) { uni.navigateTo({ url: '/subpkg/goods_list/goods_list?query=' + kw }) }
5.4 分支的合并与提交
将
search
分支进行本地提交:git add . git commit -m "完成了搜索功能的开发"
将本地的
search
分支推送到码云:git push -u origin search
将本地
search
分支中的代码合并到master
分支:git checkout master git merge search git push
删除本地的
search
分支:git branch -d search