Hilfe:Inputbox

Aus Wiki-Langen
Wechseln zu: Navigation, Suche

Extension: Inputbox

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

<inputbox>

 type              = search
 width             = 42
 placeholder       = Suchbegriff
 buttonlabel       = Suche
 searchbuttonlabel = Volltext
 break             = no

</inputbox>

Standardparameter

Folgende allgemeine Parameter können nach dem obigen Schema jedem Typ von Eingabefeld übergeben werden.

Name Beschreibung
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     = Fragen zur Wiki-Langen
  editintro   = Fragen zur Wiki-Langen/Intro/editintro
  preload     = Fragen zur Wiki-Langen/Intro/preload
  buttonlabel = Abschnitt anfügen
</inputbox>

<inputbox>

 type        = comment
 default     = Fragen zur Wiki-Langen
 editintro   = Fragen zur Wiki-Langen/Intro/editintro
 preload     = Fragen zur Wiki-Langen/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        = Fragen zur Wiki-Langen
  editintro   = Fragen zur Wiki-Langen/Intro/editintro
  preload     = Fragen zur Wiki-Langen/Intro/preload
  buttonlabel = Abschnitt anfügen
</inputbox>

<inputbox>

 type        = commenttitle
 default     = Frage zu Eingabefeldern
 page        = Fragen zur Wiki-Langen
 editintro   = Fragen zur Wiki-Langen/Intro/editintro
 preload     = Fragen zur Wiki-Langen/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  = Hilfe:
  preload = Vorlage:Bitte erst NACH dieser Zeile schreiben! (Begrüßungskasten)/Text
</inputbox>

<inputbox>

 type    = create
 prefix  = Hilfe:
 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>

<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    = Hilfe:Spielwiese/Vorlage
  summary = Test
</inputbox>

<inputbox>

 type    = move
 page    = Hilfe: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.
Beispiel
Eingabe Ergebnis
<inputbox>
  type              = search
  buttonlabel       = Seite suchen
  searchbuttonlabel = Volltextsuche
</inputbox>

<inputbox>

 type              = search
 buttonlabel       = Seite suchen
 searchbuttonlabel = Volltextsuche

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

<inputbox>

 type              = search2
 buttonlabel       = Seite suchen
 labeltext         = Suche nach:

</inputbox>

Links