# Search 搜索 
搜索组件,集成了常见搜索框所需功能,用户可以一键引入,自定义内容,开箱即用。
# 平台兼容性
App(vue) | App(nvue) | H5 | 小程序 | VUE2 | VUE3 |
---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ |
# 基本使用
- 通过
placeholder
参数设置占位内容 - 通过
v-model
双向绑定一个变量值,设置初始化时搜索框的值,如果初始内容为空,那么请绑定一个值为空字符的变量。
说明: 因为是双向绑定的,所以当组件内容输入框内容变化时,也会实时的反映到绑定的keyword
变量,这意味着,您无需监听change
事件,
也能实时的得知输入框的内容。
<template>
<uv-search placeholder="请输入搜索内容" v-model="keyword"></uv-search>
</template>
<script>
export default {
data() {
return {
keyword: '水调歌头'
}
}
}
</script>
# 设置输入框形状
通过shape
设置输入框两端的形状,square
-方形带圆角,round
(默认)-半圆形
<uv-search shape="round"></uv-search>
# 是否开启清除控件
clearabled
(默认为true
)设置为true
的话,输入框有内容时,右边会显示一个清除的图标
<uv-search :clearabled="true"></uv-search>
# 是否开启右边控件
该控件为类似按钮形式,可以设置为"搜索"或者"取消"等内容,如果开启动画效果,用户确认搜索后,该控件会自动消失
showAction
配置是否开启右边按钮控件actionText
配置控件内容animation
(默认为false
)设置为true
的话,失去焦点,或者点击控件按钮时,控件自动消失,并且带有动画效果
说明
- 如果不想点击右侧控件时自动消失,请把
animation
设置为false
- 右侧控件的默认文字为"搜索"(它本意为控件,碰巧内容为"搜索"二字,并非说它就是一个搜索按钮),点击它的时候触发的是
custom
事件,而不是search
事件
<uv-search :showAction="true" actionText="搜索" :animation="true"></uv-search>
# 自定义样式
- 通过
inputAlign
设置输入框内容的对其方式,和css的text-align
同理 - 通过
borderColor
设置整个搜索组件的边框,只要配置了颜色,才会出现边框 - 通过
height
设置组件高度 - 通过
disabled
设置是否禁用输入框 - 通过
bgColor
设置是搜索组件背景颜色
<uv-search inputAlign="center" height="70"></uv-search>
# 完整示例
# API
# Search Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
value / v-model | 双向绑定输入框搜索值 | String | - | - |
shape | 搜索框形状,round-圆形,square-方形 | String | round | round | square |
bgColor | 搜索框背景颜色 | String | #f2f2f2 | - |
placeholder | 占位文字内容 | String | 请输入关键字 | - |
clearabled | 是否启用清除控件 | Boolean | true | true | false |
focus | 是否自动获得焦点 | Boolean | false | true | false |
showAction | 是否显示右侧控件(右侧的"搜索"按钮) | Boolean | true | true | false |
actionStyle | 右侧控件的样式,对象形式 | Object | - | - |
actionText | 右侧控件文字 | String | 搜索 | - |
inputAlign | 输入框内容水平对齐方式 | String | left | center | right |
inputStyle | 自定义输入框样式,对象形式 | Object | - | - |
disabled | 是否启用输入框 | Boolean | false | true | false |
borderColor | 边框颜色,配置了颜色,才会有边框 | String | transparent | - |
searchIconColor | 搜索图标的颜色,默认同输入框字体颜色 | String | #909399 | - |
searchIconSize | 搜索图标的大小 | Number | 22 | - |
color | 输入框字体颜色 | String | #606266 | - |
placeholderColor | placeholder的颜色 | String | #909399 | - |
searchIcon | 输入框左边的图标,可以为uv-ui图标名称或图片路径 | String | search | - |
margin | 组件与其他上下左右元素之间的距离,带单位的字符串形式,如"30rpx"、"30rpx 20rpx"等写法 | String | 0 | - |
animation | 是否开启动画,见上方说明 | Boolean | false | true | false |
value | 输入框初始值 | String | - | - |
maxlength | 输入框最大能输入的长度,-1为不限制长度 | String | Number | -1 | - |
height | 输入框高度,单位rpx | String | Number | 64 | - |
label | 搜索左侧文本信息 | String | Number | - | - |
boxStyle1.0.6 | 自定义输入框部分的样式 | Object | - | - |
customStyle | 自定义外部样式 | Object | - | - |
# Search Events
您可以通过监听change
事件,在回调中将返回的结果绑定一个变量去获得用户的输入内容。
但如"基本使用"中的说明一样,您双向绑定了一个变量后,无需监听change
事件也是可以的。
事件名 | 说明 | 回调参数 |
---|---|---|
@change | 输入框内容发生变化时触发 | value:输入框的值 |
@search | 用户确定搜索时触发,用户按回车键,或者手机键盘右下角的"搜索"键时触发 | value:输入框的值 |
@custom | 用户点击右侧控件时触发 | value:输入框的值 |
@blur | 输入框失去焦点时触发 | value:输入框的值 |
@focus | 输入框获得焦点时触发 | value:输入框的值 |
@clear | 配置了clearabled 后,清空内容时会发出此事件 | - |
@click | disabled 为true 时,点击输入框,发出此事件,用于跳转搜索页 | - |
@clickIcon | 左侧icon点击时候时触发 | - |
# Search Slots
名称 | 说明 |
---|---|
prefix1.0.6 | 前置插槽,可替换输入框前面的图标等场景 |
suffix1.0.6 | 后置插槽,可在输入框后面增加按钮等场景 |
← Rate 评分 NumberBox 步进器 →