searchBar

来自于:官方

open setText close cleanHistory

概述

searchBar 定义了一个搜索界面的模板,开发者可自定义该模板的样式。可将搜索记录归档到本地。UISearchBar 模块是 searchBar 模块的优化版,建议使用 UISearchBar 模块,此模块已停止更新。

图片说明

open

打开搜索界面

open({params}, callback(ret, err))

params

placeholder:

  • 类型:字符串
  • 默认值:请输入搜索关键字
  • 描述:(可选项)搜索提示文本

bgImg:

  • 类型:字符串
  • 默认值:默认背景图片
  • 描述:(可选项)搜索输入框背景图片

cancelColor:

  • 类型:字符串
  • 默认值: #D2691E
  • 描述:(可选项)取消按钮的颜色,支持 rgb,rgba,#

cancelSize:

  • 类型:数字
  • 默认值:16
  • 描述:(可选项)取消按钮大小

textColor:

  • 类型:字符串
  • 默认值:#000000
  • 描述:(可选项)搜索输入文本的字体颜色,支持 rgb,rgba,#

textFielWidth:

  • 类型:数字
  • 默认值:当前屏幕宽度减70
  • 描述:(可选项)搜索输入框宽度

textFieldHeight:

  • 类型:数字
  • 默认值:44
  • 描述:(可选项)搜索输入框的高度

placeholder:

  • 类型:字符串
  • 默认值:请输入搜索关键字
  • 描述:(可选项)搜索提示文本

recordCount:

  • 类型:数字
  • 默认值:10
  • 描述:(可选项)搜索历史记录条数

barBgColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:(可选项)导航条背景色,支持 rgb,rgba,#

listBgColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:(可选项)历史记录表背景色,支持 rgb,rgba,#

listColor:

  • 类型:字符串
  • 默认值:#696969
  • 描述:(可选项)搜索历史记录文本字体颜色,支持 rgb,rgba,#

listSize:

  • 类型:数字
  • 默认值:16
  • 描述:(可选项)搜索历史记录字体大小

cleanColor:

  • 类型:字符串
  • 默认值:#000000
  • 描述:(可选项)清除历史记录字体颜色,支持 rgb,rgba,#

cleanSize:

  • 类型:数字
  • 默认值:16
  • 描述:(可选项)清除历史记录字体大小

anim:

  • 类型:布尔
  • 默认值:true
  • 描述:(可选项)打开页面时是否有动画

showRecord:

  • 类型:布尔
  • 默认值:true
  • 描述:(可选项)是否显示录音按钮

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. isRecord: //是否是点击录音按钮的click事件
  3. text //搜索的文本
  4. }

示例代码

  1. var searchBar = api.require('searchBar');
  2. searchBar.open(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. } else {
  6. alert(JSON.stringify(err));
  7. }
  8. });

补充说明

打开搜索视图页面

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setText

设置搜索页面搜索框的文字

setText({params})

params

text:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)搜索框内的文字
  • 备注:若不传或传空则不显示

示例代码

  1. var searchBar = api.require('searchBar');
  2. searchBar.setText({
  3. text: '可以用来设置语音识别后的文本'
  4. });

补充说明

设置搜索文本

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭页面

close()

示例代码

  1. var searchBar = api.require('searchBar');
  2. searchBar.close();

补充说明

关闭搜索视图

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cleanHistory

清空历史记录

cleanHistory()

示例代码

  1. var searchBar = api.require('searchBar');
  2. searchBar.cleanHistory();

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本