【小程序项目开发--京东商城】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

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


相关文章
|
小程序 搜索推荐 JavaScript
引入小程序平台对app有啥好处
引入小程序平台对app有啥好处
702 155
|
存储 开发者 容器
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例
本文介绍了ArkTS语言中的Class类、泛型、接口、模块化、自定义组件及状态管理等核心概念,并结合代码示例讲解了对象属性、构造方法、继承、静态成员、访问修饰符等内容,同时涵盖了路由管理、生命周期和Stage模型等应用开发关键知识点。
937 1
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例
|
小程序 安全 JavaScript
构建即时通讯APP内的小程序生态体系:从架构设计到技术实现-优雅草卓伊凡
构建即时通讯APP内的小程序生态体系:从架构设计到技术实现-优雅草卓伊凡
1465 1
构建即时通讯APP内的小程序生态体系:从架构设计到技术实现-优雅草卓伊凡
|
缓存 小程序 前端开发
商城/点餐/家政类小程序源码合集_微信抖音小程序源码开发从入门到精通实战
本文系统讲解如何利用现有源码快速开发商城、点餐、家政类微信/抖音小程序,涵盖环境搭建、核心功能实现、多平台部署与优化,提供完整技术方案。实战导向,助力开发者高效入门与落地。
|
存储 小程序 Java
热门小程序源码合集:微信抖音小程序源码支持PHP/Java/uni-app完整项目实践指南
小程序已成为企业获客与开发者创业的重要载体。本文详解PHP、Java、uni-app三大技术栈在电商、工具、服务类小程序中的源码应用,提供从开发到部署的全流程指南,并分享选型避坑与商业化落地策略,助力开发者高效构建稳定可扩展项目。
|
人工智能 小程序 前端开发
小程序、网站 vs. APP:成本差异究竟在哪里?技术栈如何决定项目上限?优雅草卓伊凡
小程序、网站 vs. APP:成本差异究竟在哪里?技术栈如何决定项目上限?优雅草卓伊凡
1065 0
小程序、网站 vs. APP:成本差异究竟在哪里?技术栈如何决定项目上限?优雅草卓伊凡
|
人工智能 监控 小程序
【快递鸟】选择对接你的物流商城/小程序的物流API平台
在电商竞争日益激烈的今天,物流体验已成为影响用户留存和复购的关键因素。一个高效、透明、稳定的物流系统,对于物流商城或小程序来说至关重要。然而,自建物流查询系统需要对接众多快递公司,开发周期长、维护成本高、数据整合困难。
717 0
|
消息中间件 缓存 小程序
婚恋交友相亲公众号app小程序系统源码「脱单神器」婚恋平台全套代码 - 支持快速二次开发
这是一套基于SpringBoot + Vue3开发的婚恋交友系统,支持微信公众号、Uniapp小程序和APP端。系统包含实名认证、智能匹配、视频相亲、会员体系等功能,适用于婚恋社交平台和相亲交友应用。后端采用SpringBoot 3.x与MyBatis-Plus,前端使用Vue3与Uniapp,支持快速部署和二次开发。适合技术团队或有经验的个人创业者使用。
1171 8
|
存储 人工智能 移动开发
uni-app+vue3接入deepseek-v3搭建跨端ai流式(小程序+app+h5)
基于Uniapp+Vue3+Markdown接入DeepSeek-V3聊天大模型,支持编译到H5+小程序+App端。实现流式输出、支持亮色/暗黑主题、代码高亮、会话本地存储等功能。
2591 12

热门文章

最新文章