README

字段布局的条件语句现在已成为Craft 4.0的核心功能（于2022年5月发布）！...这意味着你不再需要此插件 :)

Reasons已退役，插件不会更新以兼容Craft 4，尽管我仍会确保它对任何即将推出的Craft 3.x版本保持兼容。

在将你的网站升级到Craft 4之前，请确保记录下你将使用核心功能重新创建的所有条件语句，然后在卸载Reasons和Composer之前。

Craft CMS 3.x的Reasons插件

使用条件语句为字段布局提供动力。

什么是Reasons？

Reasons向Craft CMS的字段布局添加简单的条件语句，使得在编辑内容时可以动态地隐藏或显示字段。

从Craft 2版本的变化

• 支持项目配置
• 与Craft 3.4的新草稿和实时预览系统以及新的资产编辑页面兼容
• 已移除对插件的支持（包括第三方字段类型、Craft Commerce和Solspace Calendar）

要求

此插件需要Craft CMS 3.7.0或更高版本。它不适用于Craft 4.0或更高版本。

在寻找Craft 2版本？

安装

要安装插件，请按照以下说明操作。

1. 打开你的终端并转到你的Craft项目

    cd /path/to/project
   

2. 然后让Composer加载插件

    composer require mmikkel/reasons
   

3. 在控制面板中，转到设置 → 插件，然后点击Reasons的“安装”按钮。

从Craft 2更新

Craft 2版本中数据库中的现有条件语句应自动迁移并继续正常工作。请注意，所有第三方字段类型和插件支持（包括Solspace Calendar和Craft Commerce）已移除。

使用Reasons

要为特定字段创建或编辑条件语句，请编辑相应元素源（例如，条目类型、类别组、全局集或资产卷）的字段布局。在字段布局设计器中点击字段旁边的齿轮图标，然后选择“编辑条件语句”。

请注意，对于支持标签式字段布局的元素源，Reasons被设计为按“标签”进行工作。

什么是“切换字段”？

在原因中，切换字段是一种可以用来“切换”其他字段（在同一字段布局选项卡中）的开或关（显示或隐藏它们）的字段。

以下字段类型可以用作切换字段

• Lightswitch
• 下拉菜单
• 复选框
• 多选
• 单选按钮
• 数字
• 纯文本
• 条目
• 分类
• 标签
• 资产
• 用户

在哪里使用它？

原因适用于条目、全局设置、分类、资产、用户和标签。它还在实时预览、元素编辑对话框以及条目草稿和修订中工作。

关于必填字段的说明

请注意不要将条件添加到必填字段中。即使必填字段被隐藏，Craft也会将其视为必填，这可能会使您的内容无法保存。

关于原因不做什么——或者说一种某种形式的免责声明

重要的是要认识到，原因完全是关于通过隐藏基于其他字段当前值的可能不相关的字段UI来提高创作体验。

原因作为Craft控制面板UI的一层薄层工作，使用JavaScript在编辑内容时显示和隐藏字段。由于该插件依赖于控制面板中未记录的功能、标记、CSS和JavaScript，它基本上是一个大型的漏洞，如果控制面板的某些方面发生变化或重新设计，它可能会随时停止工作。

好消息是，原因对您的任何内容都没有影响，也不会以任何方式影响您的字段或字段布局。它也不会在您站点的任何前端上做任何事情。如果您卸载它，您的字段布局将简单地以原生方式渲染，即所有字段都可见，无论它们的值如何。

我的建议是明智地设计您的字段布局；始终牢记布局可能会有一天不使用条件渲染。谨慎使用原因，如果发现自己创建了很多复杂的条件，考虑替代方法（例如条目类型或矩阵字段）。