Formularelemente

← Erweiterung/Forms

no subpages

Formularelemente

Folgende Formularfelder können zu einem Formular hinzugefügt werden:

Eingabefelder

Feld	Eingabetyp	Funktion
Buch	book	Auto-Vervollständigungsfeld zum Finden von Seiten im Namensraum „Book“
Text	text	Standard-Textfeld
Textbereich	textarea	Mehrzeiliges Textfeld
Wikitext-Eingabe	wikitext	Mehrzeiliges Textfeld für Wikitext-Syntax
Kategorie-Multiauswahl	category_multiselect	Token-Feld zum Hinzufügen einer oder mehrerer Kategorien zur Seite; Werte werden mit der Eingabetaste getrennt
Kontrollkästchen	checkbox	Einzelnes Kontrollkästchen
Menü-Tag-Multiauswahl	menutag_multiselect	Mehrfachwert-Eingabe; Werte werden mit der Eingabetaste getrennt
Kontrollkästchen-Multiauswahl	checkbox_multiselect	Gruppe von Kontrollkästchen (ermöglicht die Auswahl mehrerer Werte)
Dropdown	dropdown	Dropdown-Liste mit vordefinierten Optionen
Zahl	number	Ganzzahlfeld
Optionsfeld	radio	Einzelnes Optionsfeld (wird in manuell ausgefüllten Formularen normalerweise nicht verwendet)
Optionsfeldgruppe	radio_multiselect	Gruppe von Optionsfeldern (ermöglicht die Auswahl genau eines Wertes)
Dateiauswahl	select_file	Wählt eine Datei im Wiki aus
Titel-Eingabe	title	Auto-Vervollständigungsfeld für Wiki-Seiten
Kombinationsfeld	combobox	Kombiniert ein Textfeld und eine Dropdown-Liste. Benutzer können einen vordefinierten Wert auswählen oder einen eigenen Wert eingeben.
Passwort-Eingabe	password	Erstellt ein Passwortfeld mit Passwort- und Passwort-Wiederholungsfeld. Wird für die Zieltypen JSON on wikipage, Template oder Email nicht verwendet, da das Passwort im Klartext gespeichert wird.
Tag-Eingabe	tag	Token-Feld zum Hinzufügen mehrerer Werte; Werte werden mit der Eingabetaste getrennt
Datum	date	Entspricht Date Picker
Titel-Eingabe	title	Wählt Seitentitel im Wiki aus
Benutzer-Eingabe	user_picker	Im Wiki vorhandener Benutzername
Gruppen-Eingabe	group_picker	Im Wiki vorhandener Gruppenname
Gruppen-Multiauswahl	group_multiselect	Mehrere Gruppennamen
Benutzer-Multiauswahl	user_multiselect	Mehrere Benutzernamen
Titel-Multiauswahl	title_multiselect	Mehrere Seitentitel
Date Picker	date_picker	Kalender-Widget
Prozent	percent	Ganzzahliger Wert

Weitere Elemente

Element	Eingabetyp	Beschreibung
Statischer Wikitext	static_wikitext	Nicht bearbeitbarer Text
Schaltfläche	button	Löst eine Aktion aus (erfordert einen definierten Event-Listener)
Meldungsbanner	message	Meldung, die an beliebiger Stelle im Formular angezeigt werden kann; der gewählte Typ (Hinweis, Fehler, Warnung, Erfolg) bestimmt die visuelle Darstellung
Teilformular-Import	form_input	Fügt Formularfelder aus einem anderen Formular hinzu
Symbol	icon	-
Indikator	indicator	-
Beschriftung	label	-
Fortschrittsbalken	progress_bar	Visuelle Darstellung der Anzahl abgeschlossener Schritte in einem Formular, beispielsweise einer Checkliste
Abschnittsüberschrift	section_label	Überschrift eines Formularabschnitts
Horizontale Linie	hr	Visuelle Trennlinie

Optionen für Eingabefelder

Jedes Eingabefeld kann eine beliebige Kombination der folgenden Optionen besitzen:

Allgemein

Typ	Feld	Funktion
(alle)	Name	In der Datenbank gespeicherter Feldname (Sonderzeichen vermeiden)
	Beschriftung	Dem Benutzer angezeigte Feldbezeichnung
	Hilfe	Erstellt einen Tooltip neben der Beschriftung
	Kein Layout	Blendet die Beschriftung aus
	Anzeigen bei	Modus, in dem dieses Feld sichtbar ist
	Bearbeitbar bei	Legt fest, wann der Feldwert bearbeitet werden kann
Buch	Rückgabe-Eigenschaft	?

Darstellung

Typ	Feld	Funktion
(alle)	CSS-Klassen	Fügt individuelle CSS-Klassen zur Verwendung in MediaWiki:Common.css hinzu. Die Klasse wird direkt auf das Formularfeld angewendet und umfasst nicht die Beschriftung. Mehrere Klassen können gemeinsam oder einzeln angegeben werden.
	Stil	Definiert einen Inline-Stil, der nur dieses Feld betrifft. Der Stil wird auf den Wrapper angewendet und umfasst sowohl die Beschriftung als auch das Feld.
Textbereich, Wikitext-Eingabe	Anzahl Zeilen	Wird für Textbereiche verwendet
	Platzhalter	Text, der angezeigt wird, bevor der Benutzer einen Wert eingibt (hat keine Wirkung, wenn bereits ein Standardwert definiert ist)
Optionsfeldgruppe	Kein Standardwert	Stellt sicher, dass kein Optionsfeld vorausgewählt ist, wenn eine Vorauswahl nicht sinnvoll wäre
Optionsfeldgruppe, Kontrollkästchen-Multiauswahl	Horizontales Layout	Ordnet Kontrollkästchen oder Optionsfelder horizontal an
Schaltfläche	Symbol	Zeigt ein Symbol vor dem Text an (z. B. ein Bootstrap-Icon wie bi bi-calendar)
	Indikator	Zeigt ein Symbol nach dem Text an (z. B. ein Bootstrap-Icon wie bi bi-arrow-right)
	Mit Rahmen	Wenn deaktiviert, wird die Schaltfläche wie normaler Text dargestellt (und kann über CSS-Klassen wie btn button-warning gestaltet werden)

Weitere Optionen

Typ	Feldgruppe	Feld	Funktion
(alle)	Benutzerdefinierte Widget-Eigenschaften	Schlüssel
		Wert
	Listener	Ereignis	Von OO.ui-Widgets unterstütztes Ereignis, z. B. change, enter, focus, blur
		Callback	Funktion, die beim Auftreten des Ereignisses aufgerufen wird (kann beispielsweise in MediaWiki:Common.js definiert werden)
		Standardwert / Vorausgewählt	Wert, der verwendet wird, wenn der Benutzer keinen Wert angibt; beim Feldtyp checkbox lautet die Option stattdessen Vorausgewählt
		Pflichtfeld	Das Formular kann ohne einen Wert in diesem Feld nicht abgesendet werden
Passwort		Passwortstärke	schwach: mittel: stark:
Tag		Eingabeposition	inline: outline:
		Beliebige Werte zulassen	Erlaubt die Eingabe anderer Werte als der definierten zulässigen Werte (nur erforderlich, wenn zulässige Werte definiert wurden)

Formulareinstellungen

Darstellung

Feld	Funktion
Titel	Anzeigetitel des Formulars
Titel anzeigen	Zeigt den Formulartitel oberhalb jeder Formularinstanz an
Formularname anzeigen	Zeigt den Namen des Formulars als erstes Formularelement mit der Beschriftung Verwendetes Formular an

Verhalten

Feld	Funktion
Kategorien	Fügt jeder Formularinstanz Kategorien hinzu; Werte werden mit der Eingabetaste getrennt
Nach Erstellung versiegeln	Formularinstanzen können nach dem ersten Speichern nicht mehr bearbeitet werden
Zwischenspeichern aktivieren	Formularinstanzen zeigen sowohl eine Speichern- als auch eine Speichern & Schließen-Schaltfläche an; die Schaltfläche Speichern speichert die aktuellen Formularwerte und belässt das Formular im Bearbeitungsmodus.

Infrastruktur

Feld	Funktion
Resource-Loader-Abhängigkeiten
Versionen nachverfolgen
Einbindbar	Erweitert ein Formular
Abstrakt
Teilformular

Ziel

Feld	Funktion
Zieltyp
Vordefinierter Seitentitel für mit diesem Formular erstellte Seiten	Verwenden Sie den Feldnamen, um den Wert eines Formularfeldes einzusetzen. Beispiel: Wenn ein Feld den Namen company_name besitzt, kann {{company_name}} als Seitentitel oder als Teil des Seitentitels verwendet werden.

Listener

Feld	Funktion
Ereignis	Jeder Listener reagiert auf eines der folgenden Ereignisse: initCompleteForm: Das Objekt wurde initialisiert parseComplete: JSON, Schema oder Konfiguration wurden vollständig verarbeitet renderComplete: Die Benutzeroberfläche wurde vollständig im DOM gerendert beforeSubmitData: Direkt vor dem Absenden der Daten
Callback	Ruft eine Funktion auf, wenn das Ereignis eintritt; siehe das Beispiel zum Fortschrittsbalken.

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Cascading Style Sheets. Eine Computersprache für die Gestaltung digitaler, vorwiegend webbasierter Dokumente.