更新记录

1.0.0(2025-08-15) 下载此版本

first commit


平台兼容性

uni-app x(4.66)

Chrome Safari Android iOS 鸿蒙 微信小程序

xudy-search-bar

一个基于UniApp的搜索框组件,具有搜索图标、输入框和清除按钮。

功能特性

  • 放大镜搜索图标
  • 可输入的搜索框
  • 清除按钮
  • 支持多种事件回调

属性 (Props)

属性名 类型 默认值 说明
v-model String '' 搜索框的值
focus Boolean false 是否自动聚焦

事件 (Events)

事件名 说明 回调参数
confirm 点击搜索按钮或回车确认搜索时触发 event: Event对象
blur 输入框失去焦点时触发 event: Event对象
focus 输入框获得焦点时触发 event: Event对象
input 输入框内容变化时触发 event: Event对象
cancel 点击取消按钮时触发 value: 当前输入框的值
clear 点击清除按钮时触发 value: 当前输入框的值

方法 (Methods)

方法名 说明 参数
cancel() 触发取消事件 -
clear() 清除输入框内容并触发清除事件 -

使用示例

<template>
  <view>
    <xudy-search-bar 
      v-model="searchValue" 
      :focus="true"
      @confirm="handleSearch"
      @blur="handleBlur"
      @focus="handleFocus"
      @input="handleInput"
      @cancel="handleCancel"
      @clear="handleClear"
    />
  </view>
</template>

<script setup>

const searchValue = ref('')

const handleSearch = (event) => {
  console.log('搜索内容:', searchValue.value)
}

const handleBlur = (event) => {
  console.log('失去焦点')
}

const handleFocus = (event) => {
  console.log('获得焦点')
}

const handleInput = (event) => {
  console.log('输入内容变化')
}

const handleCancel = (value) => {
  console.log('取消搜索')
}

const handleClear = (value) => {
  console.log('清除内容')
}
</script>

组件结构

组件由三部分组成:

  1. 左侧搜索图标 (使用uni-icons组件)
  2. 中间输入框
  3. 右侧清除按钮 (当有输入内容时显示)

样式说明

组件使用了简单的flex布局,具有默认的边框和圆角样式,可以根据需要通过外部CSS类进行自定义。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。