循环处理列表中的每一项。
是循环的一种，另外一种循环模块是“重复”。

image.png
演示视频链接：在组合动作中使用循环

参数

【列表】要循环处理的列表变量。
【使用多线程】（1.7.4中增加）使用多线程同步处理列表里的项。基本的处理过程为：

  • 循环处理列表中的每一项：
    • 将项的值和计数 赋值到设定的变量；
    • 开启一个新的线程执行循环中的子步骤；在这些步骤中，应该立即读取保存项值的变量（如上面截图中的text），否则50ms后循环到下一个项的时候，这个变量的内容就会被覆盖为下一项的值了。
    • 等待50ms（为了让线程中的代码可以读取保存项值的变量）；
    • 处理下一项；

多线程使用提示

  • 警告！在多线程运行的代码中更新相同的变量可能会产生冲突。
  • 为避免log格式混乱，同步执行时调试运行log会被关闭。
  • 一些跳转处理将会失效（如停止动作/停止循环等，具体需测试）。
  • 可能存在其他潜在问题，请多测试动作。

输出

输出项将在每次循环时更新。 所以在循环内部，每次运行取到的变量是这次循环所对应的值。
【项】本次循环所要处理的列表元素的值。
【计数】当前是第几次循环，从0开始。

示例