Sys.Component.create 方法

更新: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.ControlSys.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 快捷方式方法。如果调用,新组件将不能正确初始化。应当创建新组件,然后将该组件作为引用传递给顶部组件。

请参见

任务

创建自定义非可视客户端组件

概念

使用原型模型创建客户端组件类

参考

Sys.Component 类

其他资源

语言参考