/

Feldtypen im Überblick

Jedes ->change_type()-Steuerelement, das xCRUD Nova Pro für ein Formularfeld rendern kann - von reinem Text bis zur Live-Kameraaufnahme.

->change_type()

->change_type($field, $type, $length = '', $extra = []) überschreibt, wie ein Feld im Erstellen-/Bearbeiten-Formular gerendert wird (und, bei Typen wie select, wie dessen Wert auch beim Inline-Bearbeiten angezeigt wird). Ohne einen solchen Aufruf wird der Typ eines Feldes aus dessen Datenbank-Spaltentyp abgeleitet.

ParameterTypStandardBeschreibung
$fieldstring-Die zu ändernde Spalte
$typestring-Einer der unten aufgeführten Typen
$lengthstring''Nur bei price relevant: Nachkommastellen (Standard 2). Von jedem anderen Typ ignoriert
$extraarray[]Optionen-Array für select/multiselect/radio/checkboxes/switch, oder ['prefix' => ..., 'suffix' => ...] für price

Die Typenliste

TypBeschreibung
textEinfaches einzeiliges Text-Eingabefeld
textareaMehrzeiliges Klartext-Eingabefeld
editorQuill-Rich-Text-WYSIWYG-Editor, speichert HTML
selectEinwert-Dropdown, aufgebaut aus den Optionen von $extra
multiselectMehrwert-Auswahl, gespeichert als kommaverbundener Wert
radioRadio-Button-Gruppe
checkboxesCheckbox-Gruppe, kommaverbundener Wert wie bei multiselect
switchExpliziter Umschalter - erfordert immer genau 2 Optionen
passwordMaskiertes Text-Eingabefeld (nur optische Maskierung, kein Hash - wird wie jedes andere Textfeld als Klartext gespeichert)
hiddenVerstecktes Eingabefeld, von der Inline-Bearbeitung ausgeschlossen, wird aber weiterhin mit dem Formular übermittelt
timeZeitauswahl (MySQL-TIME-Spalten erhalten dies automatisch)
yearZahlen-Eingabefeld, begrenzt auf MySQLs YEAR-Bereich (1901-2155)
priceDezimal-Eingabefeld mit optionalem Währungspräfix/-suffix
fileDatei-Upload-Feld
imageBild-Upload mit Größenänderungs-/Zuschnitt-/Wasserzeichen-Optionen
videoVideo-Upload-Feld
cameraLive-Kameraaufnahme (Foto), gespeichert wie image

Den vollständigen Optionssatz für file/image/video/camera finden Sie unter Datei- & Bild-Uploads und Medien-, Kamera- & Video-Uploads.

Beispiel: ein Select-Feld

$extra akzeptiert eine einfache Liste (Wert = Label), eine Wert=>Label-Zuordnung oder eine Liste von [Wert, Label]-Paaren:

$xcrud->change_type('status', 'select', '', [
    'a' => 'Active',
    'i' => 'Inactive',
]);

Beispiel: ein Price-Feld

$length legt die Nachkommastellen fest, $extra legt ein Währungspräfix/-suffix fest:

$xcrud->change_type('unitPrice', 'price', '2', ['prefix' => '$']);