构建 TreeEntityContainer 类的新实例。
| 全称 | mx.datacontainers.TreeEntityContainer |
| 命名空间 | mx.datacontainers |
| 类 | TreeEntityContainer |
| 继承层次结构 | TreeEntityContainerEntityContainer |
| 源文件 | ~\mx\scripts\datacontainers\TreeEntityContainer.js |
| JavaScript 代码 |
var container = new mx.datacontainers.TreeEntityContainer(
{
"baseUrl" : "~/rest/getNode"
});
container.on("load", function()
{
alert("onload");//触发 onload 事件。
});
container.load(node);//为指定的节点加载子节点；如果不传参数，则加载根节点。 |
| JavaScript 代码 |
var container = new mx.datacontainers.TreeEntityContainer(
{
"type" : "local",//声明容器类型为本地数据。
"data" : //本地数据信息。
[
{
"id" : "local_1",
"text" : "local_1_text",
"hasChildren" : true,
"nodes" : //子节点。
[
{
"id" : "local_1_1",
"text" : "local_1_1_text",
"hasChildren" : false
},
{
"id" : "local_1_2",
"text" : "local_1_2_text",
"hasChildren" : false
} ]
},
{
"id" : "local_2",
"text" : "local_2_text",
"hasChildren" : false
},
{
"id" : "local_3",
"text" : "local_3_text",
"hasChildren" : false
} ]
});
container.on("load", function()
{
alert("onload");//触发 onload 事件。
});
container.load(); |
| 名称 | 说明 |
| TreeEntityContainer() | 构建 TreeEntityContainer 类的新实例。 |
| 名称 | 说明 |
| init() |
| 名称 | 说明 |
| bind(p_target) | 提供一个方法，用于跟另外一个数据容器绑定，达到数据同步的效果。 |
| checkSaved(p_id) | 提供一个方法，检查指定数据是否保存过。true 表示数据为修改状态；false表示数据为新增状态，尚未保存。 |
| clearChanges() | 提供一个方法，清除容器中记录的数据改变信息。 |
| create(p_node, p_options) | |
| getChangedItems() | 提供一个方法，获取数据容器中已改变但未保存的对象数组，对象中仅包含改变的对象属性及值。 |
| getChanges() | |
| getNodeEntity(p_nodeID, p_itemType) | 提供一个方法，根据主键获取对应的数据对象。 |
| hasChanged(p_changed) | 获取或者设置 EntityContainer.changed 字段的值。 |
| load([p_node]) | 提供一个方法，为数据容器加载数据对象。 |
| load([p_node], [p_callBack]) | 提供一个方法，为数据容器加载数据对象。 |
| remove(p_node) | 提供一个方法，删除一个树节点。 |
| remove(p_node, p_delete) | 提供一个方法，删除一个树节点。 |
| remove(p_node, [p_callback], [p_path]) | 提供一个方法，删除一个树节点。 |
| save([p_path]) | 调用后台服务，将新增和修改的内容保存到数据库。 保存前会调用 validate 方法检查数据值是否合法。 |
| setBaseUrl(p_url) | 设置 baseUrl 字段的值。 |
| setValue(p_entity, p_col, p_value) | 提供一个方法，修改表单中某个字段的值。 |
| setValue(p_entity, p_col, p_value, [p_triggerEvent]) | 提供一个方法，修改表单中某个字段的值。 |
| 名称 | 说明 |
| actions | 获取或设置一个 JSON 对象，表示数据容器中各种操作的 path 集合。该字段的字段名表示操作类型，值表示操作路径。
用户可以根据需要改变改变相应的操作路径。
该字段的字段名包括：
|
| baseUrl | 获取数据容器的资源 URL。请参见 RESTClient.baseUrl。 type属性值为remote，baseUrl属性必须设置，否则可以不用设置 |
| canCreate | |
| canModify | 获取一个 boolean 值，表示当前数据容器是否允许编辑。 |
| changed | 获取一个 Boolean 值，表示数据容器中是否存在修改过但未保存的数据。 当 insertEntity 和 updateEntity 方法被调用时，该字段被置为true；当 save 方法被调用时，该字段被还原为false。 |
| client | 获取数据容器的 REST 服务客户端 RESTClient，数据容器通过此客户端调用后台服务。 |
| data | 获取一个对象，表示数据容器中的数据值，通常为一个 JSON 对象或数组。 |
| dicts | 获取一个数组，表示数据容器中的数据字典。通过字段名称可以获取该字段对应的所有数据字典。 |
| enableLocalMask | 获取或设置一个 boolean 值，表示当前数据容器是否加载本地数据时使用加载提示动画。 |
| iscID | 获取或设置一个字符串，表示当前容器的操作权限，请求加载请求元数据是传给服务。 |
| loadByPost | 设置或者获取数据容器是否使用post方式提交查询服务，true：post方式 false：get方式 |
| loadMeta | 一个 boolean 值，表示当前数据容器是否有元数据信息。 少数控件比如树没有元数据信息时，子类重写成 false。 开发时确定元数据信息由前端指定，不需要调用服务时，也可以设置为 false。 |
| mdaParams | 获取或设置一个 JSON 对象，用于保存模型驱动所需要的参数。 |
| meta | 获取一个数组，表示数据容器中的元数据信息，通常包含各个字段的类型及校验信息等内容。 |
| primaryKey | 获取一个字符串，表示数据的主键（或唯一标识）所在列名。 |
| type | 获取数据容器的类型。必须在创建数据容器时设定该属性。
该字段可选的值包括：
|
| _changedItems | 受保护的。 |
| _changingType | 受保护的。 |
| _lastLoad | 受保护的。 |
| _loadCallBack | 受保护的。 |
| _loadData | 受保护的。 |
| _loadDataPara | 受保护的。 |
| _loadMetaPara | 受保护的。 |
| _oldData | 受保护的。 |
| _removeCallBack | 受保护的。 |
| _saveCallBack | 受保护的。 |
| _submitting | 受保护的。 |
| _tempLoadResult | 受保护的。 |
| 名称 | 说明 |
| onchanged | 当数据容器中的数据值发生改变后，将触发该事件。 |
| onchanging | 当数据容器中的数据值发生改变的时候，将触发该事件。 |
| oncreated | 当数据容器中新增数据对象后，将触发该事件。 |
| oncreating | 当数据容器中新增数据对象时，将触发该事件。 |
| ondeleted | 当数据容器中有数据对象被删除后，将触发该事件。 |
| ondeleting | 当数据容器中有数据对象被删除时，将触发该事件。 |
| onerror | 当出现错误时，将触发该事件。主要用于取消等待蒙板。 |
| onload | 以下参数说明仅包含当前子类的扩展参数，基础参数和其他信息请参照 EntityContainer.onload 事件。 |
| onloading | 当数据容器开始加载数据时，将触发该事件。调用 load 方法时会触发该事件。 |
| onsaved | 当数据容器中的数据对象保存成功后，将触发该事件。调用 save 方法会触发该事件。 |
| onsaving | 当数据容器中的数据对象保存时，将触发该事件。调用 save 方法会触发该事件。 |
| onvalidate | 当数据容器中的数据对象保存时，如果服务端校验不通过，将触发该事件。 要求服务端在保存失败的时候返回的数据格式如下所示。 {successful: false, resultValue: [[ {"error":true,"errors":["最后使用时间格式不正确！"],"errorsToDefaulFormatString":"最后使用时间格式不正确！\n","fieldName":"lastTime","messages":[],"msgToDefaulFormatString":""}, {"error":true,"errors":["必须为整数，介于0-10000之间"],"errorsToDefaulFormatString":"必须为整数，介于0-10000之间\n","fieldName":"pointCount","messages":[],"msgToDefaulFormatString":""} ]] ,resultHint: ""} ，其中嵌套数组表示一条记录的校验结果，数组内的 JSON 表示一个字段的检验结果。 |
该字段的字段名包括：
该字段可选的值包括：