【小程序项目开发京东商城】uniapp之自定义搜索组件（上）组件UI

???欢迎来到???
??魔术之家！！??

该文章收录专栏
? 2022微信小程序京东商城实战 ?

专栏内容
? 京东商城uni-app项目搭建 ?
? 京东商城uni-app 配置tabBar & 窗口样式 ?
? 京东商城uni-app开发之分包配置 ?
? 京东商城uni-app开发之轮播图 ?
? 京东商城uni-app之分类导航区域 ?
? 京东商城uni-app 首页楼层商品 ?
? 京东商城uni-app 商品分类页面（上） ?
? 京东商城uni-app 商品分类页面（下） ?
? 京东商城uni-app之自定义搜索组件（上） ?
? 京东商城uni-app之自定义搜索组件（中） ?

文章目录

• 一、介绍并创建search分支（选读*）
• 二、自定义搜索组件UI结构
• • 2.1在`component`目录上创建组件
  • 2.2 定义自定义组件的UI结构
  • 2.3 解决一个小bug
• 三、封装自定义组件属性和click事件
• • 3.1 自定义属性
  • 3.2 click 事件绑定
• 四、导航跳转和吸顶效果
• • 4.1 导航跳转
  • 4.2 吸顶效果
• 个人总结（选读*）

• git checkout -b search 注释：创建分支并跳转

2.1在component目录上创建组件

2.2 定义自定义组件的UI结构

对于搜索图标，uni官方给我们了相应的组件

这些官方组件都放在了文件uni_modules目录下了，直接使用即可

• 模板

  搜索

• 样式

效果：

2.3 解决一个小bug

在滑动三级分类时，会发现显示的不完整，且此时搜索框是会可以被滑动，这是因为我们在scroll-view滑动组件中设置的高度是手机可用的高度，而此时搜索框组件占用了一部分高度，对应的，底部也会减少一部分高度，所以我们在设置其滑动组件高度时可以减去搜索框对应使用高度

各个高度如下

• 修改如下（减去50px)：

  onLoad() {
  // 调取手机高度数据
  const {
  windowHeight: Hight
  } = uni.getSystemInfoSync()
  this.windowHeight = Hight - 50 // 减去搜索框高度
  // 调取分类数据
  this.getCateList()
  },

成功解决

3.1 自定义属性

通过自定义属性增强组件的通用性（自定义背景颜色，圆角程度）

• 在props节点定义数据(类似在原生小程序中的properties属性，

• props是父组件与组件之间的通信，而data则是组件的私有数据，无法直接传参）

• 默认值为default属性

  props: {
  // 背景颜色
  bgcolor: {
  type: String,
  default: ‘#ff1e0a’
  },
  // 圆角尺寸
  radius: {
  type: Number,
  default: 100
  }
  },

• 在组件中动态绑定style，输入键值对

  




• 那么在使用该组件时，我们可以对其传参，设置背景颜色和圆角度，如
  （注意：在组件传参中，参数由双引号包裹起来·"" 如果参数字符串，那么字符串形式应该为 '字符串',不然报错会难以查找

效果：

3.2 click 事件绑定

实现点击该组件实现页面跳转到搜索页面，按照我们以往的思路我们自然而然地想为该组件绑定一个处理函数，那么该方法可不可行呢？

• 我们绑定一个事件处理函数，并在事件触发后打印ok：

  // 搜索框click事件
  gotosearch: () => {
  console.log(‘ok’)
  },

可以看到毫无效果：

• 原因：

当前为自定义组件绑定了 click事件处理函数,但是自定义组件本身并没有提供click事件，所以绑定无效，
那么为什么在常规组件中 ，如 view 可以呢，这是因为官方已经为这些常规组件封装好了 click事件，所以可以直接绑，而自定义组件并没有封装，所以即使绑定了也无法实现

• 解决

在自定义组件中，我们可以为最外层组件容器 view 绑定一个click事件（原理：使用官方组件封装的click点击事件判断触发）

并在该事件绑定函数中使用this.$emit调用父组件绑定函数



······

// 搜索框click事件
searchBoxHander() {
console.log('~~~~~')
this.$emit('click')
},
四、导航跳转和吸顶效果

4.1 导航跳转

• 创建搜索（search) 页面（在分包中创建）
  

• 在组件绑定函数gotosearch 跳转到编程时跳转页面

  // 搜索框click事件
gotosearch(){
uni.navigateTo({
url: '/subpackages/search/search'
})
},


效果：

4.2 吸顶效果

• 吸顶效果：保持顶部，不随滑动消失而消失

在分类页面由于整个 UI结构高度并没有 超出页面(滑动高度 + 搜索框高度 = 可用高度)，所以不需要配置吸顶效果，这里配置首页

首页配置

• UI结构

  




• 跳转页面时间处理函数

  // 跳转到自定义导航页面
  gotosearch(){
  uni.navigateTo({
  url:‘/subpackages/search/search’
  })

• 通过样式实现吸顶效果(重要）

  .search-box {
  position: sticky; // sticky 粘性的
  // 保持顶部
  top: 0;
  // 提高层级，避免被轮播图覆盖
  z-index: 999;
  }

效果：

一下只是个人的学习总结拙见，写得不好还请海涵。
由于我是半路出家，只学了一点html，css, 就直接学原生小程序，再到uni-app，所以基础不好，在面对原生小程序中遇到 bindtap,bindchange，这些事件处理函数有点懵，下意识当作一种函数，但实际上直接再组件中使用是官方封装好的，原本模样应该是 bind:tap = “函数名”， 这里的bind 是绑定事件的意思，而事件则是 tap（自定义名字），在官方组件内部已经封装好了事件，所以在后面学 父组件与子组件通信时候，我还在纳闷， bind: sync = ”函数名字“， 为啥说是自定义事件 bind:sync,且在子组件内使用 this.triggerEvent(触发事件）,就是触发该组件的事件sync（且可以传参），在uni-app则是以this.emit触发事件。例如click，在官方组件应该是判断是否点击如果点击则调用’this.$emit’触发事件函数。

综上要实现对自定义组件绑定click事件，可在自定义组件结构中最外层容器绑定click事件，使用官方封装好的事件处理，然后在click事件所绑定函数中this.$emit调用父组件调用函数

?谢谢你的阅读，您的点赞和收藏就是我创造的最大动力！?