Repeater

• 基本示例
• Schema 示例
• 添加按钮属性
• 最小/最大值
• 控件
• 自定义控件
• 设置错误
• Props & Attributes
• Sections

基本示例

repeater 输入用于重复输入组。您可以在重复器中使用任意数量的 FormKit 输入，重复器本身可以无限嵌套。

默认情况下，重复器输入具有移动、添加和删除项目的功能：

与大多数其他 FormKit 输入类型不同，重复器输入的类型为 list。您可以在上面看到 users 属性（我们的重复器的值）是一个数组。

Schema 示例

与所有其他 FormKit 输入一样，Repeater 可以在用 FormKit schema 编写的表单中使用。

添加按钮属性

在前面的示例中，默认提供了 "添加用户" 按钮，按钮标签是从重复器的 label 中派生出来的。我们可以通过使用 add-button 属性并将其设置为 string 来自定义标签，或者通过将其设置为 false 来完全删除它。或者，类似于 FormKit's forms 上的 submit-attrs 属性，我们可以使用 add-attrs 提供一个要应用于按钮的属性对象。在此示例中，我们使用 add-label 属性将重复器的标签从 添加用户 更改为 我的自定义标签：

最小/最大值

与许多其他 FormKit 输入一样，重复器带有一个 min 和 max 属性。您可以使用这些属性来限制要添加或删除的项目数量。

控件

默认情况下，重复器输入带有一组控件，允许您移动、添加和删除项目。您可以通过将 upControl、downControl、insertControl 和 removeControl 属性设置为 true 或 false 来控制这些控件的可见性。

自定义控件

使用 FormKit 的重复器，您不受我们默认控件的限制。您可以以任何您想要的方式操作重复器：

设置错误

您可以使用点表示法在重复器或任何可重复项上设置错误。这里我们使用 setErrors 辅助函数，但还有其他方法：

// setErrors 的第二个参数是输入级错误
formNode.setErrors( null, // 没有表单错误,
  {
    // 重复器字段上的错误：
    'teamMembers': ['您的团队成员中有1个问题。']

    // 特定重复器项上的错误：
    'teamMembers.1.email': ['emily@formkit.com 已经在一个团队中。'],
  }
)

请记住，您的提交处理程序会传递表单的核心 node，并可以用于 方便地在深度上设置错误。阅读有关错误处理的更多信息 这里。以下是一个虚构的后端 返回重复器和一个子项的错误：

Props & Attributes

Sections

您可以通过使用该部分的"key"来定位输入的特定部分，从而可以修改该部分的类、HTML（通过:sections-schema）或内容（通过插槽）。了解更多关于部分的信息，请点击这里。