uni-app之旅-day03-搜索
提示:文章写完后,目录可以自动生成,如何生成可参考右边的帮助文档
5. 搜索
提示:以下是本篇文章正文内容,下面案例可供参考
5.0 创建 search 分支
git checkout -b search
5.1 自定义搜索组件
- 🍔🍔🍔5.1.1 自定义 my-search 组件
- 在项目根目录的 components 目录上,鼠标右键,选择 新建组件
- 在分类cate.vue页面的 UI 结构中,直接以标签的形式使用 my-search 自定义组件
<!-- 使用自定义的搜索组件 -->
<my-search></my-search>
<view class="scroll-view-container">
<!-- 左侧滚动视图区域 -->
</view>
- 定义 my-search 组件的 UI 结构
<view class="my-search-container">
<!-- 使用 view 组件模拟 input 输入框的样式 -->
<view class="my-search-box">
<uni-icon type="search" size="17"></uni-icon>
<text class="placeholder">搜索</text>
</view>
</view>
- 注意:在当前组件中,我们使用 view 组件模拟 input 输入框的效果;并不会在页面上渲染真正的 input 输入框
.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,因此,需要重新计算cate.vue分类页面窗口的可用高度
onLoad(){
this.wh = sysInfo.windowHeight - 50;
}
5.1.2 my-search.vue组件通过自定义属性增强组件的通用性
- 🚜🚜🚜为了增强组件的通用性,我们允许使用者自定义搜索组件的 背景颜色 和 圆角尺寸
- 通过 props 定义 bgcolor 和 radius 两个属性,并指定值类型和属性默认值:
props:{
//背景颜色
bgcolor:{
type:String,
default:'#C00000'
},
//圆角尺寸
radius:{
type:Number,
default:18
}
}
- 通过属性绑定的形式,为 .my-search-container 盒子和 .my-search-box 盒子动态绑定 style 属性
<view class="my-search-container" :style="{'background-color':bgcolor}">
<!-- 使用 view 组件模拟 input 输入框的样式 -->
<view class="my-search-box" :style="{'border-radius':radius + 'px'}" @click="searchBoxHandler">
<uni-icon type="search" size="17"></uni-icon>
<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:{
searchBoxHandler(){
// 触发外界通过 @click 绑定的 click 自定义事件处理函数
this.$emit('click')
}
}
- 在分类页面中使用 my-search 自定义组件时,即可通过 @click 为其绑定点击事件处理函数
<!-- 使用自定义的搜索组件 -->
<my-search @click="gotoSearch"></my-search>
methods:{
//跳转到分包中的搜索页面
gotoSearch(){
uni.navigateTo({
url:'/subpkg/search/search'
})
}
}
5.2 搜索建议
5.2.1 渲染搜索页面的基本结构
- 🍕🍕🍕定义如下的 UI 结构
<view class="search-box">
<!-- 使用 uni-ui 提供的搜索组件 -->
<uni-search-bar @input="input" :radius="100" cancelButton="none"></uni-search-bar>
</view>
- 修改 components -> uni-search-bar -> uni-search-bar.vue 组件,将默认的白色搜索背景改为 #C00000 的红色背景
.uni-searchbar {
/* #ifndef APP-NVUE */
display: flex;
/* #endif */
flex-direction: row;
position: relative;
padding: 16rpx;
/* 将默认的 #FFFFFF 改为 #C00000 */
background-color: #c00000;
}
- 实现搜索框的吸顶效果
.search-box {
position: sticky;
top: 0;
z-index: 999;
}
- 定义如下的 input 事件处理函数
methods:{
input(e){
//e 是最新搜索内容
console.log(e)
}
}
5.2.2 实现搜索框自动获取焦点
- 🥞🥞🥞修改 components -> uni-search-bar -> uni-search-bar.vue 组件,把 data 数据中的 show 和 showSync 的值,从默认的 false 改为 true 即可
- 使用手机扫码预览,即可在真机上查看效果
5.2.3 实现搜索框的防抖处理
- 在search.vue组件 data 中定义防抖的延时器 timer 如下
data() {
return {
// 延时器的 timer
timer: null,
// 搜索关键词
kw: ''
}
}
- 修改 input 事件处理函数
methods:{
input(e){
clearTimeout(this.timer)
this.timer = setTimeout(()=>{
this.kw = e;//是搜索的值
console.log(this.kw)
},500)
}
}
5.2.4 根据关键词查询搜索建议列表
- 🍔🥟🍔在 data 中定义如下的数据节点,用来存放搜索建议的列表数据
data(){
return{
// 延时器的 timerId
timer: null,
// 存储搜索关键字
kw:'',
//存储搜索结果列表
searchResults:[]
}
}
- 在防抖的 setTimeout 中,调用 getSearchList 方法获取搜索建议列表
this.timer = setTimeout(()=>{
// 如果 500 毫秒内,没有触发新的输入事件,则为搜索关键词赋值
this.kw = e
//根据关键字,查询搜索建议列表
this.getSearchList()
console.log(this.kw)
},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
})
console.log(res)
if (res.meta.status !== 200) return uni.$showMsg()
this.searchResults = res.message;
}
定义如下的 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地址,并传递参数
url:'/subpkg/goods_detail/goods_detail?goods_id=' + goods_id
})
}
5.3 搜索历史
5.3.1 渲染搜索历史记录的基本结构
- 🍔🍔🍔在 data 中定义搜索历史的初始数据
historyList:['a','app','apple']
- 渲染搜索历史区域的 UI 结构
<!-- 搜索建议列表 -->
<view></view>
<!-- 历史记录 -->
<view class="history-box" v-else>
<!-- 标题区域 -->
<view class="history-title">
<text>搜索历史</text>
<uni-icons type="trash" size="17"></uni-icons>
</view>
<!-- 列表区域 -->
<view class="history-list">
<uni-tag :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
methods:{
async getSearchList(){
//省略其它代码...
this.saveSearchHistory()
},
saveSearchHistory(){
this.historyList.push(this.kw)
}
},
5.3.4 解决关键字前后顺序的问题
- 🍔🌮🍔定义一个计算属性 historys,将 historyList 数组 reverse 反转之后,就是此计算属性的值
computed:{
historys(){
return [...this.historyList].reverse()
}
}
- 页面中渲染搜索关键词的时候,不再使用 data 中的 historyList,而是使用计算属性 historys
<uni-tag :text="item" v-for="(item,i) in historyList" :key="i"></uni-tag>
5.3.5 解决关键词重复的问题和将搜索历史记录持久化存储到本地
saveSearchHistory(){
// this.historyList.push(this.kw)
// 借助Set数据结构去重 转换为Set
const set = new Set(this.historyList)
set.delete(this.kw)
set.add(this.kw)
this.historyList = Array.from(set)
//调用uni提供的setStorageSync(key,val) 将搜索历史记录持久化存储到本地
uni.setStorageSync('kw',JSON.stringify(this.historyList))
}
- 在 onLoad 生命周期函数中,加载本地存储的搜索历史记录
onLoad(){
this.historyList = JSON.parse(uni.getStorageSync('kw') || '[]')
}
5.3.7 清空搜索历史记录
- 🚜🚜🚜为清空的图标按钮绑定 click 事件
<text>搜索历史</text>
<uni-icons type="trash" size="17" @click="cleanHistory"></uni-icons>
- 在 methods 中定义 cleanHistory 处理函数
//清空搜索记录
cleanHistory(){
this.historyList = [];
uni.setStorageSync('kw','[]')
}
5.3.8 点击搜索历史跳转到商品列表页面
- 🍕🍕🍕为搜索历史的 Item 项绑定 click 事件处理函数
<!-- 列表区域 -->
<view class="history-list">
<uni-tag :text="item" v-for="(item,i) in historys" :key="i" @click="gotoGoodsList(item)"></uni-tag>
</view>
- 定义 gotoGoodsList 处理函数
//点击搜索历史跳转到商品列表页面
gotoGoodsList(kw){
uni.navigateTo({
url:'/subpkg/goods_list/goods_list?query=' + kw
})
}
5.4 分支的合并与提交
-
退回到项目根目录,打开cmd命令窗口
-
1.将search分支进行本地提交
– git add .
– git commit -m ‘’ -
2.将本地的 search 分支推送到码云
–git push -u origin search -
将本地 search 分支中的代码合并到 master 分支
–git checkout master
–git merge search -
3.将本地master推送到码云
–git push -
4.删除本地search分支
–git branch -d search
原文地址:https://blog.csdn.net/weixin_44423378/article/details/142651039
免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!