searchBar

来自于:官方立即使用

概述

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 对象

内部字段:

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

示例代码

var searchBar = api.require('searchBar');
searchBar.open(function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

补充说明

打开搜索视图页面

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setText

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

setText({params})

params

text:

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

示例代码

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

补充说明

设置搜索文本

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭页面

close()

示例代码

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

补充说明

关闭搜索视图

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cleanHistory

清空历史记录

cleanHistory()

示例代码

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

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本