对象字段
object字段是一种动态字段类型,它在CMS中创建一个包含其数据的嵌套页面。
这可以用于在CMS中创建重复的数据结构或分组相关数据。
类型定义
有关所有字段类型共有的其他属性,请查看字段类型定义。
将此设置为"object"以使用对象字段。
供内部使用的字段名称。
要在对象中显示的字段。
要在对象中显示的模板。
当list: true时可用。
为模板选择一个不同的引用键。
对象是否应被视为使用定义的fields模式的对象数组。
false.定义如何将新项目添加到列表中。支持的值包括append或prepend。
当list: true时可用
在TinaCMS 2.8.2中添加
append.All properties marked as REQUIRED must be specified for the field to work properly.
fields或templates中只能定义一个。
概念化对象类型
重要的是,有两种关键方式使用对象类型...
- 使用
fields,对象将其内部字段包装在一个子窗口中。 - 使用
templates时,用户可以在关联的模板之间进行选择。
这如上所示,但按下+会让您选择一组选项之一。
可视选择器
这个可视块选择器允许编辑者选择带有图像和文本的模板。
要启用可视块选择器,visualSelector属性必须为true。在编辑器中,这也会打开一个新的模板选择窗口。
要为某个模板获取图像,您需要提供带有模板的ui.previewSrc属性的图像。这是一个URL,或相对于您在TinaCMS配置中定义的公共文件夹。
自定义列表标签
默认情况下,对象列表使用模板label或对象的label + " Item"标记每个元素。
如果列表中有多个对象,可以通过itemProps函数属性为每个元素自定义。
- 如果使用
fields,请在对象上设置此项 - 如果使用
templates,请在每个模板上设置此项
自定义模板标识符
使用模板属性时,您的文档会使用键_template存储每个选择的模板。
您可以使用templatesKey属性自定义此项——给定的键代替。
示例
简单字段
简单字段(模板)
简单包装字段
数字、布尔、日期时间、引用和富文本字段类型可以用作对象的唯一字段,以创建这些类型之一的列表。
嵌套对象字段
此示例同时使用模板和字段。
featureItem对象存储一个对象数组{ headline, description, buttons }。- 列表中的每个功能项都有一个唯一的标签,由itemProps函数设置。
featureBlock数组的buttons元素也是一个对象列表,有3个选项可供选择(模板)。
带默认值的字段
当向列表中添加新项目时,它将使用这些defaultItem值创建。
带自定义引用键的字段
在此处设置templateKey会将我们的保存数据更改为如下所示,其中定义模板的键已设置为"type"。