Accordion 类

[方法]、 [字段]、 [事件]

全称	mx.containers.Accordion
命名空间	mx.containers
类	Accordion
继承层次结构	AccordionContainerControl
源文件	~\mx\scripts\containers\Accordion.js

提供一个手风琴式的多面板容器控件。

示例 1

以下是一个创建 Accordion 的示例。该示例将说明如何创建一个 Accordion，如何添加 Panel 页。

JavaScript 代码
`var accordion = new mx.containers.Accordion({ height:500, panels:[ { title: "面板1", name: "panel1" }, { title: "面板2", name: "panel2" } ] }); accordion.appendPanel({name:"panel3", title:"面板3"});`

示例 2

以下是一个向 Accordion 控件的面板中添加内容的示例。

JavaScript 代码
`var text = new mx.editors.TextEditor({ value: "bruce" }); accordion.panels[0].addControl(text); var button = new mx.controls.Button({ text: "bruce" }); accordion.panels["panel1"].addControl(button);`

构造函数

名称	说明
Accordion()	构建 Accordion 类的新实例。

初始化函数

名称	说明
init()	初始化方法。执行设置样式并初始化属性等操作。

方法

名称	说明
addControl(p_control, p_islinebreak)	将 Control 对象添加到集合 controls 中。@param p_control 一个 Control 对象。 @param p_islinebreak 一个布尔值，表示添加新控件时是否先换行。
addControls(p_controls)	将一组 Control 对象添加到集合 controls 中。@param p_controls 一个 Control 控件数组。
append($p_obj)	向容器中添加内容。@param $p_obj 一个 JQuery 对象，或一个控件（包含 $container 容器），或一个 HTML DOM 元素。
appendPanel(p_name, p_title)	向 Accordion 的面板集合（panels）中添加新面板，并返回该 Panel 对象。如果同时传入两个参数，第一个参数 p_name 为字符串，表示面板名称，第二个参数 p_title 为字符串，表示标题。如果仅传入一个参数，p_name 表示一个 JSON 定义或 Panel 类型的对象。
appendPanels(p_panels)	向 Accordion 的面板集合（panels）中添加一组面板。
clear()	容器的dispose方法
contains($p_target)	返回一个 Boolean 值，该值表示控件的容器中是否包含该 JQuery 对象。
dispose()	容器的dispose方法
findControl(p_alias)	根据指定的控件属性及属性值查找当前视图中对应的控件。如果仅传入一个参数，则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串，表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串，表示控件的属性名。 @param p_attrValue 一个字符串，表示控件的属性值。
findControl(p_attrName, p_attrValue)	根据指定的控件属性及属性值查找当前视图中对应的控件。如果仅传入一个参数，则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串，表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串，表示控件的属性名。 @param p_attrValue 一个字符串，表示控件的属性值。
findControlByPermissionID(p_permissionID)	根据指定的权限标识查找当前视图中对应的控件。
getContext()	获取控件当前所属 Weblet 的上下文信息（ WebletContext 类型）。
getEl()	获取控件容器对应的 HTML DOM 元素对象。
hide()	隐藏控件，设置控件不可见。
moveTo(p_left, p_top)	移动控件到指定位置。@param p_left 一个数字，表示 css 样式的 left 属性。 @param p_top 一个数字，表示 css 样式的 top 属性。
removeControl(p_control, p_deep)	从 controls 集合中移除指定的 Control 对象。从集合中移除控件时，该控件会被从上下文的 DOM 中移除，但仍驻留在内存中，可以重用。
removePanel(p_panel)	从 panels 集合中移除指定的 Panel 对象。
removePanels(p_panels)	从 panels 集合中移除指定的 Panel 对象集合。
resizeTo(p_width, p_height)	重设控件的大小。@param p_width 控件的宽度，可以是数字（如 100），也可以是字符串（如 “100%”）。 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。
selectPanel(p_panel, [p_triggerEvent])	选中指定的 Panel 面板。
setBorder(p_border)	设置控件的边框样式。@param p_border 一个字符串，表示css样式的 border 属性。
setBottom(p_bottom)	设置 bottom 字段的值。@param p_bottom 控件的下边界与父容器下边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setCss(p_css)	设置 css 字段的值。 @param p_css 一个 JSON 对象，表示控件的 CSS 样式。
setCssClass(p_cssClass)	设置 cssClass 字段的值 @param p_cssClass 一个String 对象，样式classname
setDisplay(p_display)	设置 display 字段的值。@param p_display css 样式的 display 属性。
setEnabled(p_enabled)	设置 enabled 字段的值。
setHeight(p_height)	设置 height 字段的值。注：子类UploadControl上传控件不支持百分比设置高度 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。
setLeft(p_left)	设置 left 字段的值。 @param p_left 控件的左边界与父容器左边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setPadding(p_padding)	设置控件的内边距。 {@excude mx.containers.Wizard}
setPosition(p_position)	设置 position 字段的值。@param p_position 一个字符串，表示 css 样式的 position 属性。
setRight(p_right)	设置 right 字段的值。@param p_right 控件的右边界与父容器右边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setSpeed(p_speed)	设置 speed 字段的值。
setTop(p_top)	设置 top 字段的值。 @param p_top 控件的上边界与父容器上边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。
setVisible(p_visible)	设置 visible 字段的值。@param p_visible 一个 Boolean 值，表示控件是否可见。
setWidth(p_width)	设置 width 字段的值。@param p_width 控件的高度,可以是数字（如 500）、字符串（如“500px”或“50%”）.
show()	显示控件，设置控件可见。
$(p_expression)	该方法与 me.$e.find(p_expression) 等同。
$wrap([p_obj])	返回一个 JQuery 对象。

字段

名称	说明
alias	获取或设置一个字符串，表示控件的别名。
animated	获取或者设置是否启用动画效果。
border	获取控件的边框样式。如“1px solid red”，表示边框的样式为 1 像素红色的实线。请使用 setBorder 方法设置该字段的值。
bottom	获取控件的下边界与父容器下边界的像素距离。请使用 setBottom 方法设置该字段的值。
controls	获取容器包含的控件集合。集合中的单个控件也可能是一个容器。请使用 addControl 和 removeControl 方法向集合中添加或移除控件。
cssClass	指定css伪类名称，设置控件显示样式
display	获取控件的显示样式值。如“none”，表示隐藏控件； “block”表示强制作为块对象呈递。请使用 setDisplay方法设置该字段的值。
enableBrowserContextMenu	获取或初始化设置是否允许浏览器默认的上下文菜单。
enabled	获取控件是否可以对用户交互作出响应。如果该值为 true，则表示控件可以对用户交互作出响应；反之则不能。请使用 setEnabled 方法设置该字段的值。
eTag	获取控件的标签。
height	请参见 Control.height 字段。
layoutConfigs	获取或者设置一个 JSON 对象，该属性表示控件在父容器中的布局配置参数。该属性只有在控件父容器运用布局器才会生效。
left	获取控件的左边界与父容器左边界的像素距离。请使用 setLeft 方法设置该字段的值。
padding	获取控件的内边距。如“4px”表示上下左右的内边距均为 4 像素； “4px 2px 3px 1px”则表示上边距为 4 像素，右边距为 2 像素，下边距为 3 像素，左边距为 1 像素。请使用 setPadding 方法设置该字段的值。
panelHeadHeight	获取或设置面板标题头的高度。
panels	获取一个集合，包含控件中所有的面板（Panel 类型）。
parent	获取控件所属的父对象。
permissionID	获取或设置一个字符串，表示控件的权限标识。
position	详见 Control.position 属性。
right	获取控件的右边界与父容器右边界的像素距离。请使用 setRight 方法设置该字段的值。
selection	获取一个对象，表示 Accordion 中当前显示的面板（Panel 类型）。
speed	获取或设置 Panel 面板在切换时的速度。请使用 setSpeed 方法设置改值。
top	获取控件的上边界与父容器上边界的像素距离。请使用 setTop 方法设置该字段的值。
visible	获取一个 Boolean 值，表示控件是否可见。如果该值为 true，则表示控件可见；反之则不可见。请使用 setVisible 方法设置该字段的值。@default true
width	请参见 Control.width 字段。
$container	获取容器控件中用来包含控件 DOM 元素的占位符。
$e	获取该控件的占位符，该占位符为一个 JQuery 对象。

事件

名称	说明
oncontextmenu	在弹出上下之前执行传入执行方法中参数为 {cancel:false,event:e}; cancel如果为true会中断默认逻辑的执行，event为事件参数
onctrladded	当添加控件到容器后，将触发该事件。
onctrlremoved	当从容器移除控件后，将触发该事件。
onselectionchanged	当控件的显示面板发生改变后，将触发该事件。调用 selectPanel(p_panel, true) 方法时会触发该事件。
onselectionchanging	当控件的显示面板发生改变之前，将触发该事件。调用 selectPanel 方法时会触发该事件。

构造函数详细信息

Accordion() 方法

构建 Accordion 类的新实例。

初始化函数详细信息

init() 方法

初始化方法。执行设置样式并初始化属性等操作。

继承自

mx.containers.Container.init

方法详细信息

addControl(p_control, p_islinebreak) 方法

将 Control 对象添加到集合 controls 中。@param p_control 一个 Control 对象。 @param p_islinebreak 一个布尔值，表示添加新控件时是否先换行。

参数

p_control
一个 Control 对象。
p_islinebreak
一个布尔值，表示添加新控件时是否先换行。

继承自

mx.containers.Container.addControl

addControls(p_controls) 方法

将一组 Control 对象添加到集合 controls 中。@param p_controls 一个 Control 控件数组。

参数

p_controls
一个 Control 控件数组。

继承自

mx.containers.Container.addControls

append($p_obj) 方法

向容器中添加内容。@param $p_obj 一个 JQuery 对象，或一个控件（包含 $container 容器），或一个 HTML DOM 元素。

参数

$p_obj
一个 JQuery 对象，或一个控件（包含 $container 容器），或一个 HTML DOM 元素。

继承自

mx.containers.Container.append

appendPanel(p_name, p_title) 方法

向 Accordion 的面板集合（panels）中添加新面板，并返回该 Panel 对象。如果同时传入两个参数，第一个参数 p_name 为字符串，表示面板名称，第二个参数 p_title 为字符串，表示标题。如果仅传入一个参数，p_name 表示一个 JSON 定义或 Panel 类型的对象。

参数

p_name
一个 JSON 定义或 Panel 类型的对象。如果是字符串表示该面板的名称，对应 Panel 的 Panel.name 字段。
p_title
一个字符串，表示该面板的标题。

appendPanels(p_panels) 方法

向 Accordion 的面板集合（panels）中添加一组面板。

参数

p_panels
一个数组，该数组包含了一组 Panel 对象。

clear() 方法

容器的dispose方法

继承自

mx.containers.Container.clear

contains($p_target) 方法

返回一个 Boolean 值，该值表示控件的容器中是否包含该 JQuery 对象。

参数

$p_target
一个 JQuery 对象，或 JQuery 选择器对应的字符串（如“#container”），或 HTML DOM 元素。

继承自

mx.controls.Control.contains

dispose() 方法

容器的dispose方法

继承自

mx.containers.Container.dispose

findControl(p_alias) 方法

根据指定的控件属性及属性值查找当前视图中对应的控件。如果仅传入一个参数，则默认将该参数作为别名的值进行查找。 @overload function(p_alias) @param p_alias 一个字符串，表示控件的别名。 @overload function(p_attrName, p_attrValue) @param p_attrName 一个字符串，表示控件的属性名。 @param p_attrValue 一个字符串，表示控件的属性值。

参数

p_alias
一个字符串，表示控件的别名。

继承自

mx.containers.Container.findControl

findControl(p_attrName, p_attrValue) 方法

参数

p_attrName
一个字符串，表示控件的属性名。
p_attrValue
一个字符串，表示控件的属性值。 {@exclude mx.datacontrols.DynamicForm}

继承自

mx.containers.Container.findControl

findControlByPermissionID(p_permissionID) 方法

根据指定的权限标识查找当前视图中对应的控件。

参数

p_permissionID
一个字符串，表示控件的权限标识。

继承自

mx.containers.Container.findControlByPermissionID

getContext() 方法

获取控件当前所属 Weblet 的上下文信息（ WebletContext 类型）。

继承自

mx.controls.Control.getContext

getEl() 方法

获取控件容器对应的 HTML DOM 元素对象。

继承自

mx.controls.Control.getEl

hide() 方法

隐藏控件，设置控件不可见。

继承自

mx.controls.Control.hide

moveTo(p_left, p_top) 方法

移动控件到指定位置。@param p_left 一个数字，表示 css 样式的 left 属性。 @param p_top 一个数字，表示 css 样式的 top 属性。

参数

p_left
一个数字，表示 css 样式的 left 属性。
p_top
一个数字，表示 css 样式的 top 属性。

继承自

mx.controls.Control.moveTo

removeControl(p_control, p_deep) 方法

从 controls 集合中移除指定的 Control 对象。从集合中移除控件时，该控件会被从上下文的 DOM 中移除，但仍驻留在内存中，可以重用。

参数

p_control
一个 Control 对象。
p_deep
表示是否从内存中删除指定控件。

继承自

mx.containers.Container.removeControl

removePanel(p_panel) 方法

从 panels 集合中移除指定的 Panel 对象。

参数

p_panel
一个 Panel 对象；或者一个字符串，表示 Panel 的 Panel.name 值；或者一个数字，表示数组中的索引值。

removePanels(p_panels) 方法

从 panels 集合中移除指定的 Panel 对象集合。

参数

p_panels
一个数组，该数组包含了一组 Panel 对象；或者是Panel.name 组成的数组。

resizeTo(p_width, p_height) 方法

重设控件的大小。@param p_width 控件的宽度，可以是数字（如 100），也可以是字符串（如 “100%”）。 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

参数

p_width
控件的宽度，可以是数字（如 100），也可以是字符串（如 “100%”）。
p_height
控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

继承自

mx.controls.Control.resizeTo

selectPanel(p_panel, [p_triggerEvent]) 方法

选中指定的 Panel 面板。

参数

p_panel
一个字符串或 Panel 类型的对象。如果是字符串表示该面板的名称，对应 Panel 的 Panel.name 字段。
p_triggerEvent
可选的。默认值为“false”。一个 Boolean 值，表示是否要触发 onselectionchanged 事件。如果该值为 true，则触发事件；反之则不触发。

setBorder(p_border) 方法

设置控件的边框样式。@param p_border 一个字符串，表示css样式的 border 属性。

参数

p_border
一个字符串，表示css样式的 border 属性。

继承自

mx.controls.Control.setBorder

setBottom(p_bottom) 方法

设置 bottom 字段的值。@param p_bottom 控件的下边界与父容器下边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

p_bottom
控件的下边界与父容器下边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

继承自

mx.controls.Control.setBottom

setCss(p_css) 方法

设置 css 字段的值。 @param p_css 一个 JSON 对象，表示控件的 CSS 样式。

参数

p_css
一个 JSON 对象，表示控件的 CSS 样式。 {@exclude mx.datacontrols.ScrollBar}

继承自

mx.controls.Control.setCss

setCssClass(p_cssClass) 方法

设置 cssClass 字段的值 @param p_cssClass 一个String 对象，样式classname

参数

p_cssClass
一个String 对象，样式classname {@exclude mx.datacontrols.ScrollBar}

继承自

mx.controls.Control.setCssClass

setDisplay(p_display) 方法

设置 display 字段的值。@param p_display css 样式的 display 属性。

参数

p_display
css 样式的 display 属性。

继承自

mx.controls.Control.setDisplay

setEnabled(p_enabled) 方法

设置 enabled 字段的值。

参数

p_enabled

继承自

mx.controls.Control.setEnabled

setHeight(p_height) 方法

设置 height 字段的值。注：子类UploadControl上传控件不支持百分比设置高度 @param p_height 控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

参数

p_height
控件的高度，可以是数字（如 100），也可以是字符串（如 “100%”）。

继承自

mx.controls.Control.setHeight

setLeft(p_left) 方法

设置 left 字段的值。 @param p_left 控件的左边界与父容器左边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

p_left
控件的左边界与父容器左边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。 {@exclude mx.datacontrols.ComplexForm} {@exclude mx.datacontrols.DataGridSearchBox} {@exclude mx.datacontrols.DynamicForm} {@exclude mx.datacontrols.SkinDataForm}

继承自

mx.controls.Control.setLeft

setPadding(p_padding) 方法

设置控件的内边距。 {@excude mx.containers.Wizard}

参数

p_padding
css 样式的 padding 属性。

继承自

mx.containers.Container.setPadding

setPosition(p_position) 方法

设置 position 字段的值。@param p_position 一个字符串，表示 css 样式的 position 属性。

参数

p_position
一个字符串，表示 css 样式的 position 属性。

继承自

mx.controls.Control.setPosition

setRight(p_right) 方法

设置 right 字段的值。@param p_right 控件的右边界与父容器右边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

p_right
控件的右边界与父容器右边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

继承自

mx.controls.Control.setRight

setSpeed(p_speed) 方法

设置 speed 字段的值。

参数

p_speed
一个字符串，如"fast","normal","slow",或者数值表示毫秒数，如 500。

setTop(p_top) 方法

设置 top 字段的值。 @param p_top 控件的上边界与父容器上边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。

参数

p_top
控件的上边界与父容器上边界的像素距离，可以是数字（如 50），也可以是字符串（如 50%）。 {@exclude mx.datacontrols.ComplexForm} {@exclude mx.datacontrols.DataGridSearchBox} {@exclude mx.datacontrols.DynamicForm} {@exclude mx.datacontrols.SkinDataForm}

继承自

mx.controls.Control.setTop

setVisible(p_visible) 方法

设置 visible 字段的值。@param p_visible 一个 Boolean 值，表示控件是否可见。

参数

p_visible
一个 Boolean 值，表示控件是否可见。

继承自

mx.controls.Control.setVisible

setWidth(p_width) 方法

设置 width 字段的值。@param p_width 控件的高度,可以是数字（如 500）、字符串（如“500px”或“50%”）.

参数

p_width
控件的高度,可以是数字（如 500）、字符串（如“500px”或“50%”）.

继承自

mx.controls.Control.setWidth

show() 方法

显示控件，设置控件可见。

继承自

mx.controls.Control.show

$(p_expression) 方法

该方法与 me.$e.find(p_expression) 等同。

参数

p_expression

继承自

mx.controls.Control.$

$wrap([p_obj]) 方法

返回一个 JQuery 对象。

参数

p_obj
可选的。默认值为“me.$e”。一个 JQuery 对象，或继承自 Control 的控件，或字符串，或 HTML DOM 元素。如果参数为 JQuery 对象，则返回本身；如果参数为继承自 Control 的控件，则返回控件的 $e 对象；如果参数为字符串，则返回以字符串为选择器的 JQuery 对象；如果参数为空，则返回控件本身的 $e 对象。