Prosa und Inline-Modelle
Ein Feld vom Typ Prosa ist Rich Text, der auch Ihre eigenen Modelle aufnehmen kann, in beliebiger Reihenfolge zwischen den Absätzen platziert. Die Modelle, die es platziert, sind Inline-Modelle, die Sie einmal definieren und als Feldtypen wiederverwenden.
Rich Text mit Modellen im Fluss
Ohne Konfiguration nimmt ein Prosa-Feld nur Text auf: Überschriften, Fett und Kursiv, Links, Listen, Zitate und Code. Die Liste dessen, was platziert werden darf, steht in allowedTypes: Ihre Inline-Modelle sowie die integrierten Typen Bild, Video, Datei, Referenz und Geopunkt. Ein Schreibzugriff mit etwas außerhalb der Liste wird abgelehnt, und der Fehler nennt den Eintrag.
Schalten Sie getippten Text ab, und das Feld enthält nur Modelle, gestapelt in der Reihenfolge, die Ihr Team festlegt.
Was ein Lesezugriff zurückgibt
Der gespeicherte Wert ist eine flache, geordnete Liste von Einträgen. Jeder Eintrag ist ein Textabschnitt oder ein platziertes Modell, mit einem stabilen Schlüssel, der das Bearbeiten übersteht. Ein Lesezugriff liefert die typisierten Einträge, ausgewählt mit Inline-Fragmenten, sowie HTML-, Markdown- und JSON-Formen. HTML und Markdown enthalten nur den Text, ein Renderer, der platzierte Modelle darstellt, liest also die Einträge.
Inline-Modelle
Ein Inline-Modell hat keine eigenen Datensätze. Sein Schlüssel wird zu einem Feldtyp, den Sie jedem Modell hinzufügen können, und Ihr Team füllt ihn als strukturiertes Formular aus, etwa ein Hero-Banner oder eine Testimonial-Karte. Inline-Modelle lassen sich ineinander verschachteln, und eines, das in Prosa platziert ist, kann ein eigenes Prosa-Feld haben. Fügen Sie einem Inline-Modell ein Feld hinzu, erscheint es überall, wo dieses Modell eingebettet ist.
Listen
Ein Feld vom Typ Liste ist ein geordnetes Array mit einem deklarierten Elementtyp: ein integrierter Typ, eine Referenz oder ein Inline-Modell, in welchem Fall jedes Element ein strukturierter Wert dieses Modells ist. Schreibzugriffe auf Listen verwenden set, push, pull, splice und removeWhere.
Übersetzung und Varianten
Prosa ist übersetzbar. Eine Variante kann einen einzelnen Prosa-Eintrag oder ein einzelnes Listenelement ersetzen, sodass sich ein Absatz für eine Zielgruppe ändert, ohne dass das Dokument dupliziert wird.
Details nachlesen
Die Referenz der Feldtypen behandelt das Prosa-Feld, was es akzeptiert und was ein Lesezugriff zurückgibt, und für Inline-Modelle gibt es einen eigenen Leitfaden.