首页 教程 API文档

组合框组件

2015-10-23 17:06:18

属性


父模块 widget
依赖组件 ComboBoxItem, TemplateItem
Demo地址 ComboBox

描述


组合框组件

组合框组件图片

成员列表


方法名称 成员类型 描述
textField public 组合框文本字段
valueField public 组合框value字段
valueMode public 组合框值的类型
text public 组合框文本值
select public 选择下拉项
template public 组合框下拉项模板
value public 组合框value值
inputMode public 组合框输入模式
open public 打开组合框下拉列表
close public 关闭组合框下拉列表
insert public 插入组合框下拉项
append public 追加组合框下拉项
clear public 清空组合框

参数选项


名称 类型 默认值 描述
level Number 3 组合框组件在layout中的布局等级
defaultClass String StdUI_ComboBox 组合框组件的默认class名称
minWidth Number 40 组合框组件的最小宽度
minHeight Number 26 组合框组件的最小高度
maxHeight Number 26 组合框组件的最大高度
listMaxHeight Number 300 下拉列表的最大高度
height Number 26 默认高度
items Array null 组合框的默认列表项
value Any null 默认value值
template Object,String null 列表项的模板,模板的名称或者模板的实例对象
inputMode String none 组合框的输入模式,取值范围有,none,input,当inputMode值为input时候,组合框可以接受文字的输入
valueMode String text

组合框value的取值模式,取值范围有text,index,item

当为text的时候,value值就为组合框的编辑框文本,当为index的时候value值就为组合框下拉列表已经选中的索引号. 当为item的时候value的取值就为下拉项的widget

事件


名称 回调参数 描述
open 当组合框的下拉列表打开时候,open事件会被触发
close 当组合框的下拉列表关闭时候,close事件会被触发
select 选中的ComboBoxItem项的实例对象 当组合框的下拉列表中的某项被选中的时候,select事件会被触发
change 选中的ComboBoxItem项的实例对象 当组合框中的下拉项被改变时候,或者组合框编辑的文字被改变的时候,change事件会被触发
focus 事件对象 当ComboBox拥有焦点的时候,focus事件会被触发
blur 事件对象 当ComboBox失去焦点的时候,blur事件会被触发

相关例子



Std.ui("ComboBox",{
    renderTo:"body",
    inputMode:"input",
    valueMode:"index",
    value:1,
    items:[
        "aaaa",
        {
            text:"bbbbb",
        },
        "bbbbbb",
        {
            icon:"images/play.png",
            text:"icon item 2"
        }
    ],
    on:{
        select:function(){
            console.log(this.value())
        }
    }
});