更新记录
1.0.0(2025-02-28)
下载此版本
发布初版
平台兼容性
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 |
输入框清空时触发 |