items

cola.EntityList || [any]

cola.Table

表格数据

此属性不要与bind属性同时使用。

bind

string

cola.Table

绑定表达式。

此属性不要与items属性同时使用。

columns

JSON

cola.Table

表格中的列的声明

此属性在设置时我们通常会使用JSON数组来定义表格列，这样更加方便。而在读取时你得到的总是cola.TableColumn的数组。

dataType

boolean

cola.Table

数据类型

表格对应的数据类型很多时候可以根据绑定的数据源来自定决定，但某些时候我们可能也会需要自行定义。
定义dataType对于表格而言并不是必须的，定义dataType可以是表格具有自动创建表格列的功能，同时也可以为手工定义的表格列自动绑定相应的数据类型。

showHeader

boolean

truecola.Table

是否显示表格标题栏

showFooter

boolean

cola.Table

是否显示表格汇总栏

columnStrecthable

boolean

truecola.Table

是否自动调整各表格列的宽度

selectedProperty

boolean

cola.Table

当需要启动表格的多选功能时以数据对象的哪个属性来保存数据的多选状态。

要使用表格的多选，通常需要在表格中添加一个选择列。

allowNoCurrent

boolean

truecola.ItemsView

是否允许集合型控件没有当前列表元素。

currentItem

cola.Entity || any

cola.ItemsView

当前列表元素所对应的列表数据项。

highlightCurrentItem

boolean

cola.ItemsView

是否高亮显示当前的列表元素。

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

getItems()获得items列表cola.ItemsView

Returns:void

refreshItem(item)刷新指定item对应的Domcola.ItemsView

Parameters:

itemcola.Entity

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

renderRow当表格渲染某一行时触发的事件。cola.Table

Parameters:

selfObject
表格本身
argObject
- item:cola.Entity || any
- dom:HTMLElement

Returns: