tibi-docs/docs/md/projektkonfig/collections/fields/widgets.md

42 lines
2.2 KiB
Markdown
Raw Normal View History

2022-11-19 14:51:34 +01:00
# Widgets
2023-05-30 17:41:54 +02:00
Das im _tibi-admin_ für die Ein- und Ausgabe von Daten zu verwendente Widget wird über die Feldkonfiguration `meta.widget` festgelegt. Die Angabe erfolgt als String mit dem Widget-Namen.
2022-11-19 14:51:34 +01:00
Nicht jedes Widget kann mit jedem Datentyp umgehen, die möglichen Datentypen werden aber nachfolgend bei jedem Widget erwähnt. Außerdem wird auf individuelle Konfigurationsmöglichkeiten eingegangen.
2023-05-30 17:41:54 +02:00
## string / text / input
2022-11-19 14:51:34 +01:00
2023-05-30 17:41:54 +02:00
## number / int / integer / float / double
2022-11-19 14:51:34 +01:00
2023-05-30 17:41:54 +02:00
## boolean / bool / check / switch / checkbox
2022-11-19 14:51:34 +01:00
2023-05-30 17:41:54 +02:00
## select / selectArray
2022-11-19 14:51:34 +01:00
2023-05-31 17:51:36 +02:00
Diese beiden sind eigentlich auch einfach nur unterschiedliche Namen für dasselbe widget, da intern die differenzierung zwischen <select multiple> und einfach nur <select> anhand davon getroffen wird, ob im Datentyp ein "[]" am Ende ist oder nicht. Vorgesehen ist aber natürlich selectArray für string array Datentypen und select für einen normalen String. Es sind (aktuell) nur Strings möglich, da <option> alle values in einen string konvertiert, anpassungen sind hier aber bei bedarf möglich. Anzumerken ist, dass das name attribut das visuell dargestellte ist, wobei die id der abgespeicherte Wert ist. Wird choices als objekt angegeben, so wird die request and den spezifizierten endpoint geschickt und letzten endes das name attribut von ihm angezeigt. Die id der ausgewählten elemente wird intern als String abgespeichert.
2023-05-30 17:41:54 +02:00
## date / dateTime
2022-11-19 14:51:34 +01:00
2023-05-31 17:51:36 +02:00
Können für type "date" verwendet werden. date erstellt ein <input type="date"> widget (nur das Datum). dateTime erstellt ein <input type="datetime-local"> widget (datum + uhrzeit).
## richtext / html
Unterschiedliche bezeichnungen für ein und dasselbe widget. Dieses wird für den Datentyp string verwendet und repräsentiert ein Textarea feld mit mehreren bearbeitungsmöglichkeiten (ähnl wie World), wobei der Input als HTML in einen String geladen wird. Das html kann man durch die Checkbox "source" auch manuell anpassen.
2022-11-19 14:51:34 +01:00
2023-05-30 17:41:54 +02:00
## file / image / mediaLibraryFile
2022-11-19 14:51:34 +01:00
2023-05-31 17:51:36 +02:00
Dies sind unterschiedliche Beziechnungen für das selbe widget <input type=file>. Wird für den Datentyp file verwendet.
2022-11-19 14:51:34 +01:00
## checkboxArray
## chipArray
## object
2023-05-30 17:41:54 +02:00
## objectArray / object[]
2022-11-19 14:51:34 +01:00
## tabs
2022-11-21 10:33:21 +01:00
## contentbuilder
siehe: [ContentBuilder](./widgets/contentbuilder.md)