# 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 步进器 →