Appearance
Search 搜索框
搜索组件,集成了常见搜索框所需功能,用户可以一键引入,开箱即用。
基本使用
html
<u-search placeholder="请输入关键字" v-model="keyword"></u-search>Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| shape | 搜索框形状,round-圆形,square-方形 | String | round |
| bgColor | 搜索框背景颜色 | String | #f2f2f2 |
| placeholder | 占位文字内容 | String | 请输入关键字 |
| clearabled | 是否启用清除控件 | Boolean | true |
| focus | 是否自动获得焦点 | Boolean | false |
| showAction | 是否显示右侧控件 | Boolean | true |
| actionText | 右侧控件文字 | String | 搜索 |
| actionStyle | 右侧控件的样式,对象形式 | Object | - |
| inputAlign | 输入框内容水平对齐方式 | String | left |
| disabled | 是否启用输入框 | Boolean | false |
| borderColor | 边框颜色,配置了颜色,才会有边框 | String | transparent |
| searchIconColor | 搜索图标的颜色 | String | #909399 |
| searchIconSize | 搜索图标的字体大小 | Number | String | 22 |
| color | 输入框字体颜色 | String | #606266 |
| placeholderColor | placeholder 的颜色 | String | #909399 |
| searchIcon | 输入框左边的图标 | String | search |
| margin | 组件与其他上下左右元素之间的距离 | String | 0 |
| animation | 是否开启动画 | Boolean | false |
| value | 输入框初始值 | String | - |
| maxlength | 输入框最大能输入的长度,-1 为不限制 | String | Number | -1 |
| height | 输入框高度,单位 px | String | Number | 64 |
| label | 搜索框左边显示内容 | String | Number | - |
| customStyle | 定义需要用到的外部样式 | Object | - |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 输入框内容发生变化时触发 | value |
| search | 用户确定搜索时触发(回车或点击键盘搜索键) | value |
| custom | 用户点击右侧控件时触发 | value |
| clear | 用户点击清除按钮时触发 | - |
| focus | 获得焦点时触发 | value |
| blur | 失去焦点时触发 | value |
| click | 点击搜索框时触发(仅 disabled=true 时) | - |
| clickIcon | 点击左边图标时触发 | - |
Slots
| 名称 | 说明 |
|---|---|
| left-cion | 左侧图标插槽 |
| label | 左侧 label 插槽 |