$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.Table

表格控件

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
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:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
renderCell当表格渲染某一单元格时触发的事件。cola.Table
Parameters:
  • selfObject

    表格本身

  • argObject

    • item:cola.Entity || any

    • column:cola.TableContentColumn

    • dom:HTMLElement

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
renderHeaderCell当表格渲染标题单元格时触发的事件。cola.Table
Parameters:
  • selfObject

    表格本身

  • argObject

    • column:cola.TableContentColumn

    • dom:HTMLElement

Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
renderFooterCell当表格渲染汇总栏单元格时触发的事件。cola.Table
Parameters:
  • selfObject

    表格本身

  • argObject

    • column:cola.TableContentColumn

    • dom:HTMLElement

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