title

String

cola.TitleBar

标题

items

Array

cola.Menu

此Items将在Menu的从左到右排列。
此属性内容可通过以下方式定义。

new cola.Menu(
{
  items: [
    {
        caption: "腾讯微博", icon: "qq"
    },
    {
        caption: "微信", icon: "weixin"
    },
    {
        $type: "Input",icon:"sreach" //ControlItem的定义
    },
    {
        caption: "其他…", $type: "dropdown",  //DropDownItem的定义
        items: [
            {
                caption: "新浪微博", icon: "sina"
            },
            {
                caption: "人人网", icon: "renren"
            },
            {
                caption: "facebook", icon: "facebook"
            }
        ]
    }
  ]
}
)

rightItems

Array

cola.Menu

此rightItems全部在菜单的右侧显示。
定义格式可参考Items属性

centered

boolean

falsecola.Menu

通过此属性可获得Semantic Menu Container效果。

float

string

cola.Widget

left

right

浮动:通过属性将根据所设定的值在容器中浮动显示

display

boolean

truecola.Widget

是否显示

ui

string

truecola.Widget

用户可自定样式之后通过此属性激活自定义样式，或者启用框架提供的样式

popup

String

cola.Widget

弹出信息内容，当鼠悬停时显示此内容

dimmer

String

cola.Widget

调光器内容

width

number|string

cola.Widget

宽度(如果传入的值为number将计量单位为px)

height

number|string

cola.Widget

高度(如果传入的值为number将计量单位为px)

tag

string[]

cola.Element

对象拥有的标签

每一个Element的实例都可以拥有1到N的标签，每个标签是一个String类型的值。通过标签，我们可以快速的获取一批Element的实例，以便于对他们进行统一的操作。参考：cola.tag()

另外，在设置tag时如果只需要设置一个tag，我们可以直接使用简单的字符串，Cola-UI会自动将其转换成字符串的数组。例如： element.set("tag", "invisible");

userData

any

cola.Element

自定义数据。这里的自定义数据可以是任意数据类型，Cola-UI不会对其内容做任何处理。

addItem(config)添加Itemcola.Menu

Parameters:

configobject||HTMLElement

Returns:void

参考例子代码如下:

menu.addItem({
  $type:"Button",
  caption:"按钮"
})
groupWidget.addItem({
  caption:"首页",
  icon:"home"
})

clearItems()清空Itemscola.Menu

Returns:void

removeItem(item)移除指定Itemcola.Menu

Parameters:

itemnumber||cola.MenuItem
item本身或者序号

Returns:void

addRightItem(config)添加右侧Itemcola.Menu

Parameters:

configobject||cola.MenuItem

Returns:void

参考例子代码如下:

menu.addRightItem({
  $type:"Button",
  caption:"按钮"
})
menu.addRightItem({
  caption:"首页",
  icon:"home"
})

clearRightItems()清空右侧Itemscola.Menu

Returns:void

removeRightItem(item)移除右侧指定Itemcola.Menu

Parameters:

itemnumber||cola.MenuItem
item本身或者序号

Returns:void

showDimmer(options)显示调光器cola.Widget

Parameters:

optionsobject

Returns:void


var widget=new cola.Widget();
widget.showDimmer({content:"中间内容"})
widget.showDimmer({
  tagName:"div",
  content:{
    tagName:"div",
    content:"中间内容"
  }
})

hideDimmer()关闭调光器cola.Widget

Returns:void

refresh()刷新控件cola.RenderableElement

Returns:void

appendTo(dom)追加到指定的dom中cola.RenderableElement

Parameters:

domHTMLElement | jQuery | zepto

Returns:void

getDom()cola.RenderableElement

Returns:void

get$Dom()获得此组件Dom的jQuery或zepto实例cola.RenderableElement

Returns:jQeury|zepto

remove()从dom树上移除此组件cola.RenderableElement

Returns:void

destroy()销毁此组件cola.RenderableElement

Returns:void

get(key)根据属性名或路径获取一个Attribute的值cola.Element

Parameters:

keystring
Attribute名或路径

Returns:any

注意设置或读取Attribute时，我们不但可以直接使用属性名也可以利用路径对属性值记性钻取式的读写。
请参考： Element

set(key,value)根据属性名或路径设置一个Attribute的值cola.Element

Parameters:

keystring
Attribute名或路径
valueany
要写入的值

Returns:cola.Element

注意设置或读取Attribute时，我们不但可以直接使用属性名也可以利用路径对属性值记性钻取式的读写。
请参考： Element

on(eventName,listener)绑定一个事件监听器cola.Element

Parameters:

eventNamestring
在定义此处的事件名时，我们可以通过":"分割的方式在事件名后面定义本事件监听器的别名。
listenerFunction
事件监听器

Returns:cola.Element

one(eventName,listener)绑定一个一次性事件监听器cola.Element

Parameters:

eventNamestring
事件名
listenerFunction
事件监听器

Returns:cola.Element

一次性事件监听器表示只要事件触发过一次，该事件监听器就会自动解除绑定。即这样的时间监听器只会触发一次。

off(eventName,listener)解绑一个事件监听器cola.Element

Parameters:

eventNamestring
事件名
listenerFunction
事件监听器

Returns:cola.Element

itemClickcola.Menu

Parameters:

selfObject
事件的发起者,即组件本身
argObject
- undefined:cola.MenuItem
  被单击的菜单项
- undefined:Event
  window.event 对象

当菜单某一个Item被单击时触发此事件

Returns: