Alle Feldtypen
Alle 33 Elementtypen mit Optionen und Attributen.
Alle Elementtypen
Dreiunddreißig Typen in drei Arten. Die Spalte "Angaben" nennt, was der Editor am Element anbietet, die Spalte "Optionen" das, was unter "Optionen" dazukommt.
Eingabeelemente 23
Nur diese werden geprüft und gespeichert.
| Typ | Wofür | Angaben | Optionen |
|---|---|---|---|
| Einzeiliger Text (text) text |
Ein einzeiliges Eingabefeld für kurze Texte. Zeichenlimits und eine optionale Vorauswahl können unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minLength maxLength |
| Mehrzeiliger Text (textarea) textarea |
Ein mehrzeiliges Eingabefeld für längere Texte. Sichtbare Höhe, Zeichenlimits und eine optionale Vorauswahl können unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | rows minLength maxLength |
| Dropdown Menü (select) select |
Ein Dropdown mit frei definierbaren Optionen. Optionen und eine optionale Standardauswahl werden unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Platzhalter, Optionsliste | — |
| Ankreuzfeld (checkbox) checkbox |
Ein einzelnes Ankreuzfeld für Ja/Nein-Angaben. Eine optionale Vorauswahl kann unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld | defaultChecked |
| Datum (date) date |
Ein Datumsfeld auf Basis des Browser-Standards. Optionaler Datumsbereich und Vorauswahl werden unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minDate maxDate |
| Uhrzeit (time) time |
Ein Uhrzeitfeld auf Basis des Browser-Standards. Optionaler Zeitbereich und Schrittweite werden unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minTime maxTime step |
| Datum + Uhrzeit (datetime-local) datetime-local |
Ein Feld für Datum und Uhrzeit auf Basis des Browser-Standards. Ein optionaler Zeitraum wird unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minDateTime maxDateTime |
| Zahl (number) number |
Ein Zahlenfeld. Minimum, Maximum, Schrittweite und eine optionale Vorauswahl können unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | min max step |
| Schieberegler (range) range |
Ein Schieberegler für Zahlenwerte. Minimum, Maximum, Schrittweite und Standardwert werden unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Vorauswahl | min max step defaultValue |
| Telefonnummer (tel) phone |
Ein Eingabefeld für Telefonnummern. Zeichenlimits und eine optionale Vorauswahl können unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minLength maxLength |
| Farbauswahl (color) color |
Eine Farbauswahl auf Basis des Browser-Standards. Eine optionale Standardfarbe wird unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Vorauswahl | defaultValue |
| URL (url) url |
Ein Eingabefeld für URLs. Zeichenlimits und eine optionale Vorauswahl können unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minLength maxLength |
| E-Mail-Adresse (email) |
Ein Eingabefeld für eine einzelne E-Mail-Adresse. Zeichenlimits und eine optionale Vorauswahl können unter "Optionen" gepflegt werden. | Beschriftung, Pflichtfeld, Platzhalter, Vorauswahl | minLength maxLength |
| Einzelauswahl (radio) radio |
Eine Einzelauswahl mit mehreren sichtbaren Optionen. Optionen und eine optionale Standardauswahl werden unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Optionsliste | — |
| Mehrfachauswahl (checkboxes) checkbox-group |
Eine Mehrfachauswahl mit mehreren sichtbaren Optionen. Optionen, Standardauswahlen und Auswahl-Limits werden unter "Optionen" gepflegt. | Beschriftung, Pflichtfeld, Optionsliste | minSelections maxSelections |
| Bild Upload (file) image |
Ein Upload-Feld für Bilder. Erlaubte Dateiendungen und maximale Dateigröße können unter "Optionen" eingeschränkt werden. | Beschriftung, Pflichtfeld | allowedExtensions maxFileSize |
| Datei Upload (file) file |
Ein Upload-Feld für Dateien. Die Datei wird in den Medien gespeichert; erlaubte Endungen und maximale Dateigröße können unter "Optionen" eingeschränkt werden. | Beschriftung, Pflichtfeld | allowedExtensions maxFileSize |
| Verstecktes Feld (hidden) hidden |
Ein verstecktes Feld, das in der Storefront nicht sichtbar ist. Der mitgesendete Wert wird unter "Optionen" gepflegt. | Beschriftung | value |
| Land-Auswahl country |
Eine Länderauswahl auf Basis der im Verkaufskanal verfügbaren Shopware-Länder. | Beschriftung, Pflichtfeld, Platzhalter | — |
| Zustimmung / Einwilligung consent |
Ein Ankreuzfeld für Zustimmungen, z. B. Datenschutz, AGB oder Einwilligungen. Fachlich klarer als eine normale Checkbox benannt. | Beschriftung, Pflichtfeld | — |
| Anrede salutation |
Die Shopware-Anredeauswahl als Dropdown. | — | — |
| Vorname + Nachname firstname-lastname |
Zwei Shopware-Standardfelder für Vorname und Nachname, nebeneinander dargestellt. | Pflichtfeld | — |
| E-Mail-Adresse + Telefonnummer email-phone |
Zwei Shopware-Standardfelder für E-Mail-Adresse und Telefonnummer, nebeneinander dargestellt. | Pflichtfeld | — |
Inhaltselemente 8
Sie geben aus und fragen nichts ab.
| Typ | Wofür | Angaben | Optionen |
|---|---|---|---|
| Überschrift title |
Eine Überschrift zur Strukturierung des Formulars. Der sichtbare Text wird über die Beschriftung gepflegt. | Beschriftung | — |
| Vertikale Linie separator |
Eine Trennlinie zur optischen Gliederung des Formulars. Es sind keine weiteren Angaben nötig. | — | — |
| Zeilenumbruch line-break |
Ein Zeilenumbruch zur optischen Gliederung des Formulars. Es sind keine weiteren Angaben nötig. | — | — |
| Freitext content |
Ein frei definierbarer Textbereich mit HTML-Unterstützung. Der sichtbare Inhalt wird unter "Optionen" gepflegt. | Inhalt | — |
| Erfolgs-Meldung (grün) alert-success |
Eine grüne Erfolgsmeldung im Shopware-Stil. Der sichtbare Text wird unter "Optionen" gepflegt. | Inhalt | — |
| Hinweis-Meldung (blau) alert-info |
Eine blaue Hinweismeldung im Shopware-Stil. Der sichtbare Text wird unter "Optionen" gepflegt. | Inhalt | — |
| Warnungs-Meldung (gelb) alert-warning |
Eine gelbe Warnmeldung im Shopware-Stil. Der sichtbare Text wird unter "Optionen" gepflegt. | Inhalt | — |
| Fehler-Meldung (rot) alert-danger |
Eine rote Fehlermeldung im Shopware-Stil. Der sichtbare Text wird unter "Optionen" gepflegt. | Inhalt | — |
Strukturelemente 2
Sie ordnen, sie nehmen nichts entgegen.
| Typ | Wofür | Angaben | Optionen |
|---|---|---|---|
| Gruppe group |
Ein Abschnitt für zusammengehörige Formularbereiche. Gruppen strukturieren große Formulare und können Zeilen sowie Felder enthalten. | Beschriftung | — |
| Zeile row |
Eine Layout-Zeile. Felder innerhalb der Zeile können mit Breiten wie 1/2, 1/3 oder 1/4 nebeneinander dargestellt werden. | — | — |
Was aus den Optionen wird
Im Quelltext der Storefront-Templates nachgelesen.
| Option | Im Formular | Wer prüft |
|---|---|---|
minLength / maxLength | minlength maxlength | Browser und Server |
min / max / step | min max step | Browser und Server |
rows | rows | nur Darstellung |
minDate / maxDate | min max | Browser und Server |
minTime / maxTime | min max | Browser und Server |
minDateTime / maxDateTime | min max | Browser und Server |
allowedExtensions | accept | Browser und Server |
maxFileSize | data-max-file-size | nur der Server |
minSelections / maxSelections | — | nur der Server |
defaultValue / defaultChecked | value bzw. checked | keine Prüfung, nur Vorbelegung |
value | value am versteckten Feld | nur der Server |
Uploads im Einzelnen
Drei Grenzen liegen übereinander, und die äußerste ist keine des Plugins.
- 01 Der Shop Ganz außen steht die Liste erlaubter Dateiendungen von Shopware selbst. Was dort fehlt, geht nirgends durch.
- 02 Das Feld Die Option am Feld grenzt weiter ein. Ohne Angabe gilt eine lange Standardliste, nicht "alles".
- 03 Beim Bild-Upload Zusätzlich nur jpg, jpeg, png, gif, webp und avif - und die Datei muss wirklich ein Bild sein, nicht nur so heißen.
- 04 Die Größe Die Obergrenze steht in Megabyte und wird auf dem Server geprüft. Im Formular steht sie nur als Datenattribut - der Browser hält sie nicht von sich aus ein.
Die hochgeladene Datei liegt danach im Medien-Manager, in dem Ordner, der in der Konfiguration steht. In der Einsendung steht der Verweis darauf, nicht die Datei.
Die Kapitel
Bedingungen
Die 12 Operatoren und was sie vergleichen.
Einbindung
Ausgabepunkte, Zuordnungen, Rangfolge.
Einstellungen
Die sieben Einstellungen mit Standardwerten.
Begriffe
Was die Wörter bedeuten.