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

Extends:cola.Widget
cola 的抽象ItemGroup

子项列表
currentIndex
number
cola.AbstractItemGroup
当前Item的序号(自0开始计算)
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不会对其内容做任何处理。
getContentContainer()返回容纳子项的Dom 元素cola.AbstractItemGroup
Returns:void
getItemDom(index)移除Sectioncola.AbstractItemGroup
Parameters:
  • indexnumber

    Item的序号(自0开始计算)

Returns:void
setCurrentIndex(index)设置当前项cola.AbstractItemGroup
Parameters:
  • index

    Item的序号(自0开始计算)

Returns:void
addItem(config)添加Itemcola.AbstractItemGroup
Parameters:
  • configobject||HTMLElement

Returns:void

groupWidget.addItem({
  $type:"Button",
  caption:"按钮",
  active:true //将此项设置为当前
})
groupWidget.addItem({
  tagName:"div",
  content:"html element item",
  active:true //将此项设置为当前
})
groupWidget.addItem(document.createElement("div"))

clearItems()清空Itemscola.AbstractItemGroup
Returns:void
removeItem(item)移除指定Itemcola.AbstractItemGroup
Parameters:
  • itemnumber||HTMLElement||cola.Widget

    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
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
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进行处理