# 搜索栏 searchBar
# 描述
用于展现搜索栏,提醒用户输入相关内容进行搜索。
# 使用效果
# 使用方法
在 .ux
文件中引入组件
<import name="my-search-bar" src="apex-ui/components/search-bar/index"></import>
1
# 示例
<template>
<div class="wrap">
<text class="title">Normal</text>
<my-search-bar></my-search-bar>
<text class="title">Focus</text>
<my-search-bar input-focus="{{true}}"></my-search-bar>
<text class="title">Show cancel button</text>
<my-search-bar has-cancel="{{true}}"></my-search-bar>
</div>
</template>
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
.wrap {
flex-direction: column;
background-color: #f8f8f8;
.title {
padding: 30px;
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
export default {
}
1
2
3
2
3
# API
# 组件属性
属性 | 类型 | 默认值 | 说明 |
---|---|---|---|
has-cancel | Boolean | false | 是否一直显示取消按钮 |
placeholder-color | String | 'rgb(128,128,128) | 占位符文字颜色 |
placeholder | String | '搜索' | 占位符文字 |
maxlength | Number | - | 最大输入长度,默认不限制 |
pix-class | String | 'wrap' | 根节点样式类 |
disabled | Boolean | false | 是否禁用 |
cancelText | String | - | 自定义取消按钮的文字 |
input-focus | Boolean | false | 获取焦点 |
input-value | String | '' | 输入框的默认值 |
clear | Boolean | true | 是否显示清除图标 |
select | Boolean | false | 选中文本框的全部文本 |
selection-start | Number | - | 光标起始位置,自动聚集时有效,需与selection-end搭配使用 |
selection-end | Number | - | 光标结束位置,自动聚集时有效,需与selection-start搭配使用 |
enterkeytype | String | 'default' | 设置软键盘 Enter 按钮的显示文本,可选值: default | send | search | next | go | done |
# 组件事件
事件名称 | 事件描述 | 返回值 |
---|---|---|
change | 值发生变化时触发事件 | event |
focus | 获得焦点触发事件 | event |
blur | 失去焦点触发事件 | event |
cancel | 点击取消按钮触发事件 | event |
clear | 点击清除按钮触发事件 | event |
enterKeyClick | 软键盘 Enter 键点击事件 | event |
selectionchange | 选中文本改变和光标移动时触发 | event |