sortList

close show addSource

概述

sortList简介

sortList模块是一个字母检索器,根据传入的数据源来展示检索器的字母。

open

打开索引列表

open({params}, callback(ret))

params

rect：

• 类型：JSON 对象
• 默认值：见内部字段
• 描述：索引器的frame

内部字段：

height：

• 类型：数字类型
• 描述：每个字母显示的高度（仅iOS支持）
• 默认值:15

bgColor：

• 类型：字符串类型
• 描述：索引器背景颜色
• 默认:透明

dataArray：

• 类型：数组类型
• 默认值：无
• 描述：数据源,名单列表

内部字段：

 '小明',
 '小红'
]

style：

• 默认值：见内部字段

内部字段：

{
    textColor:‘’  ,   //字符串类型;字体颜色; 默认:#000000
    font:0    , //数字类型;字体大小; 默认:10
    selectColor:'', //字符串类型; 选中时字体颜色; 默认;无
    highLightColor:'' //字符串类型; 点击时字体颜色 ; 默认;无（仅iOS支持）
}

fixedOn：

• 类型：字符串类型
• 描述：（可选项）模块视图添加到指定 frame 的名字（只指 frame，传 window 无效）（仅android支持）

fixed:

• 类型：布尔类型
• 描述：（可选项）是否将模块视图固定到窗口上，不跟随窗口上下滚动（仅android支持）
• 默认：false

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    index:1,   //数字类型；
    letter:'h', //字符串类型;
}

示例代码

var demo = api.require('sortList');
demo.open({
     rect:{
          x:100,
          y:100,
          w:20,
     },
     height:20,
     dataArray:['小明','小红']
}, function(ret){
    alert(JSON.stringify(ret));

可用性

iOS系统，Android系统

close

关闭索引列表

close(callback(ret))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:,   //布尔类型
}

示例代码

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏索引列表

hide({callback(ret))

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:,   //布尔类型
}

示例代码

var demo = api.require('sortList');
demo.hide(function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

show

显示索引列表

show(callback(ret))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:,   //布尔类型
}

示例代码

demo.show(function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

upLoad

更新索引列表

upLoad({params}, callback(ret))

params

• 类型：数组类型
• 默认值：无
• 描述：数据源,名单列表

内部字段：

[
 '小明',
 '小红'
]

callback(ret, err)（进iOS支持）

ret：

• 类型：JSON 对象
• 内部字段：

var demo = api.require('sortList');
demo. upLoad({
     dataArray:['小明','小红']
}, function(ret){
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addSource

添加数据

addSource({params}, callback(ret))

params

dataArray：

• 类型：数组类型
• 默认值：无
• 描述：数据源,名单列表

内部字段：

[
 '小明',
 '小红'
]

callback(ret, err)（仅iOS支持）

ret：

• 类型：JSON 对象
• 内部字段：

{
    index:1,   //数字类型；
    letter:'h', //字符串类型;
}

示例代码

var demo = api.require('sortList');
demo.addSource({
     dataArray:['小明','小红']
}, function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

reduceSource

删除数据（仅iOS支持）

reduceSource({params}, callback(ret))

params

dataArray：

• 类型：数组类型
• 默认值：无
• 描述：数据源,名单列表

内部字段：

[
 '小明',
 '小红'
]

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

var demo = api.require('sortList');
demo.reduceSource({
     dataArray:['小明','小红']
}, function(ret){
});

可用性

iOS系统