0
点赞
收藏
分享

微信扫一扫

【 uniapp - 黑马优购 | 搜索框 】如何实现自定义搜索组件、搜索建议、搜索历史

今天你读书了吗 2023-02-24 阅读 68
uni-app微信小程序小程序jsonjavascriptHarmonyOS后端开发


【 uniapp - 黑马优购 | 搜索框 】如何实现自定义搜索组件、搜索建议、搜索历史_json

个人名片：

🐼作者简介：一名大二在校生，讨厌编程🎋
🐻‍❄️个人主页🥇：​小新爱学习.​ 
🕊️系列专栏：🖼️

  • ​​零基础学Java——小白入门必备​​
  • ​​重识C语言——复习回顾​​
  • ​​计算机网络体系———深度详讲​​
  • ​​微信小程序开发——实战开发​​
  • ​​基于黑马优选的小程序开发实战教程​​

🐓每日一句：🍭努力的意义是给所爱之人一个美好的未来！

文章目录

  • ​​5. 搜索​​
  • ​​5.0 创建 search 分支​​
  • ​​5.1 自定义搜索组件​​
  • ​​5.1.1 自定义 `my-search` 组件​​
  • ​​5.1.2 通过自定义属性增强组件的通用性​​
  • ​​5.1.3 为自定义组件封装 click 事件​​
  • ​​5.1.4 实现首页搜索组件的吸顶效果​​
  • ​​5.2 搜索建议​​
  • ​​5.2.1 渲染搜索页面的基本结构​​
  • ​​5.2.2 实现搜索框自动获取焦点​​
  • ​​5.2.3 实现搜索框的防抖处理​​
  • ​​5.2.4 根据关键词查询搜索建议列表​​
  • ​​5.2.5 渲染搜索建议列表​​
  • ​​5.3 搜索历史​​
  • ​​5.3.1 渲染搜索历史记录的基本结构​​
  • ​​5.3.2 实现搜索建议和搜索历史的按需展示​​
  • ​​5.3.3 将搜索关键词存入 `historyList`​​
  • ​​5.3.4 解决关键字前后顺序的问题​​
  • ​​5.3.5 解决关键词重复的问题​​
  • ​​5.3.6 将搜索历史记录持久化存储到本地​​
  • ​​5.3.7 清空搜索历史记录​​
  • ​​5.3.8 点击搜索历史跳转到商品列表页面​​
  • ​​5.4 分支的合并与提交​​

5. 搜索

5.0 创建 search 分支

运行如下的命令，基于 ​​master​​​ 分支在本地创建 ​​search​​ 子分支，用来开发搜索相关的功能：

git checkout -b search

5.1 自定义搜索组件

5.1.1 自定义 ​​my-search​​ 组件

  1. 在项目根目录的 ​​components​​​ 目录上，鼠标右键，选择 ​​新建组件​​​，填写组件信息后，最后点击 ​​创建​​ 按钮：

【 uniapp - 黑马优购 | 搜索框 】如何实现自定义搜索组件、搜索建议、搜索历史_小程序_02

  1. 在分类页面的 UI 结构中，直接以标签的形式使用 my-search 自定义组件：

<!-- 使用自定义的搜索组件 -->
<my-search></my-search>

  1. 定义 ​​my-search​​​ 组件的 ​​UI​​ 结构如下：

<template>
  <view class="my-search-container">
    <!-- 使用 view 组件模拟 input 输入框的样式 -->
    <view class="my-search-box">
      <uni-icons type="search" size="17"></uni-icons>
      <text class="placeholder">搜索</text>
    </view>
  </view>
</template>

注意：在当前组件中，我们使用 view 组件模拟 input 输入框的效果；并不会在页面上渲染真正的 input 输入框

  1. 美化自定义 ​​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;
  }
}

  1. 由于自定义的 ​​my-search​​​ 组件高度为 ​​50px​​，因此，需要重新计算分类页面窗口的可用高度：

onLoad() {
  const sysInfo = uni.getSystemInfoSync()
  // 可用高度 = 屏幕高度 - navigationBar高度 - tabBar高度 - 自定义的search组件高度
  this.wh = sysInfo.windowHeight - 50
}

5.1.2 通过自定义属性增强组件的通用性

为了增强组件的通用性，我们允许使用者自定义搜索组件的 ​​背景颜色​​ 和 ​​圆角尺寸​​。

  1. 通过 ​​props​​​ 定义 ​​bgcolor​​​ 和 ​​radius​​ 两个属性，并指定值类型和属性默认值：

props: {
  // 背景颜色
  bgcolor: {
    type: String,
    default: '#C00000'
  },
  // 圆角尺寸
  radius: {
    type: Number,
    // 单位是 px
    default: 18
  }
}

  1. 通过属性绑定的形式，为 ​​.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>

  1. 移除对应 ​​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 事件

  1. 在 ​​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>

  1. 在 ​​my-search​​​ 自定义组件的 ​​methods​​ 节点中，声明事件处理函数如下：

methods: {
  // 点击了模拟的 input 输入框
  searchBoxHandler() {
    // 触发外界通过 @click 绑定的 click 事件处理函数
    this.$emit('click')
  }
}

  1. 在分类页面中使用 ​​my-search​​​ 自定义组件时，即可通过 ​​@click​​ 为其绑定点击事件处理函数：

<!-- 使用自定义的搜索组件 -->
<my-search @click="gotoSearch"></my-search>
同时在分类页面中，定义 gotoSearch 事件处理函数如下：

methods: {
   // 跳转到分包中的搜索页面
   gotoSearch() {
     uni.navigateTo({
       url: '/subpkg/search/search'
     })
   }
}

5.1.4 实现首页搜索组件的吸顶效果

  1. 在 ​​home​​​ 首页定义如下的 ​​UI​​ 结构：

<!-- 使用自定义的搜索组件 -->
<view class="search-box">
  <my-search @click="gotoSearch"></my-search>
</view>
在 home 首页定义如下的事件处理函数：

gotoSearch() {
  uni.navigateTo({
    url: '/subpkg/search/search'
  })
}

  1. 通过如下的样式实现吸顶的效果：

.search-box {
  // 设置定位效果为“吸顶”
  position: sticky;
  // 吸顶的“位置”
  top: 0;
  // 提高层级，防止被轮播图覆盖
  z-index: 999;
}

5.2 搜索建议

5.2.1 渲染搜索页面的基本结构

  1. 定义如下的 ​​UI​​ 结构：

<view class="search-box">
  <!-- 使用 uni-ui 提供的搜索组件 -->
  <uni-search-bar @input="input" :radius="100" cancelButton="none"></uni-search-bar>
</view>

  1. 修改 ​​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;
}

  1. 实现搜索框的吸顶效果：

.search-box {
  position: sticky;
  top: 0;
  z-index: 999;
}

  1. 定义如下的 ​​input​​ 事件处理函数：

methods: {
  input(e) {
    // e.value 是最新的搜索内容
    console.log(e.value)
  }
}

5.2.2 实现搜索框自动获取焦点

  1. 修改 ​​components​​​ -> ​​uni-search-bar​​​ -> ​​uni-search-bar.vue​​​ 组件，把 ​​data​​​ 数据中的 ​​show​​​ 和 ​​showSync​​​ 的值，从默认的 ​​false​​​ 改为 ​​true​​ 即可：

data() {
  return {
    show: true,
    showSync: true,
    searchVal: ""
  }
}

使用手机扫码预览，即可在真机上查看效果。

5.2.3 实现搜索框的防抖处理

  1. 在 ​​data​​​ 中定义防抖的延时器 ​​timerId​​ 如下：

data() {
  return {
    // 延时器的 timerId
    timer: null,
    // 搜索关键词
    kw: ''
  }
}

  1. 修改 input 事件处理函数如下：

input(e) {
  // 清除 timer 对应的延时器
  clearTimeout(this.timer)
  // 重新启动一个延时器，并把 timerId 赋值给 this.timer
  this.timer = setTimeout(() => {
    // 如果 500 毫秒内，没有触发新的输入事件，则为搜索关键词赋值
    this.kw = e.value
    console.log(this.kw)
  }, 500)
}

5.2.4 根据关键词查询搜索建议列表

  1. 在 ​​data​​ 中定义如下的数据节点，用来存放搜索建议的列表数据：

data() {
  return {
    // 搜索结果列表
    searchResults: []
  }
}

  1. 在防抖的 ​​setTimeout​​​ 中，调用 ​​getSearchList​​ 方法获取搜索建议列表：

this.timer = setTimeout(() => {
  this.kw = e.value
  // 根据关键词，查询搜索建议列表
  this.getSearchList()
}, 500)

  1. 在 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 渲染搜索建议列表

  1. 定义如下的 ​​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>

  1. 美化搜索建议列表：

.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;
    }
  }
}

  1. 点击搜索建议的 ​​Item​​ 项，跳转到商品详情页面：

gotoDetail(goods_id) {
  uni.navigateTo({
    // 指定详情页面的 URL 地址，并传递 goods_id 参数
    url: '/subpkg/goods_detail/goods_detail?goods_id=' + goods_id
  })
}

5.3 搜索历史

5.3.1 渲染搜索历史记录的基本结构

  1. 在 ​​data​​ 中定义搜索历史的假数据：

data() {
  return {
    // 搜索关键词的历史记录
    historyList: ['a', 'app', 'apple']
  }
}

  1. 渲染搜索历史区域的 ​​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 :text="item" v-for="(item, i) in historyList" :key="i"></uni-tag>
  </view>
</view>

  1. 美化搜索历史区域的样式：

.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 实现搜索建议和搜索历史的按需展示

  1. 当搜索结果列表的长度​​不为 0​​的时候​​（searchResults.length !== 0）​​，需要展示搜索建议区域，隐藏搜索历史区域
  2. 当搜索结果列表的长度​​等于 0​​的时候​​（searchResults.length === 0）​​，需要隐藏搜索建议区域，展示搜索历史区域
  3. 使用 ​​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​​

  1. 直接将搜索关键词 ​​push​​​ 到 ​​historyList​​ 数组中即可

methods: {
  // 根据搜索关键词，搜索商品建议列表
  async getSearchList() {
    // 省略其它不必要的代码...

    // 1. 查询到搜索建议之后，调用 saveSearchHistory() 方法保存搜索关键词
    this.saveSearchHistory()
  },
  // 2. 保存搜索关键词的方法
  saveSearchHistory() {
    // 2.1 直接把搜索关键词 push 到 historyList 数组中
    this.historyList.push(this.kw)
  }
}

  1. 上述实现思路存在的问题：
  • 关键词前后顺序的问题（可以调用数组的 reverse() 方法对数组进行反转）
  • 关键词重复的问题（可以使用 Set 对象进行去重操作）

5.3.4 解决关键字前后顺序的问题

  1. ​​data​​​ 中的 ​​historyList​​ 不做任何修改，依然使用 ​​push​​ 进行末尾追加
  2. 定义一个计算属性 ​​historys​​，将 ​​historyList​​ 数组 ​​reverse​​ 反转之后，就是此计算属性的值：

computed: {
  historys() {
    // 注意：由于数组是引用类型，所以不要直接基于原数组调用 reverse 方法，以免修改原数组中元素的顺序
    // 而是应该新建一个内存无关的数组，再进行 reverse 反转
    return [...this.historyList].reverse()
  }
}

  1. 页面中渲染搜索关键词的时候，不再使用 ​​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 解决关键词重复的问题

  1. 修改 ​​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 将搜索历史记录持久化存储到本地

  1. 修改 ​​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))
}

  1. 在 ​​onLoad​​ 生命周期函数中，加载本地存储的搜索历史记录：

onLoad() {
  this.historyList = JSON.parse(uni.getStorageSync('kw') || '[]')
}

5.3.7 清空搜索历史记录

  1. 为清空的图标按钮绑定 ​​click​​ 事件：

<uni-icons type="trash" size="17" @click="cleanHistory"></uni-icons>
在 methods 中定义 cleanHistory 处理函数：

// 清空搜索历史记录
cleanHistory() {
  // 清空 data 中保存的搜索历史
  this.historyList = []
  // 清空本地存储中记录的搜索历史
  uni.setStorageSync('kw', '[]')
}

5.3.8 点击搜索历史跳转到商品列表页面

  1. 为搜索历史的 ​​Item​​​ 项绑定 ​​click​​ 事件处理函数：

<uni-tag :text="item" v-for="(item, i) in historys" :key="i" @click="gotoGoodsList(item)"></uni-tag>

  1. 在 ​​methods​​​ 中定义 ​​gotoGoodsList​​ 处理函数：

// 点击跳转到商品列表页面
gotoGoodsList(kw) {
  uni.navigateTo({
    url: '/subpkg/goods_list/goods_list?query=' + kw
  })
}

5.4 分支的合并与提交

  1. 将 ​​search​​ 分支进行本地提交：

git add .
git commit -m "完成了搜索功能的开发"

  1. 将本地的 ​​search​​ 分支推送到码云：

git push -u origin search

  1. 将本地 ​​search​​​ 分支中的代码合并到 ​​master​​ 分支：

git checkout master
git merge search
git push

  1. 删除本地的 ​​search​​ 分支：

git branch -d search

【 uniapp - 黑马优购 | 搜索框 】如何实现自定义搜索组件、搜索建议、搜索历史_微信小程序_03


举报

相关推荐

前端自定义搜索框实现

搜索插入图片javascript前端开发

Android自定义搜索框（EditText）的搜索功能实现，过滤ListView

Android自定义搜索框EditText搜索功能实现过滤ListViewandroid系统/运维

Qt学习之自定义搜索框

自定义搜索框qtc++

自定义EditText实现类iOS风格搜索框

EditText输入法搜索androidTextjQuery前端开发

bootstraptable表头添加自定义搜索框（带文本,下拉,弹窗多选搜索）

bootstrapbootstraptable列表搜索table搜索javascriptJavaScript前端开发

自定义带搜索的对话框

androidandroid studio

uniapp-历史搜索记录

微信小程序小程序

c#自定义LookUpCotent，下拉搜索框

SystemClick控件.Net后端开发

黑马搜索_下拉框提示

搜索jqueryjavascript编程语言

react ant protable自定义搜索下拉框

react.jsjavascript前端
0 条评论