首页 教程 API文档

追加组合框下拉项

2015-10-28 15:17:28

属性


使用频率
所属UI模块 ComboBox
成员类型 公有成员函数

描述


append方法用于追加ComboBox下拉项,当传递的值是一个字符串的时候,append方法会创建一个ComboBoxItem实例,将该字符串作为text参数.

当传递的参数是一个Object对象并且这个对象是一个widget实例的时候,该widget实例将会作为下拉项被添加.

如果传递的参数是一个Object对象,并且ComboBox指定了template选项,那么TemplateItem将会被创建,传递的数据将会作为模板的渲染数据,否则 将会创建一个ComboBoxItem,传递的参数将会作为ComboBoxItem的参数选项.

同时,传递的参数可以是一个数组,表示需要追加多个子项.

语法



Object append(String text);
Object append(Object data);
Object append(Array items);
        

参数


名称 类型 描述
text String 文本字符串
data Object widget,参数选项,或者要渲染模板的数据
items Array 包含多个数据的数组

返回值


this对象

相关例子



var comboBox = Std.ui("ComboBox",{
    renderTo:"body"
});
comboBox.append([
    "aaaa",
    {
        text:"bbbbb",
    },
    "bbbbbb",
    {
        icon:"images/play.png",
        text:"icon item 2"
    }
]);