更新记录

1.0.0(2025-02-28) 下载此版本

发布初版


平台兼容性

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

Search 搜索框

组件名: xt-search

安装方式

本组件符合 easycom 规范,HBuilderX 3.1.0 起,只需将本组件导入项目,在页面 template 中即可直接使用,无需在页面中 import 和注册 components

基本用法

<template>
    <view class="xt">
        <view>
            <view>基本使用</view>
            <xt-search v-model="searchValue" placeholder="请输入"></xt-search>
        </view>
        <view>
            <view>圆角模式</view>
            <xt-search v-model="searchValue" placeholder="请输入" round></xt-search>
        </view>
        <view>
            <view>左边插槽</view>
            <xt-search v-model="searchValue" placeholder="请输入">
                <template #left>
                    <xt-icon></xt-icon>
                </template>
            </xt-search>
        </view>
        <view>
            <view>右边插槽</view>
            <xt-search v-model="searchValue" placeholder="请输入" round>
                <template #right>
                    <xt-icon></xt-icon>
                </template>
            </xt-search>
        </view>
        <view>
            <view>自定义搜索图标</view>
            <xt-search v-model="searchValue" placeholder="请输入">
                <template #icon>
                    <xt-icon name="xt-icon-saoyisao"></xt-icon>
                </template>
            </xt-search>
        </view>
        <view>
            <view>一键清空</view>
            <xt-search value="一键清空" placeholder="请输入" clearable></xt-search>
        </view>
        <view>
            <view>伸缩模式(点击搜索图标可展开和收缩)</view>
            <xt-search v-model="searchValue" placeholder="请输入" round elastic></xt-search>
            <xt-search v-model="searchValue" placeholder="请输入" elastic></xt-search>
        </view>
        <view>
            <view>自定义颜色</view>
            <xt-search placeholder="边框颜色" borderColor="red"></xt-search>
            <xt-search placeholder="背景颜色" bgColor="#ccc"></xt-search>
        </view>
    </view>
</template>
<script>
    export default {
        data() {
            return {
                searchValue: ''
            }
        },
        methods: {
        }
    }
</script>
<style scoped>
    .xt {
        padding: 20rpx;
        display: flex;
        flex-direction: column;
        gap: 20rpx;
    }
</style>

API

属性名 类型 说明 默认值
value String 绑定的值 -
fontAlign String 输入框内容对齐方式 left
fontSize String 输入框字体的大小 30rpx
height String|Number 组件高度 66rpx
color String 输入框字体颜色 #303133
borderColor String 边框颜色 #E6E6E6
bgColor String 背景颜色 -
inputStyle Object 输入框自定义样式 -
round Boolean 是否为圆角类型的输入框 false
elastic Boolean 是否开启缩放模式 false
placeholder String 输入框为空时的占位符文本 -
placeholderStyle String|Object 占位符样式,可以是字符串或对象
disabled Boolean 是否禁用 false
clearable Boolean 是否可清空 false
maxlength Number 输入框的最大输入长度,-1不限制 140
focus Boolean 是否获取焦点 false
confirmType String 键盘右下角按钮的文字 search
confirmHold Boolean 点击键盘右下角按钮时是否保持键盘不收起 false
cursorColor String 设置光标的颜色 -
adjustPosition Boolean 键盘弹起时是否自动上推页面 true
autoBlur Boolean 键盘收起时是否自动失去焦点 false
alwaysEmbed Boolean 是否强制输入框保持在同一层级,仅在 iOS 下生效 false
holdKeyboard Boolean 是否在 focus 时,点击页面时不收起键盘 false

Event

事件名 类型 说明
click Function 点击事件,在禁用的时候点击处理逻辑
input Function 输入框输入事件
leftIcon Function 图标点击事件
focus Function 输入框聚焦事件
blur Function 输入框失去焦点事件
confirm Function 按下回车按钮时触发
clear Function 输入框清空时触发

隐私、权限声明

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

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

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

许可协议

MIT协议

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