eminos/statamic-field-item-relationship

一个Statamic插件,用于添加字段项关系字段类型。

v1.3.0 2024-05-09 16:36 UTC

This package is auto-updated.

Last update: 2024-09-09 17:17:51 UTC


README

一个Statamic插件,用于添加字段项关系字段类型。
使用字段项关系,您可以从源字段的项中选择一个值。该源字段可以是兄弟字段或祖先字段(在同一蓝图内),或来自全局集合。

安装

使用composer安装此插件。

composer require eminos/statamic-field-item-relationship

功能

  • 源字段可以是兄弟字段或祖先字段,或来自全局集合。
  • 设置应使用哪个键/字段作为选择选项标签。
  • 使用字符串字面量进行高级选项标签配置(见截图#4
  • 选择您要保存为所选项的内容。
    • 键/索引
    • 指定的对象键
    • 完整项/对象
  • 附带一个{{ fir }}标签,帮助您从配置的源字段获取所选源字段项。

字段配置

字段配置将取决于源字段的数据类型。
根据源数据是简单的字符串数组、对象数组还是单个对象,将可能存在不同的“保存为”选项。

如果字段配置与源字段数据不兼容,将在字段中显示警告消息。

标签使用

此操作从“field_item_relationship_field”字段中配置的源字段获取源值。

{{ fir:field_item_relationship_field }}

如果源值是对象,您可以通过这种方式获取其值。

{{ fir:field_item_relationship_field }}
    {{ text_field_1 }}
    {{ some_other_field }}
{{ /fir:field_item_relationship_field }}

或通过在标签中指定目标字段,如下所示

{{ fir:field_item_relationship_field:text_field_1 }}

甚至嵌套字段也有效,如下所示

{{ fir:field_item_relationship_field:some_field.child_field }}

您还可以获取全局字段

{{ fir:global_set:field_item_relationship_field:nested.target.path }}

另一种方法是使用字段和路径参数

{{ fir field="global_set:field_item_relationship_field" path="some_field.child_field" }}

截图

一些不同的示例。 不同源字段类型的截图

一个真实世界的示例,其中源字段位于全局集合中。 使用全局集合字段作为源字段的字段项关系字段的截图

字段配置选项。 字段配置的截图

高级选项标签配置。 具有高级选项标签配置的字段项关系字段的截图

可能的改进

  • 多选
  • 更多选择字段类型选项(除了选择字段类型之外)

许可证

MIT许可证(MIT)。有关更多信息,请参阅许可证文件