api/cola.TitleBar.html

<!DOCTYPE html><html><head><title>cola.TitleBar</title><meta charset="utf-8"><meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1, maximum-scale=1"><link rel="stylesheet" type="text/css" href="./resources/css.css"><link rel="stylesheet" type="text/css" href="./resources/doc.css"></head><body class="v-box"><div class="ui inverted menu doc-header box"><div class="ui header item">Cola UI API-v1.0.9</div><div class="right menu"><a id="showSidebarBtn" class="item"><i class="content icon"></i></a></div></div><div class="flex-box"><div class="row doc-body"><div id="toc" class="medium-3 large-2 columns"><div class="ui icon input fluid inverted transparent"><input id="searchInput" type="text" placeholder="搜索..."><i class="search icon"></i></div><div class="ui list"><a href="./$.html" class="item data-item">$</a><a href="./cola.html" class="item data-item">cola</a><a href="./cola.AbstractButton.html" class="item data-item">cola.AbstractButton</a><a href="./cola.AbstractCheckbox.html" class="item data-item">cola.AbstractCheckbox</a><a href="./cola.AbstractContainer.html" class="item data-item">cola.AbstractContainer</a><a href="./cola.AbstractDropdown.html" class="item data-item">cola.AbstractDropdown</a><a href="./cola.AbstractEditor.html" class="item data-item">cola.AbstractEditor</a><a href="./cola.AbstractInput.html" class="item data-item">cola.AbstractInput</a><a href="./cola.AbstractItemGroup.html" class="item data-item">cola.AbstractItemGroup</a><a href="./cola.AbstractList.html" class="item data-item">cola.AbstractList</a><a href="./cola.AbstractMenuItem.html" class="item data-item">cola.AbstractMenuItem</a><a href="./cola.AbstractSlotList.html" class="item data-item">cola.AbstractSlotList</a><a href="./cola.AjaxValidator.html" class="item data-item">cola.AjaxValidator</a><a href="./cola.AsyncValidator.html" class="item data-item">cola.AsyncValidator</a><a href="./cola.Avatar.html" class="item data-item">cola.Avatar</a><a href="./cola.Breadcrumb.html" class="item data-item">cola.Breadcrumb</a><a href="./cola.Button.html" class="item data-item">cola.Button</a><a href="./cola.ButtonGroup.html" class="item data-item">cola.ButtonGroup</a><a href="./cola.Calendar.html" class="item data-item">cola.Calendar</a><a href="./cola.CardBook.html" class="item data-item">cola.CardBook</a><a href="./cola.Carousel.html" class="item data-item">cola.Carousel</a><a href="./cola.CascadeBind.html" class="item data-item">cola.CascadeBind</a><a href="./cola.Checkbox.html" class="item data-item">cola.Checkbox</a><a href="./cola.ControlMenuItem.html" class="item data-item">cola.ControlMenuItem</a><a href="./cola.Corner.html" class="item data-item">cola.Corner</a><a href="./cola.CustomDropdown.html" class="item data-item">cola.CustomDropdown</a><a href="./cola.CustomValidator.html" class="item data-item">cola.CustomValidator</a><a href="./cola.DataType.html" class="item data-item">cola.DataType</a><a href="./cola.DatePicker.html" class="item data-item">cola.DatePicker</a><a href="./cola.DateTimePicker.html" class="item data-item">cola.DateTimePicker</a><a href="./cola.Definition.html" class="item data-item">cola.Definition</a><a href="./cola.Dialog.html" class="item data-item">cola.Dialog</a><a href="./cola.Divider.html" class="item data-item">cola.Divider</a><a href="./cola.Dropdown.html" class="item data-item">cola.Dropdown</a><a href="./cola.DropdownMenuItem.html" class="item data-item">cola.DropdownMenuItem</a><a href="./cola.Element.html" class="item data-item">cola.Element</a><a href="./cola.EmailValidator.html" class="item data-item">cola.EmailValidator</a><a href="./cola.Entity.html" class="item data-item">cola.Entity</a><a href="./cola.EntityDataType.html" class="item data-item">cola.EntityDataType</a><a href="./cola.EntityList.html" class="item data-item">cola.EntityList</a><a href="./cola.FieldSet.html" class="item data-item">cola.FieldSet</a><a href="./cola.GroupBox.html" class="item data-item">cola.GroupBox</a><a href="./cola.HeaderMenuItem.html" class="item data-item">cola.HeaderMenuItem</a><a href="./cola.IFrame.html" class="item data-item">cola.IFrame</a><a href="./cola.Image.html" class="item data-item">cola.Image</a><a href="./cola.Input.html" class="item data-item">cola.Input</a><a href="./cola.ItemsView.html" class="item data-item">cola.ItemsView</a><a href="./cola.Label.html" class="item data-item">cola.Label</a><a href="./cola.Layer.html" class="item data-item">cola.Layer</a><a href="./cola.LengthValidator.html" class="item data-item">cola.LengthValidator</a><a href="./cola.Link.html" class="item data-item">cola.Link</a><a href="./cola.ListView.html" class="item data-item">cola.ListView</a><a href="./cola.Menu.html" class="item data-item">cola.Menu</a><a href="./cola.MenuButton.html" class="item data-item">cola.MenuButton</a><a href="./cola.MenuItem.html" class="item data-item">cola.MenuItem</a><a href="./cola.Model.html" class="item data-item">cola.Model</a><a href="./cola.MultiSlotPicker.html" class="item data-item">cola.MultiSlotPicker</a><a href="./cola.NestedList.html" class="item data-item">cola.NestedList</a><a href="./cola.NestedListBind.html" class="item data-item">cola.NestedListBind</a><a href="./cola.NestedListNode.html" class="item data-item">cola.NestedListNode</a><a href="./cola.Node.html" class="item data-item">cola.Node</a><a href="./cola.NotifyTipManager.html" class="item data-item">cola.NotifyTipManager</a><a href="./cola.NumberValidator.html" class="item data-item">cola.NumberValidator</a><a href="./cola.Pager.html" class="item data-item">cola.Pager</a><a href="./cola.Panel.html" class="item data-item">cola.Panel</a><a href="./cola.PointingLabel.html" class="item data-item">cola.PointingLabel</a><a href="./cola.Progress.html" class="item data-item">cola.Progress</a><a href="./cola.Property.html" class="item data-item">cola.Property</a><a href="./cola.Provider.html" class="item data-item">cola.Provider</a><a href="./cola.RadioButton.html" class="item data-item">cola.RadioButton</a><a href="./cola.RadioGroup.html" class="item data-item">cola.RadioGroup</a><a href="./cola.RangeSlotList.html" class="item data-item">cola.RangeSlotList</a><a href="./cola.Rating.html" class="item data-item">cola.Rating</a><a href="./cola.RegExpValidator.html" class="item data-item">cola.RegExpValidator</a><a href="./cola.RenderableElement.html" class="item data-item">cola.RenderableElement</a><a href="./cola.RequiredValidator.html" class="item data-item">cola.RequiredValidator</a><a href="./cola.Reveal.html" class="item data-item">cola.Reveal</a><a href="./cola.Ribbon.html" class="item data-item">cola.Ribbon</a><a href="./cola.Segment.html" class="item data-item">cola.Segment</a><a href="./cola.Select.html" class="item data-item">cola.Select</a><a href="./cola.Sidebar.html" class="item data-item">cola.Sidebar</a><a href="./cola.Slider.html" class="item data-item">cola.Slider</a><a href="./cola.SlotList.html" class="item data-item">cola.SlotList</a><a href="./cola.SplitPane.html" class="item data-item">cola.SplitPane</a><a href="./cola.Stack.html" class="item data-item">cola.Stack</a><a href="./cola.Steps.html" class="item data-item">cola.Steps</a><a href="./cola.SubView.html" class="item data-item">cola.SubView</a><a href="./cola.Tab.html" class="item data-item">cola.Tab</a><a href="./cola.TabButton.html" class="item data-item">cola.TabButton</a><a href="./cola.Table.html" class="item data-item">cola.Table</a><a href="./cola.TableColumn.html" class="item data-item">cola.TableColumn</a><a href="./cola.TableContentColumn.html" class="item data-item">cola.TableContentColumn</a><a href="./cola.TableDataColumn.html" class="item data-item">cola.TableDataColumn</a><a href="./cola.TableGroupColumn.html" class="item data-item">cola.TableGroupColumn</a><a href="./cola.TableSelectColumn.html" class="item data-item">cola.TableSelectColumn</a><a href="./cola.Tag.html" class="item data-item">cola.Tag</a><a href="./cola.TimeLine.html" class="item data-item">cola.TimeLine</a><a href="./cola.TitleBar.html" class="item data-item active">cola.TitleBar</a><a href="./cola.Toggle.html" class="item data-item">cola.Toggle</a><a href="./cola.Tree.html" class="item data-item">cola.Tree</a><a href="./cola.TreeNode.html" class="item data-item">cola.TreeNode</a><a href="./cola.TreeNodeBind.html" class="item data-item">cola.TreeNodeBind</a><a href="./cola.UrlValidator.html" class="item data-item">cola.UrlValidator</a><a href="./cola.Validator.html" class="item data-item">cola.Validator</a><a href="./cola.Widget.html" class="item data-item">cola.Widget</a><a href="./cola.breadcrumb.Section.html" class="item data-item">cola.breadcrumb.Section</a><a href="./cola.browser.html" class="item data-item">cola.browser</a><a href="./cola.buttonGroup.Separator.html" class="item data-item">cola.buttonGroup.Separator</a><a href="./cola.contants.html" class="item data-item">cola.contants</a><a href="./cola.defaultAction.html" class="item data-item">cola.defaultAction</a><a href="./cola.device.html" class="item data-item">cola.device</a><a href="./cola.os.html" class="item data-item">cola.os</a><a href="./cola.steps.Step.html" class="item data-item">cola.steps.Step</a><a href="./cola.tab.AbstractTabButton.html" class="item data-item">cola.tab.AbstractTabButton</a><a href="./cola.util.html" class="item data-item">cola.util</a><a href="./cola.util.KeyedArray.html" class="item data-item">cola.util.KeyedArray</a></div></div><div id="doc-content" class="small-12 medium-9 large-10 columns"><div style="height:100%" class="v-box"><div class="box"><h2 class="ui header">cola.TitleBar</h2><div class="extends">Extends:<a href="./cola.Menu.html">cola.Menu</a></div><div class="intro"><div class="sub header">cola 标题栏控件</div><div class="description"><p></p></div></div><div class="ui pointing secondary menu"><a data-tab="attributes" class="item active">Attributes</a><a data-tab="methods" class="item">Methods</a><a data-tab="events" class="item">Events</a></div></div><div class="flex-box"><div><div data-tab="attributes" class="ui tab active"><div class="ui attributes"><div class="item"><div data-key="title" class="item-header"><strong>title</strong><div class="type">String</div><em><a href="./cola.TitleBar.html"><code>cola.TitleBar</code></a></em></div><div class="item-body"><div class="label">标题</div><pre class="description"></pre></div></div><div class="item"><div data-key="items" class="item-header"><strong>items</strong><div class="type">Array</div><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">此Items将在Menu的从左到右排列。
此属性内容可通过以下方式定义。
<code>
new cola.Menu(
{
  items: [
    {
        caption: "腾讯微博", icon: "qq"
    },
    {
        caption: "微信", icon: "weixin"
    },
    {
        $type: "Input",icon:"sreach" //ControlItem的定义
    },
    {
        caption: "其他…", $type: "dropdown",  //DropDownItem的定义
        items: [
            {
                caption: "新浪微博", icon: "sina"
            },
            {
                caption: "人人网", icon: "renren"
            },
            {
                caption: "facebook", icon: "facebook"
            }
        ]
    }
  ]
}
)
</code>
</pre></div></div><div class="item"><div data-key="rightItems" class="item-header"><strong>rightItems</strong><div class="type">Array</div><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">此rightItems全部在菜单的右侧显示。
定义格式可参考Items属性
</pre></div></div><div class="item"><div data-key="centered" class="item-header"><strong>centered</strong><div class="type">boolean</div><span class="default-value">false</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">通过此属性可获得Semantic Menu Container效果。</pre></div></div><div class="item"><div data-key="float" class="item-header"><strong>float</strong><div class="type">string</div><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label"></div><div class="ui labels"><div class="ui label mini horizontal">left</div><div class="ui label mini horizontal">right</div></div><pre class="description">浮动:通过属性将根据所设定的值在容器中浮动显示
</pre></div></div><div class="item"><div data-key="display" class="item-header"><strong>display</strong><div class="type">boolean</div><span class="default-value">true</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label">是否显示</div><pre class="description"></pre></div></div><div class="item"><div data-key="ui" class="item-header"><strong>ui</strong><div class="type">string</div><span class="default-value">true</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">用户可自定样式之后通过此属性激活自定义样式，或者启用框架提供的样式
</pre></div></div><div class="item"><div data-key="popup" class="item-header"><strong>popup</strong><div class="type">String</div><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">弹出信息内容，当鼠悬停时显示此内容
</pre></div></div><div class="item"><div data-key="dimmer" class="item-header"><strong>dimmer</strong><div class="type">String</div><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label">调光器内容</div><pre class="description"></pre></div></div><div class="item"><div data-key="width" class="item-header"><strong>width</strong><div class="type">number|string</div><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">宽度(如果传入的值为number将计量单位为px)
</pre></div></div><div class="item"><div data-key="height" class="item-header"><strong>height</strong><div class="type">number|string</div><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="label"></div><pre class="description">高度(如果传入的值为number将计量单位为px)
</pre></div></div><div class="item"><div data-key="model" class="item-header"><strong>model</strong><div class="type">cola.Model</div><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="label">该对象所属的cola.Model</div><pre class="description"></pre></div></div><div class="item"><div data-key="tag" class="item-header"><strong>tag</strong><div class="type">string[]</div><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="label">对象拥有的标签</div><pre class="description">每一个Element的实例都可以拥有1到N的标签，每个标签是一个String类型的值。
通过标签，我们可以快速的获取一批Element的实例，以便于对他们进行统一的操作。
参考：<a href="cola.html#method:tag">cola.tag()</a>
<p>
另外，在设置tag时如果只需要设置一个tag，我们可以直接使用简单的字符串，Cola-UI会自动将其转换成字符串的数组。例如：
<code>
element.set("tag", "invisible");
</code>
</p>
</pre></div></div><div class="item"><div data-key="userData" class="item-header"><strong>userData</strong><div class="type">any</div><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="label">自定义数据。这里的自定义数据可以是任意数据类型，Cola-UI不会对其内容做任何处理。</div><pre class="description"></pre></div></div></div></div><div data-tab="methods" class="ui tab"><div class="ui methods"><div class="item"><div data-key="addItem" class="item-header"><strong>addItem(config)</strong><span class="label">添加Item</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">config</span><span class="type">object||HTMLElement</span><p class="desc"></p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description">参考例子代码如下:
<code>
menu.addItem({
  $type:"Button",
  caption:"按钮"
})
groupWidget.addItem({
  caption:"首页",
  icon:"home"
})
</code>
</pre></div></div><div class="item"><div data-key="clearItems" class="item-header"><strong>clearItems()</strong><span class="label">清空Items</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="removeItem" class="item-header"><strong>removeItem(item)</strong><span class="label">移除指定Item</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">item</span><span class="type">number||cola.MenuItem</span><p class="desc">item本身或者序号</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="addRightItem" class="item-header"><strong>addRightItem(config)</strong><span class="label">添加右侧Item</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">config</span><span class="type">object||cola.MenuItem</span><p class="desc"></p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description">参考例子代码如下:
<code>
menu.addRightItem({
  $type:"Button",
  caption:"按钮"
})
menu.addRightItem({
  caption:"首页",
  icon:"home"
})
</code>
</pre></div></div><div class="item"><div data-key="clearRightItems" class="item-header"><strong>clearRightItems()</strong><span class="label">清空右侧Items</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="removeRightItem" class="item-header"><strong>removeRightItem(item)</strong><span class="label">移除右侧指定Item</span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">item</span><span class="type">number||cola.MenuItem</span><p class="desc">item本身或者序号</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="showDimmer" class="item-header"><strong>showDimmer(options)</strong><span class="label">显示调光器</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">options</span><span class="type">object</span><p class="desc"></p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"><code>
var widget=new cola.Widget();
widget.showDimmer({content:"中间内容"})
widget.showDimmer({
  tagName:"div",
  content:{
    tagName:"div",
    content:"中间内容"
  }
})
</code>
</pre></div></div><div class="item"><div data-key="hideDimmer" class="item-header"><strong>hideDimmer()</strong><span class="label">关闭调光器</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="refresh" class="item-header"><strong>refresh()</strong><span class="label">刷新控件</span><em><a href="./cola.RenderableElement.html"><code>cola.RenderableElement</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="appendTo" class="item-header"><strong>appendTo(dom)</strong><span class="label">追加到指定的dom中</span><em><a href="./cola.RenderableElement.html"><code>cola.RenderableElement</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">dom</span><span class="type">HTMLElement | jQuery | zepto</span><p class="desc"></p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="getDom" class="item-header"><strong>getDom()</strong><span class="label"></span><em><a href="./cola.RenderableElement.html"><code>cola.RenderableElement</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="get$Dom" class="item-header"><strong>get$Dom()</strong><span class="label">获得此组件Dom的jQuery或zepto实例</span><em><a href="./cola.RenderableElement.html"><code>cola.RenderableElement</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">jQeury|zepto</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="remove" class="item-header"><strong>remove()</strong><span class="label">从dom树上移除此组件</span><em><a href="./cola.RenderableElement.html"><code>cola.RenderableElement</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="destroy" class="item-header"><strong>destroy()</strong><span class="label">销毁此组件</span><em><a href="./cola.RenderableElement.html"><code>cola.RenderableElement</code></a></em></div><div class="item-body"><div class="return"><span class="label">Returns:</span><span class="type">void</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="get" class="item-header"><strong>get(key)</strong><span class="label">根据属性名或路径获取一个Attribute的值</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">key</span><span class="type">string</span><p class="desc">Attribute名或路径</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">any</span></div><pre class="description">注意设置或读取Attribute时，我们不但可以直接使用属性名也可以利用路径对属性值记性钻取式的读写。
请参考： <a href="../docs/element">Element</a>
</pre></div></div><div class="item"><div data-key="set" class="item-header"><strong>set(key,value)</strong><span class="label">根据属性名或路径设置一个Attribute的值</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">key</span><span class="type">string</span><p class="desc">Attribute名或路径</p></li><li class="param"><span class="name ui label mini horizontal">value</span><span class="type">any</span><p class="desc">要写入的值</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">cola.Element</span></div><pre class="description">注意设置或读取Attribute时，我们不但可以直接使用属性名也可以利用路径对属性值记性钻取式的读写。
请参考： <a href="../docs/element">Element</a>
</pre></div></div><div class="item"><div data-key="on" class="item-header"><strong>on(eventName,listener)</strong><span class="label">绑定一个事件监听器</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">eventName</span><span class="type">string</span><p class="desc">在定义此处的事件名时，我们可以通过":"分割的方式在事件名后面定义本事件监听器的别名。
</p></li><li class="param"><span class="name ui label mini horizontal">listener</span><span class="type">Function</span><p class="desc">事件监听器</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">cola.Element</span></div><pre class="description"></pre></div></div><div class="item"><div data-key="one" class="item-header"><strong>one(eventName,listener)</strong><span class="label">绑定一个一次性事件监听器</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">eventName</span><span class="type">string</span><p class="desc">事件名</p></li><li class="param"><span class="name ui label mini horizontal">listener</span><span class="type">Function</span><p class="desc">事件监听器</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">cola.Element</span></div><pre class="description">一次性事件监听器表示只要事件触发过一次，该事件监听器就会自动解除绑定。即这样的时间监听器只会触发一次。</pre></div></div><div class="item"><div data-key="off" class="item-header"><strong>off(eventName,listener)</strong><span class="label">解绑一个事件监听器</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">eventName</span><span class="type">string</span><p class="desc">事件名</p></li><li class="param"><span class="name ui label mini horizontal">listener</span><span class="type">Function</span><p class="desc">事件监听器</p></li></ul></div><div class="return"><span class="label">Returns:</span><span class="type">cola.Element</span></div><pre class="description"></pre></div></div></div></div><div data-tab="events" class="ui tab"><div class="ui events"><div class="item"><div data-key="itemClick" class="item-header"><strong>itemClick</strong><span class="label"></span><em><a href="./cola.Menu.html"><code>cola.Menu</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">事件的发起者,即组件本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc"></p><ul><li><span class="name ui label horizontal">undefined:</span><span class="type">cola.MenuItem</span><p class="desc">被单击的菜单项</p></li><li><span class="name ui label horizontal">undefined:</span><span class="type">Event</span><p class="desc">window.event 对象</p></li></ul></li></ul></div><pre class="description">当菜单某一个Item被单击时触发此事件</pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="click" class="item-header"><strong>click</strong><span class="label">单击事件</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">组件本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc"></p><ul><li><span class="name ui label horizontal">dom:</span><span class="type">HTMLElement</span><p class="desc">组件本身</p></li><li><span class="name ui label horizontal">event:</span><span class="type">Event</span><p class="desc">window.event 对象</p></li></ul></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="dblclick" class="item-header"><strong>dblclick</strong><span class="label">双击事件</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">组件本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc"></p><ul><li><span class="name ui label horizontal">dom:</span><span class="type">HTMLElement</span><p class="desc">组件本身</p></li><li><span class="name ui label horizontal">event:</span><span class="type">Event</span><p class="desc">window.event 对象</p></li></ul></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="mousedown" class="item-header"><strong>mousedown</strong><span class="label">鼠标左键被按下</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">组件本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc"></p><ul><li><span class="name ui label horizontal">dom:</span><span class="type">HTMLElement</span><p class="desc">组件本身</p></li><li><span class="name ui label horizontal">event:</span><span class="type">Event</span><p class="desc">window.event 对象</p></li></ul></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="mouseup" class="item-header"><strong>mouseup</strong><span class="label">鼠标左键弹起</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">组件本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc"></p><ul><li><span class="name ui label horizontal">dom:</span><span class="type">HTMLElement</span><p class="desc">组件本身</p></li><li><span class="name ui label horizontal">event:</span><span class="type">Event</span><p class="desc">window.event 对象</p></li></ul></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="tap" class="item-header"><strong>tap</strong><span class="label">触碰事件</span><em><a href="./cola.Widget.html"><code>cola.Widget</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">组件本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc"></p><ul><li><span class="name ui label horizontal">dom:</span><span class="type">HTMLElement</span><p class="desc">组件本身</p></li><li><span class="name ui label horizontal">event:</span><span class="type">Event</span><p class="desc">window.event 对象</p></li></ul></li></ul></div><pre class="description">在touch环境下建议使用此事件,在Android下响应比click快
</pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="create" class="item-header"><strong>create</strong><span class="label">当有对象被创建时触发的事件。</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">cola对象本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc">事件参数</p></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="attributeChange" class="item-header"><strong>attributeChange</strong><span class="label">当有属性的值被改写时触发的事件。</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">cola对象本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc">事件参数</p><ul><li><span class="name ui label horizontal">attribute:</span><span class="type">string</span><p class="desc">被改写的属性名。</p></li></ul></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div><div class="item"><div data-key="destroy" class="item-header"><strong>destroy</strong><span class="label">当有对象被销毁时触发的事件。</span><em><a href="./cola.Element.html"><code>cola.Element</code></a></em></div><div class="item-body"><div class="parameters"><div class="label">Parameters:</div><ul><li class="param"><span class="name ui label mini horizontal">self</span><span class="type">Object</span><p class="desc">cola对象本身</p></li><li class="param"><span class="name ui label mini horizontal">arg</span><span class="type">Object</span><p class="desc">事件参数</p></li></ul></div><pre class="description"></pre><div class="return"><span class="label">Returns:</span><div class="desc">是否要继续后续事件的触发操作，不提供返回值时系统将按照返回值为<code>true</code>进行处理</div></div></div></div></div></div></div></div></div></div></div></div><div id="sidebar" c-widget="layer" class="ui layer"><div class="v-box"><div class="box"><div class="ui menu inverted"><a id="backButton" class="item icon"><i class="angle left icon"></i></a><div class="item"><div class="ui icon input transparent inverted"><input id="sidebarSearchInput" type="text" placeholder="搜索..."></div></div><a id="searchButton" class="item icon"><i class="search icon"></i></a></div></div><div class="flex-box"><div><div class="ui list"><a href="./$.html" class="item data-item">$</a><a href="./cola.html" class="item data-item">cola</a><a href="./cola.AbstractButton.html" class="item data-item">cola.AbstractButton</a><a href="./cola.AbstractCheckbox.html" class="item data-item">cola.AbstractCheckbox</a><a href="./cola.AbstractContainer.html" class="item data-item">cola.AbstractContainer</a><a href="./cola.AbstractDropdown.html" class="item data-item">cola.AbstractDropdown</a><a href="./cola.AbstractEditor.html" class="item data-item">cola.AbstractEditor</a><a href="./cola.AbstractInput.html" class="item data-item">cola.AbstractInput</a><a href="./cola.AbstractItemGroup.html" class="item data-item">cola.AbstractItemGroup</a><a href="./cola.AbstractList.html" class="item data-item">cola.AbstractList</a><a href="./cola.AbstractMenuItem.html" class="item data-item">cola.AbstractMenuItem</a><a href="./cola.AbstractSlotList.html" class="item data-item">cola.AbstractSlotList</a><a href="./cola.AjaxValidator.html" class="item data-item">cola.AjaxValidator</a><a href="./cola.AsyncValidator.html" class="item data-item">cola.AsyncValidator</a><a href="./cola.Avatar.html" class="item data-item">cola.Avatar</a><a href="./cola.Breadcrumb.html" class="item data-item">cola.Breadcrumb</a><a href="./cola.Button.html" class="item data-item">cola.Button</a><a href="./cola.ButtonGroup.html" class="item data-item">cola.ButtonGroup</a><a href="./cola.Calendar.html" class="item data-item">cola.Calendar</a><a href="./cola.CardBook.html" class="item data-item">cola.CardBook</a><a href="./cola.Carousel.html" class="item data-item">cola.Carousel</a><a href="./cola.CascadeBind.html" class="item data-item">cola.CascadeBind</a><a href="./cola.Checkbox.html" class="item data-item">cola.Checkbox</a><a href="./cola.ControlMenuItem.html" class="item data-item">cola.ControlMenuItem</a><a href="./cola.Corner.html" class="item data-item">cola.Corner</a><a href="./cola.CustomDropdown.html" class="item data-item">cola.CustomDropdown</a><a href="./cola.CustomValidator.html" class="item data-item">cola.CustomValidator</a><a href="./cola.DataType.html" class="item data-item">cola.DataType</a><a href="./cola.DatePicker.html" class="item data-item">cola.DatePicker</a><a href="./cola.DateTimePicker.html" class="item data-item">cola.DateTimePicker</a><a href="./cola.Definition.html" class="item data-item">cola.Definition</a><a href="./cola.Dialog.html" class="item data-item">cola.Dialog</a><a href="./cola.Divider.html" class="item data-item">cola.Divider</a><a href="./cola.Dropdown.html" class="item data-item">cola.Dropdown</a><a href="./cola.DropdownMenuItem.html" class="item data-item">cola.DropdownMenuItem</a><a href="./cola.Element.html" class="item data-item">cola.Element</a><a href="./cola.EmailValidator.html" class="item data-item">cola.EmailValidator</a><a href="./cola.Entity.html" class="item data-item">cola.Entity</a><a href="./cola.EntityDataType.html" class="item data-item">cola.EntityDataType</a><a href="./cola.EntityList.html" class="item data-item">cola.EntityList</a><a href="./cola.FieldSet.html" class="item data-item">cola.FieldSet</a><a href="./cola.GroupBox.html" class="item data-item">cola.GroupBox</a><a href="./cola.HeaderMenuItem.html" class="item data-item">cola.HeaderMenuItem</a><a href="./cola.IFrame.html" class="item data-item">cola.IFrame</a><a href="./cola.Image.html" class="item data-item">cola.Image</a><a href="./cola.Input.html" class="item data-item">cola.Input</a><a href="./cola.ItemsView.html" class="item data-item">cola.ItemsView</a><a href="./cola.Label.html" class="item data-item">cola.Label</a><a href="./cola.Layer.html" class="item data-item">cola.Layer</a><a href="./cola.LengthValidator.html" class="item data-item">cola.LengthValidator</a><a href="./cola.Link.html" class="item data-item">cola.Link</a><a href="./cola.ListView.html" class="item data-item">cola.ListView</a><a href="./cola.Menu.html" class="item data-item">cola.Menu</a><a href="./cola.MenuButton.html" class="item data-item">cola.MenuButton</a><a href="./cola.MenuItem.html" class="item data-item">cola.MenuItem</a><a href="./cola.Model.html" class="item data-item">cola.Model</a><a href="./cola.MultiSlotPicker.html" class="item data-item">cola.MultiSlotPicker</a><a href="./cola.NestedList.html" class="item data-item">cola.NestedList</a><a href="./cola.NestedListBind.html" class="item data-item">cola.NestedListBind</a><a href="./cola.NestedListNode.html" class="item data-item">cola.NestedListNode</a><a href="./cola.Node.html" class="item data-item">cola.Node</a><a href="./cola.NotifyTipManager.html" class="item data-item">cola.NotifyTipManager</a><a href="./cola.NumberValidator.html" class="item data-item">cola.NumberValidator</a><a href="./cola.Pager.html" class="item data-item">cola.Pager</a><a href="./cola.Panel.html" class="item data-item">cola.Panel</a><a href="./cola.PointingLabel.html" class="item data-item">cola.PointingLabel</a><a href="./cola.Progress.html" class="item data-item">cola.Progress</a><a href="./cola.Property.html" class="item data-item">cola.Property</a><a href="./cola.Provider.html" class="item data-item">cola.Provider</a><a href="./cola.RadioButton.html" class="item data-item">cola.RadioButton</a><a href="./cola.RadioGroup.html" class="item data-item">cola.RadioGroup</a><a href="./cola.RangeSlotList.html" class="item data-item">cola.RangeSlotList</a><a href="./cola.Rating.html" class="item data-item">cola.Rating</a><a href="./cola.RegExpValidator.html" class="item data-item">cola.RegExpValidator</a><a href="./cola.RenderableElement.html" class="item data-item">cola.RenderableElement</a><a href="./cola.RequiredValidator.html" class="item data-item">cola.RequiredValidator</a><a href="./cola.Reveal.html" class="item data-item">cola.Reveal</a><a href="./cola.Ribbon.html" class="item data-item">cola.Ribbon</a><a href="./cola.Segment.html" class="item data-item">cola.Segment</a><a href="./cola.Select.html" class="item data-item">cola.Select</a><a href="./cola.Sidebar.html" class="item data-item">cola.Sidebar</a><a href="./cola.Slider.html" class="item data-item">cola.Slider</a><a href="./cola.SlotList.html" class="item data-item">cola.SlotList</a><a href="./cola.SplitPane.html" class="item data-item">cola.SplitPane</a><a href="./cola.Stack.html" class="item data-item">cola.Stack</a><a href="./cola.Steps.html" class="item data-item">cola.Steps</a><a href="./cola.SubView.html" class="item data-item">cola.SubView</a><a href="./cola.Tab.html" class="item data-item">cola.Tab</a><a href="./cola.TabButton.html" class="item data-item">cola.TabButton</a><a href="./cola.Table.html" class="item data-item">cola.Table</a><a href="./cola.TableColumn.html" class="item data-item">cola.TableColumn</a><a href="./cola.TableContentColumn.html" class="item data-item">cola.TableContentColumn</a><a href="./cola.TableDataColumn.html" class="item data-item">cola.TableDataColumn</a><a href="./cola.TableGroupColumn.html" class="item data-item">cola.TableGroupColumn</a><a href="./cola.TableSelectColumn.html" class="item data-item">cola.TableSelectColumn</a><a href="./cola.Tag.html" class="item data-item">cola.Tag</a><a href="./cola.TimeLine.html" class="item data-item">cola.TimeLine</a><a href="./cola.TitleBar.html" class="item data-item active">cola.TitleBar</a><a href="./cola.Toggle.html" class="item data-item">cola.Toggle</a><a href="./cola.Tree.html" class="item data-item">cola.Tree</a><a href="./cola.TreeNode.html" class="item data-item">cola.TreeNode</a><a href="./cola.TreeNodeBind.html" class="item data-item">cola.TreeNodeBind</a><a href="./cola.UrlValidator.html" class="item data-item">cola.UrlValidator</a><a href="./cola.Validator.html" class="item data-item">cola.Validator</a><a href="./cola.Widget.html" class="item data-item">cola.Widget</a><a href="./cola.breadcrumb.Section.html" class="item data-item">cola.breadcrumb.Section</a><a href="./cola.browser.html" class="item data-item">cola.browser</a><a href="./cola.buttonGroup.Separator.html" class="item data-item">cola.buttonGroup.Separator</a><a href="./cola.contants.html" class="item data-item">cola.contants</a><a href="./cola.defaultAction.html" class="item data-item">cola.defaultAction</a><a href="./cola.device.html" class="item data-item">cola.device</a><a href="./cola.os.html" class="item data-item">cola.os</a><a href="./cola.steps.Step.html" class="item data-item">cola.steps.Step</a><a href="./cola.tab.AbstractTabButton.html" class="item data-item">cola.tab.AbstractTabButton</a><a href="./cola.util.html" class="item data-item">cola.util</a><a href="./cola.util.KeyedArray.html" class="item data-item">cola.util.KeyedArray</a></div></div></div></div></div></body><script src="./resources/javascript.js"></script><script src="./resources/doc.js"></script></html>