Prose e modelos inline
Um campo prose é rich text que também pode conter seus próprios modelos, colocados entre os parágrafos em qualquer ordem. Os modelos colocados assim são modelos inline, que você define uma vez e reutiliza como tipos de campo.
Rich text com modelos no fluxo
Sem configuração, um campo prose aceita apenas texto: títulos, negrito e itálico, links, listas, citações e código. Liste o que pode ser colocado em allowedTypes: seus modelos inline e os tipos nativos image, video, file, reference e geopoint. Uma gravação que traga qualquer coisa fora da lista é recusada, e o erro indica a entrada.
Desative o texto digitado e o campo passa a conter apenas modelos, empilhados na ordem que sua equipe definir.
O que uma leitura retorna
O valor armazenado é uma lista plana e ordenada de entradas. Cada entrada é um trecho de texto ou um modelo colocado, com uma chave estável que sobrevive à edição. Uma leitura entrega as entradas tipadas, selecionadas com inline fragments, junto com as formas em HTML, Markdown e JSON. O HTML e o Markdown carregam apenas o texto, então um renderizador que exibe modelos colocados lê as entradas.
Modelos inline
Um modelo inline não tem registros próprios. Sua chave vira um tipo de campo que você pode adicionar a qualquer modelo, e sua equipe o preenche como um formulário estruturado, como um hero banner ou um cartão de depoimento. Modelos inline se aninham uns nos outros, e um colocado em prose pode ter um campo prose próprio. Adicione um campo a um modelo inline e ele aparece em todo lugar em que esse modelo está incorporado.
Listas
Um campo list é um array ordenado com um tipo de item declarado: um tipo nativo, uma referência ou um modelo inline, caso em que cada item é um valor estruturado desse modelo. As gravações em listas usam set, push, pull, splice e removeWhere.
Tradução e variantes
Prose é traduzível. Uma variante pode substituir uma única entrada de prose ou um único item de lista, então um parágrafo muda para um público sem que o documento seja duplicado.
Leia os detalhes
A referência de tipos de campo cobre o campo prose, o que ele aceita e o que uma leitura retorna, e os modelos inline têm um guia próprio.