Extends:cola.Widget

bind

cola.NestedListBind

cola.NestedList

级联绑定声明对象

autoSplit

boolean

truecola.NestedList

是否需要在非小屏状态下自动显示为左右分栏模式

navBarWidth

string || int

280pxcola.NestedList

当使用左右分栏模式显示时，左边栏的宽度。

showTitleBar

boolean

truecola.NestedList

是否显示标题栏

title

string

cola.NestedList

总的标题文字

layerIndex

int

cola.NestedList

当前显示层的索引号

splited

boolean

cola.NestedList

当前是否处于左右分栏模式中

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

back()回退cola.NestedList

Returns:boolean

此方法的返回值用于表示是否在执行back()的过程中实际的发生了层的切换。当嵌套列表已经处于最底层时，调用back()是不会实际产生回退动作的。

getLayer()根据索引号返回某个层的信息cola.NestedList

Returns:JSON

此方法的返回值是一个JSON对象，其中包含了下列子属性。

  index - 索引号
  parentNode - 父节点
  parentItem - 父节点对应的数据
  title - 标题
  titleBar - 标题栏控件
  list - 子列表控件
  nodes - 子节点数组

getTopLayer()根据当前最顶层的信息cola.NestedList

Returns:JSON

此方法的返回值是一个JSON对象，其中的具体属性请参考getLayer()

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.NestedList

Parameters:

selfObject
控件本身
argObject
- item:cola.Entity || any

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

Returns: