HTML-Inhalt (html)

{
    "fields": {
        "title": {
            "cms": {
                "column": true,
                "label": "Überschrift"
            },
            "empty": false,
            "type": "string"
        },
        "plain": {
            "cms": {
                "label": "TEXT"
            },
            "inputRows": 6,
            "optional": true,
            "type": "string"
        },
        "html": {
            "cms": {
                "label": "DraftJS"
            },
            "optional": true,
            "type": "html"
        }
    },
    "hideId": true
}

Der Datentyp html ist vor allem für die Eingabe mit einem WYSIWYG-Editor in der Pflegeanwendung gedacht. Gespeichert wird eine in eine Zeichenkette gewandelte (JSON.stringify) Beschreibung im Format von draft-js. Über die Datenschnittstelle sind solche Werte deshalb deutlich aufwendiger zu befüllen.

Das Beispiel bietet daher zwei Varianten für HTML-Inhalte an:

• plain (angezeigt als TEXT) ist eine einfache Zeichenkette, durch inputRows als mehrzeiliges Feld dargestellt. Sie lässt sich über die Datenschnittstelle direkt befüllen.
• html (angezeigt als DraftJS) bietet eine komfortable und sichere Eingabe für formatierten Text. Die interne Darstellung ist ideal für die Pflege in der Pflegeanwendung.

Welche Variante passt, hängt vom Einsatz ab: Werden umfangreiche Texte in der Pflegeanwendung gepflegt, ist html vorzuziehen. Werden Datensätze vor allem über die Datenschnittstelle eingespielt, ist eine einfache Zeichenkette (string) oft sinnvoller.

Formatierungsmöglichkeiten

Ohne weitere Einstellung erlauben html-Felder keine Farben und keine Schriftgrößen. Gelangen sie trotzdem in den Inhalt, werden sie beim Abruf durch Anwendungen entfernt. Freigeschaltet werden sie über den Parameter features, eine Liste, in der jeder Wert höchstens einmal vorkommt:

Wert	Wirkung
fontSize	Schriftgröße einstellbar
colorPicker	Text- und Hintergrundfarbe wählbar (beide nur gemeinsam)

{
    "fields": {
        "text": {
            "type": "html",
            "features": ["fontSize", "colorPicker"]
        }
    }
}

Abruf als HTML

Beim Abruf eines Datensatzes (GET oder POST query) liefert der Parameter ?exported jedes HTML-Feld als Zeichenkette mit fertigem HTML, das z. B. direkt im Browser angezeigt werden kann. Bearbeiten lässt sich ein so abgerufener Datensatz nicht. Siehe Datenschnittstelle.

Parameter

Parameter	Bedeutung
optional	Feld darf fehlen (Voreinstellung false)
localizable	Wert je Sprache
features	zusätzliche Formatierungen, siehe oben