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

items
Array||EntityList
cola.AbstractDropdown
列表下拉框中要显示的数据。
currentItem
Any
cola.AbstractDropdown
当前数据项
valueProperty
string
cola.AbstractDropdown
数据值对应属性
数据实体(JSON对象或dorado.Entity对象)中的某个属性名,表示下拉框对应的值。
textProperty
string
cola.AbstractDropdown
内容对应属性
数据实体(JSON对象或dorado.Entity对象)中的某个属性名,表示下拉框用于显示的数值来自于哪个属性。 如果不定义此属性则系统将按照property中定义的属性来处理。
openOnActive
boolean
cola.AbstractDropdown
是否启用自动打开的功能。即当相应的编辑框获得输入焦点时自动打开此下拉框。
openMode
string
autocola.AbstractDropdown
auto
drop
dialog
layer
sidebar
下拉框打开模式
dropdownWidth
string||int
cola.AbstractDropdown
下拉框宽度
dropdownHeight
string||int
cola.AbstractDropdown
下拉框高度
value
any
falsecola.AbstractInput
编辑器中的数值
dataType
string
cola.AbstractInput
数据类型
size
string
mediumcola.AbstractInput
尺寸
mini
tiny
small
medium
large
big
huge
massive
placeholder
string
cola.AbstractInput
当文本编辑框中没有任何实际内容时显示的文本。
图标
iconPosition
string
rightcola.AbstractInput
left
right
图标位置
corner
cola.Corner
cola.AbstractInput
角标
label
cola.Label
cola.AbstractInput
标签
labelPosition
string
leftcola.AbstractInput
left
right
标签显示的位置
actionButton
cola.Button
cola.AbstractInput
触发按钮
buttonPosition
string
rightcola.AbstractInput
left
right
触发按钮显示的位置
数据绑定
readOnly
boolean
falsecola.AbstractEditor
是否只读
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不会对其内容做任何处理。
open(callback)打开下拉框cola.AbstractDropdown
Parameters:
  • callbackfunction

    回调函数

Returns:void
close(selectedData,callback)关闭下拉框cola.AbstractDropdown
Parameters:
  • selectedDataAny

  • callbackfunction

    回调函数

Returns:void
focus()使控件获得控制焦点cola.AbstractInput
Returns:void
post()确认编辑器中的值cola.AbstractEditor
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
Parameters:
  • selfObject

    组件本身

  • argObject

打开下拉框之前触发此事件
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
Parameters:
  • selfObject

    组件本身

  • argObject

打开下拉框之后触发此事件
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
Parameters:
  • selfObject

    组件本身

  • argObject

关闭下拉框之后触发此事件
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
Parameters:
  • selfObject

    组件本身

  • argObject

当编辑器确认其中的编辑内容之前触发的事件。
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
Parameters:
  • selfObject

    组件本身

  • argObject

当编辑器确认了其中的编辑内容之后触发的事件。
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
Parameters:
  • selfObject

    事件的发起者,即组件本身

  • argObject

    • oldValue:any

      旧值

    • newCurrent:any

      新值

当编辑器中的值要发生改变时触发此事件
Returns:
是否要继续后续事件的触发操作,不提供返回值时系统将按照返回值为true进行处理
Parameters:
  • selfObject

    事件的发起者,即组件本身

  • argObject

    • oldValue:any

      旧值

    • newCurrent:any

      新值

当编辑器中的值发生改变时触发此事件
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进行处理