imported>Lómelinde: basis

2024-08-04T04:36:56Z

basis

Neue Seite

{{Hilfe}}
Die '''Eingabefelder''' ermöglichen die Darstellung von [[Webformular|HTML-Formularen]] auf Wikiseiten. Sie sollten nicht im [[Wikipedia:Artikel|Artikelnamensraum]] verwendet werden. Die Eingabefelder basieren auf der [[Hilfe:MediaWiki|MediaWiki]]-Erweiterung ''[[mw:Extension:InputBox|InputBox]]''.

== Allgemeine Syntax ==
{{Hilfe/Wikitext-tag |tag=inputbox |class=float-right hintergrundfarbe-basis |binary=1 |Attribute=-}}

Eingabefelder werden zwischen den Tags <code><nowiki><inputbox></nowiki></code> und <code><nowiki></inputbox></nowiki></code> in Zeilen definiert. Jeder Parameter des Eingabefelds erhält nach einem Gleichheitszeichen seinen Wert, z. B.: <code>type = create</code>.

Folgendes Beispiel zeigt ein Suchfeld mit einigen weiteren Optionen an:

<syntaxhighlight lang="wikitext">
<inputbox>
type = search
width = 42
placeholder = Suchbegriff
buttonlabel = Suche
searchbuttonlabel = Volltext
break = no
arialabel = Im Wiki suchen
</inputbox>
</syntaxhighlight>

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

{| class="wikitable"
! Name !! Beschreibung
|-
|<code>arialabel</code> 
|Ergänzt ein Attribut, das die Zugänglichkeit des Formulars für Screenreader verbessert. [https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html Beschreibung des Attributes bei W3C]
|-
| <code>bgcolor</code> || Ändert die Hintergrundfarbe um das Eingabefeld herum. Es werden HTML-Farbwerte erwartet.
|-
| <code>break</code> || 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.
|-
| <code>buttonlabel</code> || Ändert den Text des zum Eingabefeld gehörenden Buttons. Dieser Parameter wird vom Typ ''[[#fulltext|fulltext]]'' nicht unterstützt.
|-
| <code>default</code> || Text, der standardmäßig im Eingabefeld erscheint.
|-
| <code>dir</code> || Ä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.
|-
| <code>hidden</code> || Ist der Parameter auf den Wert ''true'' (wahr) gesetzt, wird das Eingabefeld nicht angezeigt. Oftmals hat dieser Parameter nur einen Sinn, wenn auch ein <code>default</code>-Wert angegeben wurde.
|-
| <code>id</code> || Dieser Parameter wird dem <code><form></code>-Tag der HTML-Ausgabe als <code>id</code>-Attribut übergeben. Damit lässt sich das Eingabefeld beispielsweise mit persönlichen CSS-Einstellungen beeinflussen.
|-
| <code>placeholder</code> || Dieser Platzhalter-Text wird nur angezeigt, wenn es keinen <code>default</code>-Wert gibt. Er ist ausgegraut und verschwindet, wenn etwas eingegeben wird.
|-
| <code>width</code> || Gibt die Breite des Eingabefeldes an (in Zeichen).
|}

== Typen ==
Derzeit ermöglicht die Software sieben verschiedene Typen von Eingabefeldern. Sie werden über den Parameter <code>type</code> definiert. Im Folgenden findet sich eine Auflistung aller verfügbaren Typen mitsamt den möglichen zusätzlichen Parametern.

=== comment ===
* <code>type = comment</code>
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|commenttitle]]'' genutzt werden. Siehe auch [[Vorlage:Neuer Abschnitt]].

{| class="wikitable"
|+ Parameter
! Name !! Beschreibung
|-
| <code>editintro</code> || Der Inhalt der angebenenen Seite wird als Erläuterung/Anweisung vor dem Bearbeitungsfenster dargestellt. Zur Verwendung siehe [[Hilfe:Editintro]].
|-
| <code>nosummary</code> || Unterdrückt die Anzeige der Betreffzeile über dem Bearbeitungsfenster.
|-
| <code>preload</code> || Fügt den Inhalt der hier angegebenen Seite in das leere Bearbeitungsfenster ein. Zur Verwendung siehe [[Hilfe:Preload]].
|-
| <code>preloadparams[]</code> || Erlaubt Parameterwerte für Platzhalter bei <code>preload</code> zu setzen. Zur Verwendung siehe [[Hilfe:Preload]].
|-
| <code>useve</code> || Öffnet den [[Hilfe:VisualEditor|VisualEditor]] anstatt des normalen Wikitext-Editors.
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<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>
</syntaxhighlight>

''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 ===
* <code>type = commenttitle</code>
Fügt einen Abschnitt mit dem im Eingabefeld angegebenen Betreff an eine Seite an. Siehe auch [[Vorlage:Neuer Abschnitt]].

{| class="wikitable"
|+ Parameter
! Name !! Beschreibung
|-
| <code>editintro</code> || Der Inhalt der angebenenen Seite wird als Erläuterung/Anweisung vor dem Bearbeitungsfenster dargestellt. Zur Verwendung siehe [[Hilfe:Editintro]].
|-
| <code>page</code> || Seite, auf der der neue Abschnitt eingefügt werden soll. Ist dieser Parameter nicht angegeben, wird die Diskussionsseite der aktuellen Seite genutzt.
|-
| <code>preload</code> || Fügt den Inhalt der hier angegebenen Seite in das leere Bearbeitungsfenster ein. Zur Verwendung siehe [[Hilfe:Preload]].
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<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>
</syntaxhighlight>

''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 ===
* <code>type = create</code>
Erstellt die angegebene Seite. Die eingetragene Seite wird zum Bearbeiten angezeigt.

{| class="wikitable"
|+ Parameter
! Name !! Beschreibung
|-
| <code>editintro</code> || Der Inhalt der angebenenen Seite wird als Erläuterung/Anweisung vor dem Bearbeitungsfenster dargestellt. Zur Verwendung siehe [[Hilfe:Editintro]].
|-
| <code>prefix</code> || Der Text dieses Parameters wird vor den Titel der anzulegenden Seite gestellt.
|-
| <code>preload</code> || Fügt den Inhalt der hier angegebenen Seite in das leere Bearbeitungsfenster ein. Zur Verwendung siehe [[Hilfe:Preload]].
|-
| <code>useve</code> || Öffnet den [[Hilfe:VisualEditor|VisualEditor]] anstatt des normalen Wikitext-Editors.
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<inputbox>
type = create
prefix = Wikipedia:
preload = Vorlage:Bitte erst NACH dieser Zeile schreiben! (Begrüßungskasten)/Text
</inputbox>
</syntaxhighlight>

''Ergebnis:''
<inputbox>
type = create
prefix = Wikipedia:
preload = Vorlage:Bitte erst NACH dieser Zeile schreiben! (Begrüßungskasten)/Text
</inputbox>

=== fulltext ===
* <code>type = fulltext</code>
Suche nach der eingegebenen Zeichenkette nur im Volltext-Modus, der normale Suchbutton wird nicht angezeigt.

{| class="wikitable"
|+ Parameter
|-
! Name !! Beschreibung
|-
| <code>namespaces</code> || Definiert die zu durchsuchenden Namensräume, durch Kommata getrennt. Leerzeichen müssen durch Unterstriche maskiert werden. <code>**</code> hinter einem Namensraum setzt den Haken in der Checkbox.
|-
| <code>prefix</code> || Suche auf Seiten beschränken, die mit dem angegebenen Wort beginnen.
|-
| <code>searchbuttonlabel</code> || Beschriftung für den „Volltextsuche“-Button.
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<inputbox>
type = fulltext
searchbuttonlabel = Volltextsuche starten
namespaces = Wikipedia**, Wikipedia_Diskussion, Hilfe**, Hilfe_Diskussion
prefix = Hilfe:
</inputbox>
</syntaxhighlight>

''Ergebnis:''
<inputbox>
type = fulltext
searchbuttonlabel = Volltextsuche starten
namespaces = Wikipedia**,Wikipedia_Diskussion,Hilfe**,Hilfe_Diskussion
prefix = Hilfe:
</inputbox>

=== move ===
* <code>type = move</code>
Füllt [[Spezial:Verschieben]] nach den Vorgaben aus. Der Text im Eingabefeld ist das Verschiebeziel.

{| class="wikitable"
|+ Parameter
|-
! Name !! Beschreibung
|-
| <code>page</code> || Seite, die verschoben werden soll. Dieser Parameter ist verpflichtend anzugeben.
|-
| <code>summary</code> || Zusammenfassungszeile für die Verschiebung
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<inputbox>
type=move
page=Wikipedia:Spielwiese/Vorlage
summary=Test
</inputbox>
</syntaxhighlight>

''Ergebnis:''
<inputbox>
type=move
page=Wikipedia:Spielwiese/Vorlage
summary=Test
</inputbox>

=== search ===
* <code>type = search</code>
Suche nach der eingegebenen Zeichenkette mit Buttons für die exakte und die Volltextsuche. Werden die Parameter <code>namespaces</code> oder <code>prefix</code> angegeben, verhält sich das Eingabefeld wie eines des Typs ''[[#fulltext|fulltext]]''.

{| class="wikitable"
|+ Parameter
|-
! Name !! Beschreibung
|-
| <code>namespaces</code> || Definiert die zu durchsuchenden Namensräume, durch Kommata getrennt. Leerzeichen müssen durch Unterstriche maskiert werden. <code>**</code> hinter einem Namensraum setzt den Haken in der Checkbox.
|-
| <code>prefix</code> || Suche auf Seiten beschränken, die mit dem angegebenen Wort beginnen.
|-
| <code>searchbuttonlabel</code> || Beschriftung für den „Volltextsuche“-Button.
|-
| <code>searchfilter</code> || Zusätzliche Suchfilter/Suchbegriffe, die zu der Suche des Nutzers hinzugefügt wird
|-
|<code>tour</code>
|Startet auf der Suchergebnisseite eine [[Hilfe:Geführte Touren|geführte Tour]].
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<inputbox>
type = search
buttonlabel = Seite suchen
searchbuttonlabel = Volltextsuche
tour = einfuhrung
</inputbox>
</syntaxhighlight>

''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 ===
* <code>type = search2</code>
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 <code>fulltextbutton</code> angegeben, verhält sich das Eingabefeld wie eines des Typs ''[[#search|search]]''.

{| class="wikitable"
|+ Parameter
|-
! Name !! Beschreibung
|-
| <code>fulltextbutton</code> || Beschriftung für den „Volltextsuche“-Button.
|-
| <code>labeltext</code> || Zeigt den angegebenen Text über dem Suchfeld an.
|}

''Beispiel:''
<syntaxhighlight lang="wikitext">
<inputbox>
type = search2
buttonlabel = Seite suchen
labeltext = Suche nach:
</inputbox>
</syntaxhighlight>

''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 <code><inputbox></code> eingefügt wird:<br />
<syntaxhighlight lang="html" inline><templatestyles src="MediaWiki-Button/styles.css" /></syntaxhighlight>

== Weitere Informationen ==
{{MediaWiki|Extension:InputBox}}
<noinclude>
[[Kategorie:Hilfe:Bausteine]]
[[Kategorie:Hilfe:MediaWiki-Erweiterung]]
</noinclude>

Hilfe:Eingabefelder - Versionsgeschichte

imported>Lómelinde: basis