Extends:cola.ItemsView

bind

cola.TreeNodeBind

cola.Tree

级联绑定声明对象

currentNode

cola.TreeNode

cola.Tree

当前树节点

currentItemAlias

string

cola.Tree

当前树节点使用的模型别名

此属性的含义有些晦涩。
假设我们有一课显示所有分类的树，同时界面上还有一个列表用于显示树中当前分类下的所有商品。
此时，你是无法为这个列表定义它的绑定表达式的，你只能通过树的`currentNodeChange`事件，将当前分类中的商品列表取出来设置给列表的items属性。
这听起来有点麻烦。
利用`currentItemAlias`属性，我们就有了另外一种解决问题的方案。假设我们定义`currentItemAlias`的值为`currentCategory`。
此时，树就会自动将当前节点会对应的数据设置到`Model`的`currentCategory`这个数据项中。
这意味着我们只要将列表的绑定表达式设置为`currentCategory.products`就可以实现上面功能了，不需要编写Javascript代码。

autoCollapse

boolean

cola.Tree

是否在展开某个树节点时自动收缩与其同层的其他树节点

autoExpand

boolean

cola.Tree

是否在用户点击某个树节点时自动展开该节点

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

findNode(entity)获得Entity对应的树节点cola.Tree

Parameters:

entitycola.Entity

Returns:void

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

getItemTemplate当列表控件尝试确定每一个列表项的模板时触发的事件。cola.ItemsView

Parameters:

selfObject
控件本身
argObject
- item:cola.Entity || any
  当前列表元素对应的列表项数据。

该事件的返回值即为要使用的模板的名称，如果此事件返回空则表示使用默认的名为“default”的模板。

Returns: