Skip to content

循环v-for

该组件是低代码平台中实现列表渲染的核心容器,用于根据绑定的数组数据动态生成多个子组件实例,模拟 Vue 的 v-for 行为。每个循环项可访问当前项数据、索引及位置状态(首/末项),并支持在设计器中可视化编辑模板。

高级属性

属性名类型说明
dataany[]绑定循环数据
必须为数组类型;若为空或未绑定,编辑模式下默认渲染一个空项占位以便设计

⚠️ 保护机制:若已有其他组件绑定了当前循环项数据(如 item),则禁止清除 data 绑定,防止运行时错误。

循环项数据定义

绑定数据后自动生成运行时 runtime 循环项数据定义

注意事项

  • 数据类型:确保绑定值为数组,否则可能导致渲染异常;
  • 🔒 模板一致性:所有循环项共享同一套模板结构,无法为不同项设置不同布局;
  • 🧩 嵌套支持:可在循环项内再嵌套“循环v-for”,实现多层列表;
  • 🚫 不可直接编辑项:除第一项外,其余项在设计器中不可交互,避免歧义。

该组件是构建列表、表格、卡片流等重复性 UI 的基石,增强动态渲染能力。