该构造函数应用给定的 sId 和设置结构和初始化托管对象。
如果给出了可选的 mSettings,它们必须是一个简略的对象,定义了属性、聚合、关联或事件的值,它们的名称为键。
对象字面量 (object literal
) 中反对的属性(键)名称正是 JSDoc 中记录的以后类及其基类的属性、聚合、关联和事件的(辨别大小写的)名称。
请留神,对于 0..n 聚合和关联,此名称通常是复数名称,而在 0..1 关系的状况下它是复数名称。
如下图所示:
- 对于简略的属性,值必须与属性的记录类型匹配(不产生类型转换)
- 对于 0..1 聚合,值必须是聚合类型的实例
- 对于 0..n 聚合,该值必须是聚合类型的实例数组或单个实例
- 对于 0..1 关联,承受关联类型或 id(字符串)的实例
- 对于 0..n 关联,承受关联类型或 ID 的实例数组
- 对于事件,要么承受一个函数(事件处理程序),要么承受一个长度为 2 的数组,其中第一个元素是函数,第二个元素是调用办法的对象;或长度为 3 的数组,其中第一个元素是任意无效负载对象,第二个元素是函数,第三个元素是调用办法的对象;或者一个数组数组,其中每个嵌套数组都具备后面形容的 2 或 3 个元素构造(多个侦听器)。
每个子类都应在其构造函数文档中记录其反对设置的名称和类型。
看个理论的例子:
ew Dialog({
title: "Some title text", // property of type "string"
showHeader: true, // property of type "boolean"
endButton: new Button(...), // 0..1 aggregation
content: [ // 0..n aggregation
new Input(...),
new Input(...)
],
afterClose: function(oEvent) {...} // event handler function
});