$colacola.AbstractButtoncola.AbstractCheckboxcola.AbstractContainercola.AbstractDropdowncola.AbstractEditorcola.AbstractInputcola.AbstractItemGroupcola.AbstractListcola.AbstractMenuItemcola.AbstractSlotListcola.AjaxValidatorcola.AsyncValidatorcola.Avatarcola.Breadcrumbcola.Buttoncola.ButtonGroupcola.Calendarcola.CardBookcola.Carouselcola.CascadeBindcola.Checkboxcola.ControlMenuItemcola.Cornercola.CustomDropdowncola.CustomValidatorcola.DataTypecola.DatePickercola.DateTimePickercola.Dialogcola.Dividercola.Dropdowncola.DropdownMenuItemcola.Elementcola.EmailValidatorcola.Entitycola.EntityDataTypecola.EntityListcola.FieldSetcola.GroupBoxcola.HeaderMenuItemcola.IFramecola.Imagecola.Inputcola.ItemsViewcola.Labelcola.Layercola.LengthValidatorcola.Linkcola.ListViewcola.Menucola.MenuButtoncola.MenuItemcola.Modelcola.MultiSlotPickercola.NestedListcola.NestedListBindcola.NestedListNodecola.Nodecola.NumberValidatorcola.Panelcola.PointingLabelcola.Progresscola.Propertycola.Providercola.RadioButtoncola.RadioGroupcola.RangeSlotListcola.Ratingcola.RegExpValidatorcola.RenderableElementcola.RequiredValidatorcola.Revealcola.Ribboncola.Segmentcola.Selectcola.Sidebarcola.Slidercola.SlotListcola.SplitPanecola.Stackcola.Stepscola.Tabcola.TabButtoncola.Tablecola.TableColumncola.TableContentColumncola.TableDataColumncola.TableGroupColumncola.TableSelectColumncola.Tagcola.TimeLinecola.TitleBarcola.Togglecola.Treecola.TreeNodecola.TreeNodeBindcola.UrlValidatorcola.Validatorcola.Widgetcola.breadcrumb.Sectioncola.buttonGroup.Separatorcola.steps.Stepcola.tab.AbstractTabButtoncola.utilcola.util.KeyedArray

cola.Tree

用于实现级联式绑定的声明对象

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
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:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
renderItem当列表控件尝试渲染每一个列表项时触发的事件。cola.ItemsView
Parameters:
  • selfObject

    控件本身

  • argObject

    • item:cola.Entity || any

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

    • itemDom:HTMLElement

      当前列表元素,即当前列表项的DOM元素。

    • itemScope:cola.Scope

      当前列表元素对应的scope。

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
itemClick当用户点击某一个列表项时触发的事件。cola.ItemsView
Parameters:
  • selfObject

    控件本身

  • argObject

    • item:cola.Entity || any

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

    • itemDom:HTMLElement

      当前列表元素,即当前列表项的DOM元素。

    • event:Event

      原生DOM事件对应的Event对象。

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
itemDoubleClick当用户双击某一个列表项时触发的事件。cola.ItemsView
Parameters:
  • selfObject

    控件本身

  • argObject

    • item:cola.Entity || any

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

    • itemDom:HTMLElement

      当前列表元素,即当前列表项的DOM元素。

    • event:Event

      原生DOM事件对应的Event对象。

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
itemPress当用户长按某一个列表项时触发的事件。cola.ItemsView
Parameters:
  • selfObject

    控件本身

  • argObject

    • item:cola.Entity || any

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

    • itemDom:HTMLElement

      当前列表元素,即当前列表项的DOM元素。

    • event:Event

      原生DOM事件对应的Event对象。

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
click单击事件cola.Widget
Parameters:
  • selfObject

    组件本身

  • argObject

    • dom:HTMLElement

      组件本身

    • event:Event

      window.event 对象

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
dblclick双击事件cola.Widget
Parameters:
  • selfObject

    组件本身

  • argObject

    • dom:HTMLElement

      组件本身

    • event:Event

      window.event 对象

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
mousedown鼠标左键被按下cola.Widget
Parameters:
  • selfObject

    组件本身

  • argObject

    • dom:HTMLElement

      组件本身

    • event:Event

      window.event 对象

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
mouseup鼠标左键弹起cola.Widget
Parameters:
  • selfObject

    组件本身

  • argObject

    • dom:HTMLElement

      组件本身

    • event:Event

      window.event 对象

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
tap触碰事件cola.Widget
Parameters:
  • selfObject

    组件本身

  • argObject

    • dom:HTMLElement

      组件本身

    • event:Event

      window.event 对象

在touch环境下建议使用此事件,在Android下响应比click快
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
attributeChange当有属性的值被改写时触发的事件。cola.Element
Parameters:
  • selfObject

    cola对象本身

  • argObject

    • attribute:string

      被改写的属性名。

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
destroy当有对象被销毁时触发的事件。cola.Element
Parameters:
  • selfObject

    cola对象本身

  • argObject

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理