tmagic-editor/docs/runtime-api/core/iteratorContainer.md

IteratorContainer

IteratorContainer 是 @tmagic/core 的迭代容器类，继承自 Node，用于循环渲染的容器组件。

构造函数

new IteratorContainer(options: NodeOptions)

参数与 Node 构造函数相同。

属性

属性	类型	说明
nodes	Map<Id, Node>[]	每个迭代项的节点映射数组

继承自 Node 的属性请参见 Node 属性。

实例方法

setData

• 参数：

  • {MNode} data 节点数据

• 返回：

  • {void}

• 详情：

  设置数据，会重置所有迭代项的节点。

• 示例：

iteratorContainer.setData({
  id: 'iterator_1',
  type: 'iterator-container',
  iteratorData: [{ name: 'item1' }, { name: 'item2' }],
  items: [/* 子节点配置 */]
});

resetNodes

• 返回：

  • {void}

• 详情：

  重置所有迭代项的节点，会清空并重新初始化。

initNode

• 参数：

  • {MNode} config 节点配置
  • {Node} parent 父节点
  • {Map<Id, Node>} map 节点映射表

• 返回：

  • {Node}

• 详情：

  在指定的节点映射表中初始化节点。

setNodes

• 参数：

  • {Map<Id, Node>} nodes 节点映射表
  • {number} index 迭代索引

• 返回：

  • {void}

• 详情：

  设置指定索引的节点映射表。

• 示例：

iteratorContainer.setNodes(nodesMap, 0);

getNode

• 参数：

  • {Id} id 节点 ID
  • {number} index 迭代索引（可选，默认为 0）

• 返回：

  • {Node | undefined}

• 详情：

  获取指定迭代索引中的节点。

• 示例：

// 获取第一个迭代项中的节点
const node = iteratorContainer.getNode('button_1', 0);

// 获取第二个迭代项中的节点
const node2 = iteratorContainer.getNode('button_1', 1);

destroy

• 返回：

  • {void}

• 详情：

  销毁迭代容器及其所有迭代项的节点。

使用场景

IteratorContainer 常用于列表渲染场景，例如：

// DSL 配置示例
const iteratorConfig = {
  id: 'iterator_1',
  type: 'iterator-container',
  iteratorData: [
    { id: 1, title: '项目1' },
    { id: 2, title: '项目2' },
    { id: 3, title: '项目3' }
  ],
  items: [
    {
      id: 'text_tpl',
      type: 'text',
      text: '${item.title}'
    }
  ]
};