Hilfe:Eingabefelder

aus Wikipedia, der freien Enzyklopädie

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

Eingabefelder werden zwischen den Tags <inputbox> und </inputbox> 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:

Eingabe Ergebnis
<inputbox>
type              = search
width             = 42
placeholder       = Suchbegriff
buttonlabel       = Suche
searchbuttonlabel = Volltext
break             = no
arialabel         = Im Wiki suchen
</inputbox>

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.
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
Eingabe Ergebnis
<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>

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
Eingabe Ergebnis
<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>

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
Eingabe Ergebnis
<inputbox>
type    = create
prefix  = Wikipedia:
preload = Vorlage:Bitte erst NACH dieser Zeile schreiben! (Begrüßungskasten)/Text
</inputbox>

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
Eingabe Ergebnis
<inputbox>
type              = fulltext
searchbuttonlabel = Volltextsuche starten
namespaces        = Wikipedia**, Wikipedia_Diskussion, Hilfe**, Hilfe_Diskussion
prefix            = Hilfe:
</inputbox>

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
Eingabe Ergebnis
<inputbox>
type=move
page=Wikipedia:Spielwiese/Vorlage
summary=Test
</inputbox>

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
Eingabe Ergebnis
<inputbox>
type              = search
buttonlabel       = Seite suchen
searchbuttonlabel = Volltextsuche
tour              = einfuhrung
</inputbox>

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
Eingabe Ergebnis
<inputbox>
type              = search2
buttonlabel       = Seite suchen
labeltext         = Suche nach:
</inputbox>
 

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)