正文与内联模型
一个正文字段是富文本,也可以容纳你自己的模型,按任意顺序放在段落之间。它所放置的模型就是内联模型,你只需定义一次,即可作为字段类型重复使用。
模型嵌入流中的富文本
不做任何配置时,正文字段只接受文本:标题、粗体和斜体、链接、列表、引用和代码。在 allowedTypes 中列出可以放置的内容:你的内联模型,以及内置的图像、视频、文件、引用和地理点类型。写入时携带名单之外的任何内容都会被拒绝,错误会指明该条目。
关闭类型化文本后,字段只容纳模型,按你的团队放置的任意顺序堆叠。
读取返回什么
存储的值是一个扁平、有序的条目列表。每个条目是一段文本或一个已放置的模型,带有在编辑后仍保持不变的稳定的键。读取时你会得到类型化条目(用内联片段选取),以及 HTML、Markdown 和 JSON 形式。HTML 和 Markdown 只包含文本,因此要渲染已放置模型的渲染器应读取这些条目。
内联模型
内联模型本身没有记录。它的键会成为一种字段类型,可添加到任何模型,你的团队以结构化表单填写,例如首屏横幅或评价卡片。内联模型可以相互嵌套,放在正文中的内联模型自身也可以有正文字段。给内联模型添加一个字段,它就会出现在嵌入该模型的所有地方。
列表
一个列表字段是有序数组,带有声明的条目类型:内置类型、引用,或内联模型,此时每个条目是该模型的结构化值。列表写入使用 set、push、pull、splice 和 removeWhere。