【小程序项目开发--京东商城】uni-app之自定义搜索组件(上)-- 组件UI

简介: 【小程序项目开发--京东商城】uni-app之自定义搜索组件(上)-- 组件UI

文章目录

一、介绍并创建search分支(选读*)

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

二、自定义搜索组件UI结构

2.1在component目录上创建组件

图片.png

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

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

图片.png

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

  • 模板
<template>
  <view>
    <!-- 搜索框容器 -->
    <view class="search-container">
      <!-- 搜索框内部盒子 -->
      <view class="search-box">
        <!-- 使用uni-ui 提供的图标组件 -->
        <uni-icons type="search" size="17"></uni-icons>
        <text class="search-content">搜索</text>
      </view>
    </view>
  </view>
</template>
  • 样式
<style lang="scss">
  .search-container {
    height: 100rpx;
    background-color: #ff1e0a;
    display: flex;
    align-items: center;
    // 上下 0 间距, 左右20间距
    padding: 0rpx 20rpx;
    .search-box {
      background-color: #ffffff;
      border-radius: 100rpx;
      height: 72rpx;
      width: 100%;
      display: flex;
      // 整体块级元素横向居中
      justify-content: center;
      // 项目内部元素居中
      align-items: center;
      .search-content {
        text-align: center;
        font-size: 30rpx;
        margin-left: 10rpx ;
      }
    }
  }
</style>

效果:

图片.png

2.3 解决一个小bug

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

图片.png

各个高度如下

图片.png

23.gif

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

图片.png成功解决

三、封装自定义组件属性和click事件

3.1 自定义属性

通过自定义属性增强组件的通用性(自定义背景颜色,圆角程度)

  • props节点定义数据(类似在原生小程序中的properties属性,
  • props是父组件与组件之间的通信,而data则是组件的私有数据,无法直接传参
  • 默认值为default属性
  props: {
      // 背景颜色
      bgcolor: {
        type: String,
        default: '#ff1e0a'
      },
      // 圆角尺寸
      radius: {
        type: Number,
        default: 100
      }
    },
  • 在组件中动态绑定style,输入键值对
 <!-- 搜索框容器 -->
    <view class="search-container" :style="{'background-color': bgcolor}">
      <!-- 搜索框内部盒子 -->
      <view class="search-box" :style="{'broder-radius': radius + 'rpx'}">
  • 那么在使用该组件时,我们可以对其传参,设置背景颜色和圆角度,如
    注意:在组件传参中,参数由双引号包裹起来·"" 如果参数字符串,那么字符串形式应该为 '字符串',不然报错会难以查找
 <!-- 自定义搜索组件 -->
  <my-search v-bind:bgcolor="'pink'" v-bind:radius="10"></my-search>

效果:

图片.png

3.2 click 事件绑定

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

  • 我们绑定一个事件处理函数,并在事件触发后打印ok:
<my-search v-on:click="gotosearch"></my-search>
// 搜索框click事件
      gotosearch: () => {
        console.log('ok')
      },

可以看到毫无效果:图片.png

  • 原因:

当前为自定义组件绑定了 click事件处理函数,但是自定义组件本身并没有提供click事件,所以绑定无效,

那么为什么在常规组件中 ,如 view 可以呢,这是因为官方已经为这些常规组件封装好了 click事件,所以可以直接绑,而自定义组件并没有封装,所以即使绑定了也无法实现

  • 解决

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

图片.png

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

<!-- 搜索框容器 -->
    <view class="search-container" :style="{'background-color': bgcolor}" v-on:click="searchBoxHander">
      ······
   </view>
 // 搜索框click事件
      searchBoxHander() {
        console.log('~~~~~')
        this.$emit('click')
      },

四、导航跳转和吸顶效果

4.1 导航跳转

  • 创建搜索(search) 页面(在分包中创建)
    图片.png
  • 在组件绑定函数gotosearch 跳转到编程时跳转页面
    // 搜索框click事件
      gotosearch(){
        uni.navigateTo({
          url: '/subpackages/search/search'
        })
      },

效果:

24.gif

4.2 吸顶效果

  • 吸顶效果:保持顶部,不随滑动消失而消失

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

首页配置

  • UI结构
<!-- 自定义组件 -->
    <view class="search-box">
      <my-search v-on:"gotosearch"></my-search>
    </view>
  • 跳转页面时间处理函数
 // 跳转到自定义导航页面
      gotosearch(){
        uni.navigateTo({
          url:'/subpackages/search/search'
        })
  • 通过样式实现吸顶效果(重要)
 .search-box {
    position: sticky; // sticky 粘性的
    // 保持顶部
    top: 0;
    // 提高层级,避免被轮播图覆盖
    z-index: 999;
  }

效果:

25.gif

个人总结(选读*)

一下只是个人的学习总结拙见,写得不好还请海涵。

由于我是半路出家,只学了一点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调用父组件调用函数

图片.png

图片.png

✨谢谢你的阅读,您的点赞和收藏就是我创造的最大动力!✨


相关文章
|
1月前
|
JSON 小程序 JavaScript
uni-app开发微信小程序的报错[渲染层错误]排查及解决
uni-app开发微信小程序的报错[渲染层错误]排查及解决
485 7
|
1月前
|
小程序 JavaScript 前端开发
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
538 1
|
1月前
|
API UED 容器
深入探索 Element UI:自定义滚动条与弹出层管理的技巧
在这篇博客中,我们将深入探讨 Element UI 中的自定义滚动条及弹出层管理技巧。文章详细介绍了 el-scrollbar 组件的使用和参数设置,以及 PopupManager 如何有效管理弹出层的 z-index。我们还将探讨如何实现灵活的全屏组件,利用 vue-popper 创建自定义弹出层,最后介绍 ClickOutside 指令的用法。这些高级技巧将帮助你提升 Element UI 应用程序的用户体验与交互灵活性。
185 1
深入探索 Element UI:自定义滚动条与弹出层管理的技巧
|
1月前
|
移动开发 小程序 测试技术
自定义多级联动选择器指南(uni-app)
在本文中,探讨了如何在uni-app中创建自定义多级联动选择器组件。这个组件具有强大的多端支持,可适用于H5、APP、微信小程序、支付宝小程序等多种平台。
33 1
自定义多级联动选择器指南(uni-app)
|
1月前
|
JavaScript 前端开发 UED
Vue与uni-app开发中通过@font-face巧妙引入自定义字体
Vue与uni-app开发中通过@font-face巧妙引入自定义字体
71 9
|
1月前
|
缓存 小程序 索引
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
191 1
|
1月前
|
小程序 JavaScript API
微信小程序开发之:保存图片到手机,使用uni-app 开发小程序;还有微信原生保存图片到手机
这篇文章介绍了如何在uni-app和微信小程序中实现将图片保存到用户手机相册的功能。
544 0
微信小程序开发之:保存图片到手机,使用uni-app 开发小程序;还有微信原生保存图片到手机
|
1月前
|
JavaScript 小程序 开发者
uni-app开发实战:利用Vue混入(mixin)实现微信小程序全局分享功能,一键发送给朋友、分享到朋友圈、复制链接
uni-app开发实战:利用Vue混入(mixin)实现微信小程序全局分享功能,一键发送给朋友、分享到朋友圈、复制链接
322 0
|
1月前
|
小程序
uni-app开发微信小程序使用onPullDownRefresh(下拉刷新)总结
uni-app开发微信小程序使用onPullDownRefresh(下拉刷新)总结
489 0
|
1月前
|
缓存 开发框架 移动开发
uni-app:下载使用uni&创建项目&和小程序链接&数据缓存&小程序打包 (一)
uni-app 是一个跨平台的开发框架,它允许开发者使用 Vue.js 来构建应用程序,并能够同时发布到多个平台,如微信小程序、支付宝小程序、H5、App(通过DCloud的打包服务)等。uni-app 的目标是通过统一的代码库,简化多平台开发过程,提高开发效率。 在这一部分中,我们将逐步介绍如何下载和使用uni-app、创建一个新的项目、如何将项目链接到小程序,以及实现数据缓存的基本方法。