Mediendatei (file)

{
    "hideId": true,
    "fields": {
        "title": {
            "cms": {
                "column": true
            },
            "empty": false,
            "type": "string"
        },
        "image": {
            "cms": {
                "column": true
            },
            "type": "file"
        }
    }
}

Ein Dateifeld kann einen beliebigen Dateiinhalt aufnehmen. Wird es in der Liste als Spalte eingeblendet, lässt sich der Inhalt direkt über einen Link abrufen.

Im Formular ist das nur möglich, solange das Feld auf eine bereits im CMS gespeicherte Datei verweist.

Eine neue Datei wählt man über die Schaltfläche mit dem Namen der bisherigen Datei. Das Symbol daneben zeigt die gespeicherte Datei in einem neuen Fenster bzw. Tab an.

Vorschaubilder

Mit dem Parameter thumbnail erzeugt das CMS beim Speichern einer Bilddatei automatisch ein Vorschaubild, z. B. "thumbnail": "192x108" (Breite x Höhe in Pixeln). Vorschaubilder entstehen nur beim Speichern einer Datei. Für bereits vorhandene Dateien werden sie nachträglich nicht erzeugt.

{
    "fields": {
        "image": {
            "type": "file",
            "mime": ["image/jpeg", "image/png"],
            "thumbnail": "256x256"
        }
    }
}

Vorschaubild aus einem Video

Ist thumbnail gesetzt, kann in der Pflegeanwendung auch für ein Video ein Vorschaubild gewählt werden. Die Schaltfläche neben der Datei öffnet einen Dialog, in dem man eine Stelle im Video und einen Ausschnitt wählt. Der Ausschnitt muss nicht quadratisch sein.

Parameter

Mediendateien sind ein CMS-eigener Typ ohne Entsprechung im fastest-validator.

Parameter	Bedeutung
optional	Feld darf fehlen (Voreinstellung false)
localizable	eigene Datei je Sprache
thumbnail	Größe des Vorschaubilds als <Breite>x<Höhe> in Pixeln, z. B. 192x108. Wird nur für Bilder automatisch erzeugt und nur, wenn beim Einspielen nicht ausdrücklich ein Vorschaubild mitgeliefert wird.
aspects	Liste erlaubter Seitenverhältnisse der Form <Zahl>:<Zahl>, z. B. 16:9. Nur Bilder mit einem dieser Seitenverhältnisse werden angenommen.
mime	Liste erlaubter MIME-Typen. Geprüft wird auf exakte Übereinstimmung, image allein ist also nicht zulässig, nur z. B. image/png.
max	maximale Dateigröße in Bytes

Darstellung in der Schnittstelle

/** Wert eines Dateifelds. */
interface IFile {
    /** MIME-Typ des Inhalts, sofern bekannt. */
    mime?: string
    /** Dateiname, wie er angezeigt wird. */
    name: string
    /** Verweis auf den Dateiinhalt (beim Abruf) bzw. Name des Formularwerts (beim Einspielen). */
    path: string
    /** Größe in Bytes, sofern bekannt. */
    size?: number
    /** Automatisch erzeugtes oder mitgeliefertes Vorschaubild. */
    thumbnail?: Omit<IFile, 'thumbnail'>
}

mime und size ermittelt das CMS beim Einspielen im Allgemeinen selbst. Ist ein Vorschaubild vorhanden, zeigt die Pflegeanwendung es im Formular an.

Wie Dateien eingespielt und abgerufen werden, beschreibt die Datenschnittstelle.