更新:2007 年 11 月
创建并初始化指定类型的组件。此方法是静态的,可在不创建类实例的情况下调用。
aComponent.create(type, properties, events, references, element);
参数
参数 |
说明 |
|---|---|
type |
要创建的组件的类型。 |
properties |
(可选)一个描述属性及其值的 JSON 对象。 |
events |
(可选)一个描述事件及其处理程序的 JSON 对象。 |
references |
(可选)一个描述属性的 JSON 对象,这些属性是对其他组件的引用。 |
element |
(可选)组件应附加到的 DOM 元素。 |
返回值
组件的新实例,该实例使用指定的参数。
备注
create 方法实例化指定类型的组件。如果组件是一个控件或行为,则 create 方法将组件附加到指定元素中。该方法设置以参数形式传递的所有属性或事件,然后调用 initialize 方法。
要创建的组件必须从 Sys.Component 类派生,可以直接派生,也可以从 Sys.UI.Control 或 Sys.UI.Behavior 派生。应在 Sys.Application.init 事件过程中调用 create 方法,以确保创建的组件在页面加载过程中可用。
也可以使用 $create 快捷方式方法调用 create 方法。
此方法的大多数参数是可选的,但对 create 方法的调用必须包括 null 作为不传递的任何参数的占位符。用于 properties、events 和 references 参数的值必须括在大括号 ({}) 中,并且必须采用下面的标准 JSON 格式:
{argument: value, argument2: value, ...}
下面的示例演示为大多数参数传递值的 create 方法:
$create(MyControl, {id: 'c1', visible: true}, {click: showValue}, null, $get('button1'));
此方法创建 MyControl 类的实例,将其 id 属性设置为“c1”,并将其 visible 属性设置为 true。该类具有 click 事件,该事件绑定到页面上的 showValue() 函数。此实例绑定到 ID 值为“button1”的 HTML DOM 元素。该类没有引用其他组件的任何属性,因此 references 参数设置为 null。
说明: |
|---|
不要从另一组件的 initialize 方法调用 create 方法或 $create 快捷方式方法。如果调用,新组件将不能正确初始化。应当创建新组件,然后将该组件作为引用传递给顶部组件。 |
说明: