Repeater

• 基本示例
• Schema 示例
• 添加按钮属性
• 最小/最大
• 空状态
• 控制
• 自定义控件
• 设置错误
• Props & Attributes
• 部分

基本示例

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

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

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

Schema 示例

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

添加按钮属性

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

最小/最大

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

空状态

当一个重复器被允许为空，通过将其min属性设置为0并且没有值，你可以使用empty插槽控制在空状态下渲染的内容。

控制

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

自定义控件

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

设置错误

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

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

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

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

Props & Attributes

部分

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