Hilfe:Eingabefelder
Die Eingabefelder ermöglichen die Darstellung von HTML-Formularen auf Wikiseiten. Sie sollten nicht im Artikelnamensraum verwendet werden. Die Eingabefelder basieren auf der MediaWiki-Erweiterung InputBox.
Allgemeine Syntax[Bearbeiten | Quelltext bearbeiten]
Eingabefelder werden zwischen den Tags <inputbox> und </inputbox> in Zeilen definiert. Jeder Parameter des Eingabefelds erhält nach einem Gleichheitszeichen seinen Wert, z. B.: type = create.
Folgendes Beispiel zeigt ein Suchfeld mit einigen weiteren Optionen an:
<inputbox>
type = search
width = 42
placeholder = Suchbegriff
buttonlabel = Suche
searchbuttonlabel = Volltext
break = no
arialabel = Im Wiki suchen
</inputbox>
Ergebnis:
Standardparameter[Bearbeiten | Quelltext bearbeiten]
Folgende allgemeine Parameter können nach dem obigen Schema jedem Typ von Eingabefeld übergeben werden.
| Name | Beschreibung |
|---|---|
arialabel
|
Ergänzt ein Attribut, das die Zugänglichkeit des Formulars für Screenreader verbessert. Beschreibung des Attributes bei W3C |
bgcolor |
Ändert die Hintergrundfarbe um das Eingabefeld herum. Es werden HTML-Farbwerte erwartet. |
break |
Beeinflusst, ob zwischen Eingabefeld und Buttons ein Zeilenumbruch eingefügt werden soll. Um das zu verhindern, muss dieser Parameter auf no gesetzt werden. Standardmäßig ist der Zeilenumbruch aktiviert. |
buttonlabel |
Ändert den Text des zum Eingabefeld gehörenden Buttons. Dieser Parameter wird vom Typ fulltext nicht unterstützt. |
default |
Text, der standardmäßig im Eingabefeld erscheint. |
dir |
Ändert die Richtung, in der Texte in das Eingabefeld eingetragen werden (links-nach-rechts, ltr; oder rechts-nach-links, rtl). Dieser Wert orientiert sich an der Standardeinstellung des Wikis bzw. des umgebenden Textes. |
hidden |
Ist der Parameter auf den Wert true (wahr) gesetzt, wird das Eingabefeld nicht angezeigt. Oftmals hat dieser Parameter nur einen Sinn, wenn auch ein default-Wert angegeben wurde.
|
id |
Dieser Parameter wird dem <form>-Tag der HTML-Ausgabe als id-Attribut übergeben. Damit lässt sich das Eingabefeld beispielsweise mit persönlichen CSS-Einstellungen beeinflussen.
|
placeholder |
Dieser Platzhalter-Text wird nur angezeigt, wenn es keinen default-Wert gibt. Er ist ausgegraut und verschwindet, wenn etwas eingegeben wird.
|
width |
Gibt die Breite des Eingabefeldes an (in Zeichen). |
Typen[Bearbeiten | Quelltext bearbeiten]
Derzeit ermöglicht die Software sieben verschiedene Typen von Eingabefeldern. Sie werden über den Parameter type definiert. Im Folgenden findet sich eine Auflistung aller verfügbaren Typen mitsamt den möglichen zusätzlichen Parametern.
comment[Bearbeiten | Quelltext bearbeiten]
type = comment
Fügt einen neuen Abschnitt an das Seitenende an. Der Text im Eingabefeld ist der Name der Seite, auf der der neue Abschnitt ergänzt werden soll. Um zusätzlich auch den Betreff des neuen Abschnitts festlegen zu können, muss commenttitle genutzt werden. Siehe auch Vorlage:Neuer Abschnitt.
| Name | Beschreibung |
|---|---|
editintro |
Der Inhalt der angebenenen Seite wird als Erläuterung/Anweisung vor dem Bearbeitungsfenster dargestellt. Zur Verwendung siehe Hilfe:Editintro. |
nosummary |
Unterdrückt die Anzeige der Betreffzeile über dem Bearbeitungsfenster. |
preload |
Fügt den Inhalt der hier angegebenen Seite in das leere Bearbeitungsfenster ein. Zur Verwendung siehe Hilfe:Preload. |
preloadparams[] |
Erlaubt Parameterwerte für Platzhalter bei preload zu setzen. Zur Verwendung siehe Hilfe:Preload.
|
useve |
Öffnet den VisualEditor anstatt des normalen Wikitext-Editors. |
Beispiel:
<inputbox>
type = comment
default = Wikipedia:Fragen zur Wikipedia
editintro = Wikipedia:Fragen zur Wikipedia/Intro/editintro
preload = Wikipedia:Fragen zur Wikipedia/Intro/preload
buttonlabel = Abschnitt anfügen
</inputbox>
Ergebnis:
commenttitle[Bearbeiten | Quelltext bearbeiten]
type = commenttitle
Fügt einen Abschnitt mit dem im Eingabefeld angegebenen Betreff an eine Seite an. Siehe auch Vorlage:Neuer Abschnitt.
| Name | Beschreibung |
|---|---|
editintro |
Der Inhalt der angebenenen Seite wird als Erläuterung/Anweisung vor dem Bearbeitungsfenster dargestellt. Zur Verwendung siehe Hilfe:Editintro. |
page |
Seite, auf der der neue Abschnitt eingefügt werden soll. Ist dieser Parameter nicht angegeben, wird die Diskussionsseite der aktuellen Seite genutzt. |
preload |
Fügt den Inhalt der hier angegebenen Seite in das leere Bearbeitungsfenster ein. Zur Verwendung siehe Hilfe:Preload. |
Beispiel:
<inputbox>
type = commenttitle
default = Frage zu Eingabefeldern
page = Wikipedia:Fragen zur Wikipedia
editintro = Wikipedia:Fragen zur Wikipedia/Intro/editintro
preload = Wikipedia:Fragen zur Wikipedia/Intro/preload
buttonlabel = Abschnitt anfügen
</inputbox>
Ergebnis:
create[Bearbeiten | Quelltext bearbeiten]
type = create
Erstellt die angegebene Seite. Die eingetragene Seite wird zum Bearbeiten angezeigt.
| Name | Beschreibung |
|---|---|
editintro |
Der Inhalt der angebenenen Seite wird als Erläuterung/Anweisung vor dem Bearbeitungsfenster dargestellt. Zur Verwendung siehe Hilfe:Editintro. |
prefix |
Der Text dieses Parameters wird vor den Titel der anzulegenden Seite gestellt. |
preload |
Fügt den Inhalt der hier angegebenen Seite in das leere Bearbeitungsfenster ein. Zur Verwendung siehe Hilfe:Preload. |
useve |
Öffnet den VisualEditor anstatt des normalen Wikitext-Editors. |
Beispiel:
<inputbox>
type = create
prefix = Wikipedia:
preload = Vorlage:Bitte erst NACH dieser Zeile schreiben! (Begrüßungskasten)/Text
</inputbox>
Ergebnis:
fulltext[Bearbeiten | Quelltext bearbeiten]
type = fulltext
Suche nach der eingegebenen Zeichenkette nur im Volltext-Modus, der normale Suchbutton wird nicht angezeigt.
| Name | Beschreibung |
|---|---|
namespaces |
Definiert die zu durchsuchenden Namensräume, durch Kommata getrennt. Leerzeichen müssen durch Unterstriche maskiert werden. ** hinter einem Namensraum setzt den Haken in der Checkbox.
|
prefix |
Suche auf Seiten beschränken, die mit dem angegebenen Wort beginnen. |
searchbuttonlabel |
Beschriftung für den „Volltextsuche“-Button. |
Beispiel:
<inputbox>
type = fulltext
searchbuttonlabel = Volltextsuche starten
namespaces = Wikipedia**, Wikipedia_Diskussion, Hilfe**, Hilfe_Diskussion
prefix = Hilfe:
</inputbox>
Ergebnis:
move[Bearbeiten | Quelltext bearbeiten]
type = move
Füllt Spezial:Verschieben nach den Vorgaben aus. Der Text im Eingabefeld ist das Verschiebeziel.
| Name | Beschreibung |
|---|---|
page |
Seite, die verschoben werden soll. Dieser Parameter ist verpflichtend anzugeben. |
summary |
Zusammenfassungszeile für die Verschiebung |
Beispiel:
<inputbox>
type=move
page=Wikipedia:Spielwiese/Vorlage
summary=Test
</inputbox>
Ergebnis:
search[Bearbeiten | Quelltext bearbeiten]
type = search
Suche nach der eingegebenen Zeichenkette mit Buttons für die exakte und die Volltextsuche. Werden die Parameter namespaces oder prefix angegeben, verhält sich das Eingabefeld wie eines des Typs fulltext.
| Name | Beschreibung |
|---|---|
namespaces |
Definiert die zu durchsuchenden Namensräume, durch Kommata getrennt. Leerzeichen müssen durch Unterstriche maskiert werden. ** hinter einem Namensraum setzt den Haken in der Checkbox.
|
prefix |
Suche auf Seiten beschränken, die mit dem angegebenen Wort beginnen. |
searchbuttonlabel |
Beschriftung für den „Volltextsuche“-Button. |
searchfilter |
Zusätzliche Suchfilter/Suchbegriffe, die zu der Suche des Nutzers hinzugefügt wird |
tour
|
Startet auf der Suchergebnisseite eine geführte Tour. |
Beispiel:
<inputbox>
type = search
buttonlabel = Seite suchen
searchbuttonlabel = Volltextsuche
tour = einfuhrung
</inputbox>
Ergebnis:
Seiten- und Volltextsuche:
- Bei der Eingabe eines Begriffs und Klick auf „Seite suchen“ öffnet sich sofort der Artikel, sofern vorhanden. Wenn nicht vorhanden, wird die Volltextsuche ausgeführt.
- Bei Klick auf „Volltextsuche“ wird immer auch eine Suche im Inhalt ausgeführt, auch wenn es den eingegebenen Suchbegriff als Artikel gibt.
search2[Bearbeiten | Quelltext bearbeiten]
type = search2
Sucht genau nach der eingegebenen Zeichenkette (exakte Suche ohne Volltextsuche-Button). Ein Eingabefeld diesen Typs ist standardmäßig ein Inline-Element, bricht also den Textfluss nicht um. Wird der Parameter fulltextbutton angegeben, verhält sich das Eingabefeld wie eines des Typs search.
| Name | Beschreibung |
|---|---|
fulltextbutton |
Beschriftung für den „Volltextsuche“-Button. |
labeltext |
Zeigt den angegebenen Text über dem Suchfeld an. |
Beispiel:
<inputbox>
type = search2
buttonlabel = Seite suchen
labeltext = Suche nach:
</inputbox>
Ergebnis:
Formular-Design[Bearbeiten | Quelltext bearbeiten]
Im Projekt üblich sind zurzeit blaue Buttons für maßgebliche Aktionen; etwa auf Spezial:Suche.
Bei den Suchfeldern ist dies bislang nicht der Fall. Dies kann bewirkt werden, indem vor der ersten <inputbox> eingefügt wird:
<templatestyles src="MediaWiki-Button/styles.css" />
