更新记录

1.0.0(2024-12-07) 下载此版本

  • 首次发布
  • 支持基础搜索功能
  • 支持自定义搜索按钮样式
  • 支持左侧图标自定义
  • 支持清除按钮
  • 支持多端兼容
  • 提供丰富的事件回调
  • 支持样式完全自定义

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue app-nvue
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

wht-search 轻量级搜索框组件

一个优雅、轻量、可定制的搜索框组件,支持多端兼容。

平台兼容性

  • App-vue: 支持
  • App-nvue: 支持
  • H5: 支持
  • 微信小程序: 支持
  • 支付宝小程序: 支持
  • QQ小程序: 支持

安装方式

插件依赖

本组件依赖 uni-icons 图标组件,请确保项目中已安装该组件:

  1. 在插件市场打开uni-icons,点击安装
  2. 或者在HBuilderX中点击菜单【工具】->【插件安装】,搜索 uni-icons 安装

组件安装

通过uni_modules安装,在插件市场打开,点击安装即可。

基础用法

<template>
    <wht-search v-model="searchText" @search="onSearch" />
</template>
<script>
export default {
    data() {
        return {
            searchText: ''
        }
    },
    methods: {
        onSearch(value) {
            console.log('搜索:', value)
        }
    }
}
</script>

API

Props 属性

属性名 类型 默认值 说明
v-model String '' 搜索框的值
placeholder String '请输入搜索关键词' 占位提示文字
autoFocus Boolean false 是否自动聚焦
showClear Boolean true 是否显示清除按钮
showSearchBtn Boolean true 是否显示搜索按钮
searchText String '搜索' 搜索按钮文字

Events 事件

事件名 说明 回调参数
@search 点击搜索按钮时触发 value: 搜索框的值
@clear 点击清除按钮时触发 -
@focus 输入框聚焦时触发 event: Event
@blur 输入框失焦时触发 event: Event
@confirm 点击完成按钮时触发 value: 搜索框的值

Slots 插槽

名称 说明
left 自定义左侧内容
search-btn 自定义搜索按钮

样式定制

组件提供了丰富的样式定制属性:

<template>
  <wht-search
    v-model="searchText"
    :content-style="{ 
      background: '#f0f2f5',
      borderRadius: '100rpx'
    }"
    :search-btn-style="{
      background: '#2979ff',
      borderRadius: '100rpx'
    }"
  />
</template>

更多使用示例请参考demo。

隐私、权限声明

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

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

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

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问