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

Wikisyntax: <tag>

<inputbox>

• Typ: binary
• Attribute: Keine

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

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

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

• 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.

Parameter

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

• type = commenttitle

Fügt einen Abschnitt mit dem im Eingabefeld angegebenen Betreff an eine Seite an. Siehe auch Vorlage:Neuer Abschnitt.

Parameter

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

• type = create

Erstellt die angegebene Seite. Die eingetragene Seite wird zum Bearbeiten angezeigt.

Parameter

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

• type = fulltext

Suche nach der eingegebenen Zeichenkette nur im Volltext-Modus, der normale Suchbutton wird nicht angezeigt.

Parameter

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:

Wikipedia Wikipedia_Diskussion Hilfe Hilfe_Diskussion

move

• type = move

Füllt Spezial:Verschieben nach den Vorgaben aus. Der Text im Eingabefeld ist das Verschiebeziel.

Parameter

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

• 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.

Parameter

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

• 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.

Parameter

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:

Suche nach:

 

Formular-Design

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" />

Weitere Informationen

MediaWiki: Extension:InputBox – Freie Wikisoftware (englisch)