创建新的数据库模板时,有时需要在其中添加特定位置的自定义字段。本指南涵盖了如何在您自己的自定义数据库模板中使用自定义字段,了解如何输入以下示例,以及对每个字段显示类型的简要说明。
为了理解如何在模板中使用自定义字段,重要的是要理解将在模板代码中使用的项。
在创建要在您自己的模板中显示的视图的自定义字段时,在创建这些字段时需要注意以下事项
- 模板的关键-这是在模板中引用字段的方式。在创建字段时,尝试坚持与字段包含的内容相关的命名约定,如果有多个字段,则要与数据库相关。
例如,我可能有'bugs_area_text'这对我的实例来说很清楚,它是bug数据库,显示bug所在区域的字段,它是一个文本字段。在开发模板时,坚持某种约定可能有助于使模板更容易阅读。 - 清单视图格式-这是引用列表视图时使用的格式,将在下面讨论。
- 显示视图格式- 这是引用显示视图时使用的格式,这将在下面讨论。请注意,如果未指定否,则显示是要使用的默认视图。
- 显示- 除了显示视图格式外,还有一个标准符,可以放置在哪里。您可以在模板代码中专门引用这些选项中的每个选项。
创建的任何字段都可以在数据库模板中使用。这可以使用以下代码完成
{$记录- > customFieldDisplayByKey ('your_template_key.”、“viewtype.”)|生的}
这模板键参数将是您在自定义字段的显示标签中的“模板键”字段中输入的内容。
这视图类型参数是用于指定所使用的格式,这取决于您想要显示自定义字段中的显示选项卡中的哪个选项。可以使用的视图类型如下所示
- 清单-这将显示的值,作为任何清单的徽章首选项设置在您的自定义字段。这通常在记录列表中使用。
- 显示/display_top/display_bottom.- 每个这些都显示在自定义字段中设置的任何显示值的值。屏幕上的显示只会显示格式,但是您可以根据在该字段中为显示部分中选择了这些项目中的哪一个显示的显示屏顶部和底部。
- 拇指-返回一个\IPS\File对象数组。仅与图像类型一起返回,其中缩略图创建被选中。
- 上传-返回一个\IPS\File对象数组。仅返回上传字段类型。
- 生的- 这将显示数据库中的存储值,除非有多次上传(作为URL数组返回)或它们是互惠字段类型(作为记录对象数组返回)
- 加工过的-这将显示上面指定的原始值,但是也通过表单助手传递
添加|生的表示该值不会转义。对于某些特定包含url的项目,这可能是可取的。例如返回缩略图或youtube项目。但是,如果使用纯文本等项目,请注意,您是在允许原始的未转义文本添加到页面。
在这个例子中,我创建了一个名为“Sub Title”的字段。首先,我已经建立了我的领域。对于这个项目,我打算给记录添加一个副标题,如下所示。
模板的关键
我很满意预设的显示选项之一,确实选择了下面的一个
显示视图
我现在需要编辑我的记录模板,并在我需要它显示的行中添加。在本例中,就在标题下面
注意,这里使用的语法在末尾包含|raw。这是因为返回的将是我所选择的标准显示格式的HTML,我不希望它被转义。
{$记录- > customFieldDisplayByKey (' sub_title ', '显示')|生}
报告指南