首页 教程 API文档

列表组件

2015-10-15 10:05:25

属性


父模块 widget
依赖模型 ListItem
Demo地址 List

描述


List组件是一个列表组件,用于以行的形式或者以块的形式展示数据.

列表组件图片

成员列表


方法名称 成员类型 描述
type public 列表项类型
itemWidth public 列表项宽度
itemHeight public 列表项高度
editable public 列表项可编辑状态
each public 遍历列表项
template public 列表项模板
select public 选择指定列表项
insert public 插入列表项
append public 追加列表项
clearSelect public 清除已选择的列表项
clear public 清空列表项
remove extend 移除列表项或自身

参数选项


名称 类型 默认值 描述
defaultClass String StdUI_List 默认class名称
level Number 4 在layout中的等级
type String default

List排列类型,取值范围有

名称 描述
default 默认,垂直排列
block 水平块级排列
value Any null value值,无特殊用途
items Array null 默认列表项,对应append方法
editable Boolean false 列表项是否可被编辑的
template String,Object null 列表项默认模板,指定一个模板的名称,或者一个模板实例对象
itemHeight Number 24 列表项的高度
itemWidth Number 80 列表项的宽度,当type为block时,该选项会生效
iconWidth Number 16 列表项图标的默认宽度
iconHeight Number 16 列表项图标的默认高度
selectionMode String single

列表项的选择模式,取值范围有:

名称 描述
single 单选
multi 可按下ctrl键进行多选
none 不会选中

事件


名称 回调参数 描述
itemClick 鼠标事件对象 当列表项被点击时,itemClick事件会被触发
itemRename
名称 描述
item 列表项对象
oldText 列表项编辑之前的文本
text 列表项编辑之后的文本
当列表项被编辑重命名的时候,itemRename事件会被触发
select
名称 描述
index 当前列表项的索引号
selectedItem 被选中的列表项对象

相关例子



Std.ui("List",{
    renderTo:"body",
    iconHeight:16,
    iconWidth:16,
    itemHeight:50,
    editable:true,
    selectionMode:"single",
    items:[
        {
            iconClass:"abcIcon",
            text:"text11"
        },{
            icon:"images/play.png",
            text:"aaaaaaaaaa"
        },
        "aaaa",
        "ddsdfsdf",
        {
            ui:"Button",
            text:"aaaaa"
        }
    ],
    css:{
        marginBottom:5
    },
    value:"123"
});