组件字段参考

组件字段参考

本参考涵盖在定义 FaceFlow 组件时可用的字段类型。

当您需要决定某个部分应向编辑器暴露哪种输入类型，以及如何以安全且可预测的方式呈现该输入时，请参阅本节。

顶级字段类型

仅用于重复器的子字段类型

这些字段类型旨在用于 repeater 行内部，而不是作为通用的顶级区块字段。

字段选择规则

按您想要保留的内容契约选择字段类型：

对短字符串使用 text
对多行纯文本内容使用 textarea
对应保持数值类型的数值使用 number
对链接和目标使用 url
对发布、事件或时间线日期使用 date
对受管媒体使用 image 或 images
对可下载资源使用 file
对受控选项使用 select 或 checkbox
对编辑类格式化内容使用 richtext
仅对受控的高级标记使用 htmlcode
对结构化位置数据使用 map
对结构化重复行使用 repeater
对受管嵌入使用 formSelect 和 reviewSelect

快速决策指南

one short string            -> text
one multi-line plain block  -> textarea
formatted editorial content -> richtext
repeatable cards or FAQs    -> repeater
embed a managed Form        -> formSelect
embed a managed Review      -> reviewSelect
advanced custom markup      -> htmlcode

Schema 示例

[
  { "name": "title", "label": "Title", "type": "text" },
  { "name": "summary", "label": "Summary", "type": "textarea" },
  { "name": "heroImage", "label": "Hero Image", "type": "image" },
  { "name": "ctaUrl", "label": "CTA URL", "type": "url" }
]

相关