集合是许多Gantry 5粒子(Particle)的重要组成部分。它们基本上是项目或子项目。例如，在社交粒子(Particle)中，一个集合用于组织粒子(Particle)中的不同社交链接。这使您可以轻松创建或删除特定的社交项目，按照您的喜好重新排序它们，并将它们与影响整个粒子(Particle)的主要设置（如粒子(Particle)的主标题，副标题等）分开。

在管理器中使用集合 

集合在Gantry管理器中进行配置。如果您要在现有粒子(Particle)中配置集合，或者您已经在YAML文件中为custom/customized粒子(Particle)设置了集合的选项，则应该看到类似于下面所示的粒子(Particle)设置的内容。

此示例是Hydrogen主题中配置的默认社交粒子。您会注意到有顶级字段，包括影响整个粒子的CSS类，标题和目标。但是，您还会注意到设置的“ 社交项目”区域，其中包含将显示在前端的不同特定项目。

这些子项目包含的选项使您可以配置它们并为它们提供独特的设置。您可以使用加号+图标将新项目添加到集合，并使用编辑所有项目按钮在一个弹出窗口中将它们全部编辑。

如果将光标悬停在特定项目上，则可以访问“ 删除”，“ 复制 ”和“ 更改名称”选项。这些使您可以移除特定项目，复制它并将复制项目用作新项目的基础，并且可以在前端显示项目名称（取决于粒子的配置方式）或用于帮助您以更好地组织后端项目。

点击该项目的名称将打开一个包含该项目设置的新弹出窗口。这些设置将改变特定项目的显示方式，其中包含的内容以及您希望配置的任何选项。

选择编辑所有项目选项会一次打开包含所有项目及其设置的弹出窗口。对于一次配置多个项目并希望节省时间的人员来说，这是一款出色的工具。

在YAML中配置集合

为了在一个粒子中启用一个集合，它需要首先在粒子(Particle)的YAML文件中设置。

一般来说，要创建一个集合，你需要声明一个 collection.list项目类型，label该项目，并设置将显示您的集合中的每个项目的字段。

这里是一个集合如何在YAML文件中看到的例子。这个例子是默认的社会分享粒子(Particle)，它在上面的部分被成像，所以你可以看到在这里建立的YAML字段是如何出现在后端的。

items:
  type: collection.list
  array: true
  label: Social Items
  description: Create each social item to display.
  value: name
  ajax: true

  fields:

    .name:
      type: input.text
      label: Name
      skip: true

    .icon:
      type: input.icon
      label: Icon

    .text:
      type: input.text
      label: Text

    .link:
      type: input.text
      label: Link

这里是yaml项目的分解以及它们对粒子(Particle)的意义。

这里另一个重要的注意事项是你想要的任何字段都在里面 fields部分集合需要以句点（.）开始。因此，而不是调用领域test这将是.test。