items

array

cola.MenuButton

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

new cola.MenuButton(
{
  items: [
    {
      $type: "Input",icon:"sreach" //ControlItem的定义
    },
    {
      caption: "腾讯微博", icon: "qq"
    },
    {
      caption: "微信", icon: "weixin"
    },

    {
      caption: "新浪微博", icon: "sina"
    },
    {
      caption: "人人网", icon: "renren"
    },
    {
      caption: "facebook", icon: "facebook"
    }
  ]
}
)

caption

string

cola.Button

标题

icon

string

cola.Button

图标

按钮的图标目前只支持矢量图标库ui库内部已经提供一套较全的icon库
不过此icon 库用户可以自行扩展。

iconPosition

string

leftcola.Button

图标位置

left

right

通过此属性可获得按钮或按钮组在溶剂内部所附所的效果。此属性只改变显示效果

focusable

boolean

falsecola.Button

是否可以获得焦点

states

String

cola.Button

状态

loading

active

""

size

string

mediumcola.AbstractButton

尺寸

mini

tiny

small

medium

large

big

huge

massive

color

string

cola.AbstractButton

颜色

black

yellow

green

blue

orange

purple

red

pink

teal

attached

String

cola.AbstractButton

附所模式

left

right

top

bottom

""

通过此属性可获得按钮或按钮组在溶剂内部所附所的效果。此属性只改变显示效果

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不会对其内容做任何处理。

addMenuItem(config)添加Itemcola.MenuButton

Parameters:

configobject||HTMLElement

Returns:void


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

clearMenuItems()清空Itemscola.MenuButton

Returns:void

removeMenuItem(item)移除指定Itemcola.MenuButton

Parameters:

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

Returns:void

getMenuItem(index)获得指定的MenuItemcola.MenuButton

Parameters:

indexnumber
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

menuItemClickcola.MenuButton

Parameters:

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

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

Returns: