Quelltext der Seite Hilfe:TemplateData/VisualEditor

{{Hilfe}}
{{Hilfe:VisualEditor/!badge}}
Diese Seite beschreibt die Wirkung der Parameter aus der [[Hilfe:Vorlagendokumentation|Vorlagendokumentation]] mit '''[[Hilfe:TemplateData|TemplateData]]''' auf die Darstellung der [[Hilfe:Vorlagen|Vorlagen]] im '''[[Hilfe:VisualEditor|VisualEditor]]'''.

__TOC__

== Äußere Strukturinformationen ==
<onlyinclude>Werden Vorlagen mit der Unterstützung von TemplateData dokumentiert, so ergeben sich zusätzliche Möglichkeiten, dem Bearbeiter der Dialogfenster im VisualEditor das Ausfüllen zu erleichtern. Hier folgt eine kurze Auflistung der wichtigsten Parameter mit Beschreibung.

{| class="wikitable hintergrundfarne-basis toptextcells"
|+ [[Hilfe:TemplateData/JSON#JSON-Struktur|Strukturinformationen]]
|- class="hintergrundfarbe9"
|colspan="2"| [[Datei:VisualEditor-logo.svg|x20px|verweis=|alt=|Logo]]
|-
! Parametername/TemplateData 
! colspan="2"| Beschreibung
|- id="template.description"
|
<syntaxhighlight lang="javascript">
{ "description": "…",
…
}
</syntaxhighlight>
| [[Hilfe:Vorlagen/VisualEditor#description1|Vorlagenbeschreibung]]<br />Der Text, der im oberen Bereich des Dialogfensters einer ausgewählten Vorlage ausgegeben wird. Die Kurzbeschreibung zur Funktion oder zum Zweck einer Vorlage. Falls keine Beschreibung vorhanden ist wird ein entsprechender Hinweis ausgegeben.<br />''Die Vorlage „Template:XY“ hat noch keine Beschreibung, aber vielleicht gibt es einige Informationen auf der {{Hilfe/mark|Vorlagenseite|hellblau}}.''<ref>Ein Link direkt zur Vorlagenseite, auf der sich im Allgemeinen der Programmcode befindet. Hier können eventuell weitere Informationen zu den Parametern vorhanden sein.</ref>
|- id="template.params"
|
<syntaxhighlight lang="javascript">
"params": { "1":   { … Deklaration … },
            "XYZ": { … Deklaration … },
             …
           }
</syntaxhighlight>
| Unbenannte („1“) oder benannte („XYZ“) Parameter mit der spezifischen Deklaration. Hier wird für jeden einzelnen Parameter [[#params|festgelegt]], wie er im Dialogfeld behandelt werden soll.
|- id="template.format"
|<syntaxhighlight lang="javascript">
"format": "inline",
…
</syntaxhighlight>
Wirkung <code><nowiki>{{_|_=_}}</nowiki></code>
<syntaxhighlight lang="javascript">
"format": "block",
…
</syntaxhighlight>
Wirkung <code><nowiki>{{_↵| _ = _↵}}</nowiki></code>
| Ausgabeformat der Vorlage als ''Block'', also je Parameter eine Zeile oder ''inline'', alles in einer Zeile. Wirkt sich auf den Quelltext aus.
{| class="wikitable toptextcells hintergrundfarne-basis"
|-
! inline
|-
|<pre style="padding: 0; margin: 0;">
{{Vorlagenname|1=|2=|3=|4=…}}
</pre>
|-
! block
|-
|<pre style="padding: 0; margin: 0;">
{{Vorlagenname
| 1 =
| 2 =
| 3 =
| 4 =
…
}}
</pre>
|}
|- id="template.sets"
|
<syntaxhighlight lang="javascript">
 …
"sets": [ {
   "label": "Set1",
   "params": [ "1", "5", "XYZ" ]
   },
   "label": "Set2",
   "params": [ "Name", "Ort", "Telefon" ]
   } ],
 …
</syntaxhighlight>
|
Eine Parameterliste vom Typ [[JavaScript Object Notation#Datenstruktur und Formatdefinition|Array]], in dem Parameterkombinationen zusammengestellt werden können.<br /> Jedes Setelement enthält dabei eine Gruppe von Parametern, die gemeinsam weiterverwendet werden sollen.<br />
Dem Set muss ein Name (label) als Kennung zugeordnet sein, dabei sollte möglichst eine Länge von 20 Zeichen nicht überschritten werden.<br />
Für ein mögliches Anwendungsbeispiel siehe [[Hilfe:TemplateData/JSON#sets|sets]]<br />
----
{{Info}} Die Entwicklung dieser Funktionalität ist noch nicht abgeschlossen und steht bisher nicht zur Verfügung.<ref name="Stand" />
|}

== {{Anker|params}} Deklaration der inneren Zuweisungsparameter ==
{{Siehe auch|Hilfe:TemplateData/JSON#params|titel1=Zuweisungsparameter}}
Jedem Parameter in <code>[[#template.params|params]]</code> können durch unterschiedliche Zuweisungen vorbestimmte Eigenschaften übergeben werden, um den Benutzern das Ausfüllen zu erleichtern.
* [[#p.name|Parameterbezeichnungen]] – Nutzung alternativer Namen für die Anzeige der Parameter bei der Ausgabe im Dialogfenster
* [[#p.prio|Priorität]] – Vorgaben, ob ein Eingabefeld als Pflichtangabe, Vorschlag oder optionaler Wert eingestuft werden soll
* [[#p.info|Zusatzinformationen]] – wichtige Hinweise zum Parameter zum Zweck, als Beispielangabe, zum erwarteten Standard oder um einen Autowert zu ermöglichen
* [[#p.type|Feldtypen]] – Festlegung der Eingabeoptionen

=== {{Anker|p.name}} Parameterbezeichnungen ===
Für die Unterstützung der Anwender ist es sinnvoll, wenn allen, insbesondere den unbenannten (nummerierten) Parametern, ein selbsterklärender ''label'' zugeordnet wird.

{| class="wikitable hintergrundfarne-basis toptextcells"
|+ Parameterbezeichnung / Parameterbeschriftung
|- class="hintergrundfarbe9"
|colspan="2"| [[Datei:VisualEditor-logo.svg|x20px|verweis=|alt=|Logo]]
|-
! TemplateData-Deklaration
! Einfluss auf das interaktive Dialogfeld
|- id="p.label"
| '''Beschriftung'''
<syntaxhighlight lang="javascript">
"1": {
   "label": "Bezeichner",
   …
     },
"2": {
   …
     },
"Beschreibung": {
   …
     },
"alt": {
   "label": "Alternativtext",
   …
     },
…
</syntaxhighlight>

| aktiv eingeblendet (dauerhaft, wenn ein Parameter als <code>[[#p.required|required]]</code> oder vorübergehend ausblendbar, wenn er als <code>[[#p.suggested|suggested]]</code> deklariert wurde)
----
<div style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;">
{| style="width:100%;"
|-
| '''Bezeichner'''
|-
| {{Hilfe/inputarea}}
|-
| '''2'''
|-
| {{Hilfe/inputarea}}
|-
| '''Beschreibung'''
|-
| {{Hilfe/inputarea}}
|-
| '''Alternativtext'''
|-
| {{Hilfe/inputarea |border=2 |typ=p}}
|}</div>
|- class="hintergrundfarbe1"
|colspan="2"| Die angezeigte Beschriftung des Vorlagenparameters,<ref>Der Labelname kann von dem bei der Programmierung verwendeten Parameternamen abweichen, da dort oftmals Abkürzungen oder Ziffern verwendet werden.</ref><br />''label'' kann leer bleiben, wenn der Parametername identisch ist mit der Beschriftung, die angezeigt werden soll.
|- class="hintergrundfarbe5"
! colspan="2"|
|- id="p.aliases"
| '''Aliasname, Synonym'''
<syntaxhighlight lang="javascript">
"1": {
  …
  "aliases": [ "Synonym1", "Synonym2" ],
  …
},
</syntaxhighlight>
|
<div style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;">
{| style="width:100%;"
|-
| '''1'''
|-
| {{Hilfe/inputarea}}
|}
</div>
----
Selbst wenn im Quelltext ein Aliasname wie beispielsweise '''Synonym1''' verwendet wurde, bleibt die Anzeige bei der eigentlichen Parameterbezeichnung
<div style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;">
{| style="width:100%;"
|-
| '''1'''
|-
|colspan="2"| {{Hilfe/inputarea |border= 2 |typ= p}}
|}</div>
|- class="hintergrundfarbe1"
|colspan="2"| Aliasnamen, die im Quelltext synonym zum Parameter angegeben werden können, haben keine Auswirkung auf die Parameternamen in der Anzeige des Dialogfensters. Es wird dort immer der Name angezeigt, der als ''[[#p.label|label]]'' vorgegeben wurde. Eine Anzeige möglicher Synonyme erfolgt nicht.
|}

=== {{Anker|p.prio}} Priorität ===
Die Parameter können mit unterschiedlichen Prioritäten ausgestattet werden. Es gibt die Möglichkeit, sie als Pflichtangabe&nbsp;[[Datei:OOjs UI indicator required.svg|8px|klasse=skin-invert|alt=|verweis=]] oder als vorgeschlagene Eingabeoption zu deklarieren.
{{Siehe auch|Hilfe:Vorlagen/VisualEditor#Vorlagen bearbeiten oder Parameter hinzufügen}}

{| class="wikitable hintergrundfarne-basis toptextcells"
|+ Stellenwert der Parameter
|- class="hintergrundfarbe9"
|colspan="2"| [[Datei:VisualEditor-logo.svg|x20px|verweis=|alt=|Logo]]
|-
! TemplateData-Deklaration
! Einfluss auf das interaktive Dialogfeld
|- class="hintergrundfarbe1"
|colspan="2"| Ist ein Wert als Pflichtangabe&nbsp;[[Datei:OOjs UI indicator required.svg|8px|klasse=skin-invert|alt=|verweis=]] gekennzeichnet, so kann er nicht aus dem Bereich des Dialogfensters entfernt werden.<br />Ist es eine als erwünschte Option <code>suggested</code> vorgeschlagene Angabe, so kann auch diese zwar temporär ausgeblendet, aber nicht wirklich aus den Vorgaben des Dialogfensters entfernt werden. Der Parameter muss jedoch nicht ausgefüllt werden.
|- id="p.required"
| <span style="opacity: .5;">[[Datei:OOjs UI indicator required.svg|10px|klasse=skin-invert|alt=|verweis=]]</span> '''Erforderliches Feld'''<ref>Pflichtparameter können nicht entfernt oder ausgeblendet werden.</ref>
<syntaxhighlight lang="javascript">
…
"Name": {
   …
   "required": true,
   …
     },
…
</syntaxhighlight>

| {{Hilfe/ticbox|OOJS=1|tic=1|disabled=1}} Pflichtangeben können nicht ausgeblendet werden
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Name'''<br />''Parameter ist erforderlich.''
|-
| {{Hilfe/inputarea |border= 2 |required= 1 |typ= p}}
|}
|-
| '''nicht erforderlich, aber vorgeschlagen'''
<syntaxhighlight lang="javascript">
…
"Alter": {
   …
   "required": false,
   "suggested": true,
   …
     },
…
</syntaxhighlight>

| Optionale, erwünschte Parameter lassen sich während des Ausfüllens ausblenden {{Hilfe/ticbox|OOJS=1|tic=1|typ=p}} → {{Hilfe/ticbox|OOJS=1|tic=0}}, jedoch nicht dauerhaft entfernen.<ref>Ausgeblendete Parameter verlieren ihren Inhalt und werden beim Speichern nicht in den Seitenquelltext übernommen. Wird die Vorlage erneut zur Bearbeitung geöffnet, so erscheinen sie wieder als Vorschlagsfelder als erwünschte Eingabe</ref>
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Alter'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
|- id="p.suggested"
| '''vorgeschlagene Parameter'''
<syntaxhighlight lang="javascript">
…
"Adresse": {
   …
   "suggested": true,
   …
     },
…
</syntaxhighlight>

| Entspricht dem vorherigen Beispiel, das <code>"required": false</code> muss nicht angeben werden
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Adresse'''
|-
| {{Hilfe/inputarea}}
|}
|-
| '''optionale Parameter'''
<syntaxhighlight lang="javascript">
…
"Telefon": {
   …
   "suggested": false,
   …
     },
…
</syntaxhighlight>

| Optionale Parameter können dauerhaft aus dem Dialogfensters ausgeblendet werden, so dass sie bei der nächsten Bearbeitung nicht mehr automatisch angeboten werden.
Im linken Teil des Dialogfensters werden alle ausgeblendeten Parameter hinter {{Hilfe/ticbox|OOJS=1|tic=0}} aufgelistet
{| style="border:1px solid #BBBBBB; width:20em; border-radius:3px; font-size:90%;"
|-
|{{Hilfe/ticbox|OOJS=1|tic=0}}&nbsp;Telefon
|}
|- class="hintergrundfarbe5"
! colspan="2"|
|- id="p.deprecated"
| <span style="opacity: .5;">[[Datei:OOjs UI icon notice.svg|16px|klasse=skin-invert|alt=|verweis=]]</span> '''veralteter Parameter'''
<syntaxhighlight lang="javascript">
"Geschlecht": {
   …
   "deprecated": true,
   …
     },
</syntaxhighlight>
| Parameter als veraltet kennzeichnen
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Geschlecht''' <span style="opacity: .5;">[[Datei:OOjs UI icon notice.svg|16px|klasse=skin-invert|alt=|verweis=|Veralteter Parameter]]</span><br />''Parameter ist veraltet.''
|-
| {{Hilfe/inputarea}}
|}
|-
|<syntaxhighlight lang="javascript">
"Geschlecht": {
   …
   "deprecated": "Bitte den Parameter ersetzen.",
   …
     },
</syntaxhighlight>

oder

<syntaxhighlight lang="javascript">
"Geschlecht": {
   …
   "description": "Bitte den Parameter ersetzen.",
   "deprecated": true,
   …
     },
</syntaxhighlight>

| Veraltet mit zusätzlichem Hinweistext, oder zusätzlich einen Hinweistext über den Parameter ''[[#p.description|description]]'' anbringen
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Geschlecht''' <span style="opacity: .5;">[[Datei:OOjs UI icon notice.svg|16px|klasse=skin-invert|alt=|verweis=|Veralteter Parameter]]</span><br />Bitte den Parameter ersetzen.<br />''Parameter ist veraltet.''
|-
| {{Hilfe/inputarea}}
|}
|- class="hintergrundfarbe1"
|colspan="2"| Manchmal werden Vorlagen in ihrer Funktion erweitert oder verändert und es kann vorkommen, dass ein Parameter nicht mehr verwendet werden soll. Dieser kann als ''deprecated'' gekennzeichnet und mit einem entsprechenden Vermerk versehen werden. Zusätzlich wird ein Alarm [[Datei:OOjs UI icon notice.svg|14px|klasse=skin-invert|alt=|verweis=]] hinter dem Namen angezeigt, um darauf aufmerksam zu machen. Nachdem ggf. geeigneter Ersatz über aktuelle Parameter geschaffen wurde, sollte das Feld aus der aktiven Parameterliste entfernt werden.<br />{{Info}} Diese Zuweisung sollte nicht gleichzeitig als [[#p.required|Pflichtangabe]] gekennzeichnet werden.
|}

=== {{Anker|p.info}} Zusatzinformationen ===
Zur Unterstützung beim Ausfüllen können dem Parameter weitere Informationen mitgegeben werden.

{| class="wikitable hintergrundfarne-basis toptextcells"
|+ Hinweisoptionen zu den Parametern
|- class="hintergrundfarbe9"
|colspan="2"| [[Datei:VisualEditor-logo.svg|x20px|alt=|verweis=|Logo]]
|-
! TemplateData-Deklaration
! Einfluss auf das interaktive Dialogfeld
|- id="p.description"
| '''Beschreibung'''
<syntaxhighlight lang="javascript">
"Name": {
   …
   "description": "Namensangabe in der Form Nachname, Rufname",
   …
     },
</syntaxhighlight>

| Parameterbeschreibung oder sonstiger Hinweistext.
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Name'''<br />Namensangabe in der Form Nachname, Rufname
|-
| {{Hilfe/inputarea}}
|}
|- class="hintergrundfarbe5"
! colspan="2"|
|- id="p.example"
| '''Beispiel'''
<syntaxhighlight lang="javascript">
"Name": {
   …
   "example": "Mustermann, Maximilian",
   …
     },
</syntaxhighlight>
| Beispielwert oder Text, der oberhalb des Eingabefeldes kursiv angezeigt wird
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Name'''<br />''Beispiel: Mustermann, Maximilian''
|-
| {{Hilfe/inputarea}}
|}
|- class="hintergrundfarbe5"
! colspan="2"|
|- id="p.default"
| '''Standardwert''' anzeigen
<syntaxhighlight lang="javascript">
"Titel": {
   …
   "default": "Lemma des Wikipedia-Artikels",
   …
     },
</syntaxhighlight>
| Anzeige eines in der Programmierung voreingestellten Inhalts oder einer Standardangabe, falls der Parameter leer bleibt<ref>Der hier angezeigte Standardtext wird nicht in den Quelltext übertragen. Die Eingabe des Parameters ermöglicht die Änerung eines voreingestellten Ausgabewertes.</ref>
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Titel'''<br />Standard: Lemma des Wikipedia-Artikels
|-
| {{Hilfe/inputarea |placeholder=Standard: Lemma des Wikipedia-Artikels}}
|}
|-
|
<syntaxhighlight lang="javascript">
"Titel": {
   …
   "default": "Lemma des Wikipedia-Artikels",
   "example": "Der Herr der Ringe",
   …
     },
</syntaxhighlight>
| Beispiel für die gleichzeitige Angabe des Standard- und eines Beispieltextes
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Titel'''<br />Standard: Lemma des Wikipedia-Artikels<br />''Beispiel: Der Herr der Ringe''
|-
| {{Hilfe/inputarea |border= 2 |placeholder=Standard: Lemma des Wikipedia-Artikels |typ= p}}
|}
|- class="hintergrundfarbe1"
|colspan="2"| Der hier angezeigte Wert oder Text hat nur eine Anzeigefunktion. Die Vorlagenprogrammierung zu diesem Parameter bestimmt, was bei fehlender oder erfolgter Eingabe in der Vorlage tatsächlich ausgegeben werden soll.
|- class="hintergrundfarbe5"
! colspan="2"|
|- id="p.autovalue"
| '''Autowert – Wertvorgabe'''
<syntaxhighlight lang="javascript">
"Bild": {
   …
   "autovalue": "Smiley cause.gif",
   …
     },
</syntaxhighlight>
| Der Autowert wird als aktiver Inhalt in das Eingabefeld geschrieben und in den Quelltext übernommen, falls hier keine Ersetzung erfolgt.
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Titel'''
|-
| {{Hilfe/inputarea |border= 2 |content=Smiley cause.gif |typ= p}}
|}
|-
|
<syntaxhighlight lang="javascript">
"Heute": {
   …
   "default": "heutiges Datum",
   "autovalue": "{{subst:#time:d. F Y}}",
   …
     },
</syntaxhighlight>
| Gleichzeitige Ausgabe eines Defaultwertes
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Heute'''<br />Standard: heutiges Datum
|-
| {{Hilfe/inputarea |content=<nowiki>{{subst:#time:d. F Y}}</nowiki><ref>{{Info}} Eine substituierte Vorlage oder [[Hilfe:Parserfunktionen|Parserfunktion]] ist hier nur möglich, wenn die Vorlage, zu der das TemplateData-Element gehört, nicht selbst in [[Hilfe:Tags|Tags]], wie beispielsweise in Belegangaben mit <code>&lt;ref&gt;</code>-Tags eingebunden wird.</ref>}}
|}
|}

=== {{Anker|p.type}} Feldtypen ===
Über die Deklaration ''type'' können unterschiedliche Ausgabeformen für das Eingabefeld vorgegeben werden.

{| class="wikitable hintergrundfarne-basis toptextcells"
|+ Festlegung der Eingabeoptionen
|- class="hintergrundfarbe9"
|colspan="2"| [[Datei:VisualEditor-logo.svg|x20px|alt=|verweis=|Logo]]
|-
! TemplateData-Deklaration
! Einfluss auf das interaktive Dialogfeld
|- id="type.unknown"
| '''unknown'''
<syntaxhighlight lang="javascript">
"1": {
  …
  "type": "unknown",
  …
},
</syntaxhighlight>
<syntaxhighlight lang="javascript">
"1": {
  …
  "type": "",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''1'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
|- class="hintergrundfarbe1"
|colspan="2"| Dies ist die Standardeinstellung, die ausgegeben wird, wenn keine Typenzuweisung erfolgt. Alle Zeichen werden als Eingabe akzeptiert. Es ist möglich hier [[Wikitext]] einzufügen, der in der Seitenanzeige entsprechend in [[Hilfe:Textgestaltung|gestalteten Text]] oder [[Hilfe:Links/VisualEditor|Verlinkungen]] umgewandelt wird. Derselbe Effekt wird über eine Deklaration als ''content'' erreicht. Der Text kann beispielsweise als <code><nowiki>[[Hyperlink|Link]], <code>&lt;code&gt;</code>, '''fetter''' oder ''kursiver'' Text</nowiki></code> eingegeben werden, was in der Ansicht in [[Hyperlink|Link]], <code>&lt;code&gt;</code>, '''fetter''' oder ''kursiver'' Text gewandelt wird. Auch Bilddateien können hier in der Quelltextform <code><nowiki>[[Datei:Beispiel.png|100px|Beispielbild]]</nowiki></code> eingefügt und entsprechend umgewandelt werden.
|- id="type.content"
| '''content'''
<syntaxhighlight lang="javascript">
"Inhalt": {
  …
  "type": "content",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Inhalt'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
|- id="type.date"
| '''date'''
<syntaxhighlight lang="javascript">
"Datum": {
  …
  "type": "date",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Datum'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
{{Info}} Es werden Datums- oder Zeitangaben im Format der [[ISO 8601]] erwartet, das wäre JJJJ-MM-TT, oder lokal (deutschsprachig) als {{LOCALDATE}} oder {{LOCALTIME}}. Das Feld akzeptiert jegliche Eingaben, eine Prüfung auf Datumsformate im Eingabefeld erfolgt im VE zurzeit noch nicht.<ref name="Stand">Stand: Juli 2024</ref>

|- id="type.number"
| '''number'''
<syntaxhighlight lang="javascript">
"Zahl": {
  …
  "type": "number",
  …
},
</syntaxhighlight>
|

{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Zahl'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
{{Info}} Es wird eine Ziffernfolge erwartet, das Feld akzeptiert jedoch jegliche Angaben, eine Prüfung auf tatsächliche [[Zahl#Zahlbereiche|Zahlenwerte]] oder Sperre nicht-numerischer Zeichen erfolgt über das Eingabefeld im VE zurzeit noch nicht.<ref name="Stand" />

|- id="type.string"
| '''string'''
<syntaxhighlight lang="javascript">
"Zeichenkette": {
  …
  "type": "string",
  …
},
</syntaxhighlight>
|

{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Zeichenkette''' (Zeichenfolge)
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
{{Info}} Es wird eine [[Zeichenkette]] erwartet, also eine Anordnung oder Folge beliebiger Zeichen. Es erfolgt keine Zeichenbeschränkung auf einen speziellen Zeichensatz.<ref name="Stand" />

|- id="type.unbalanced-wikitext"
| '''unbalanced-wikitext'''
<syntaxhighlight lang="javascript">
"Nowiki": {
  …
  "type": "unbalanced-wikitext",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Nowiki''' (Unausgeglichener Wikitext) 
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
----
Wird beispielsweise eine Eingabe mit ungleicher Anzahl an öffnenden und schließenden Klammern erkannt, …
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Nowiki'''
|-
| {{Hilfe/inputarea |border= 2 |content= [fehlende öffnende Klammer]] |typ= p}}
|}
… so wird die Eingabe als Nichtwikitext gekennzeichnet abgespeichert
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Nowiki'''
|-
| {{Hilfe/inputarea |border= 2 |content= &lt;nowiki>[fehlende öffnende Klammer]]&lt;/nowiki> |typ= p}}
|}
|- class="hintergrundfarbe1"
|colspan="2"| Diese Option könnte als Abfrage genutzt werden, um Fehler durch unterschiedliche Klammern <code><nowiki>[[}] [{]]</nowiki></code> oder ähnliche Fehleingaben zu kennzeichnen und den kompletten Inhalt des Eingabefeldes im Fehlerfall in <code><nowiki><nowiki></nowiki></nowiki></code> einzuschließen.
|- id="type.wiki-file-name"
| '''wiki-file-name'''
<syntaxhighlight lang="javascript">
"Bild": {
  …
  "type": "wiki-file-name",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Bild'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
{{Info}} Es wird der reine Dateiname, beispielsweise [[:Datei:Kein Bild.jpg|Kein Bild.jpg]] erwartet. Eine Prüfung, ob diese Datei existiert oder ein erlaubtes [[Hilfe:Dateien#Erlaubte und erwünschte Dateiformate|Dateiformat]] verwendet wurde, erfolgt bei der Eingabe nicht.<ref name="Stand" />
|- class="hintergrundfarbe1"
|colspan="2"| Erwartet wird der komplette Name einer [[Hilfe:Bilder/VisualEditor|Mediendatei]], wie er beispielsweise bei der [[Hilfe:Galerie#Einbindung|Einbindung in Galerien]] oder in der Vorlage {{Vorlage|Doppeltes Bild}} erwartet wird: Ohne mögliche Präfixe <code>Datei:, File:, Image:</code> davor.
|- id="type.wiki-page-name"
| '''wiki-page-name'''
<syntaxhighlight lang="javascript">
"Lemma": {
  …
  "type": "wiki-page-name",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Lemma'''
|-
| {{Hilfe/inputarea |border=2 |typ=p}}
|}
----
Bei der Eingabe wird ein Feld mit möglichen Artikelnamen ausgeklappt, aus dem ein passendes Lemma ausgewählt werden kann.

{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Lemma'''
|-
| {{Hilfe/inputarea |border=2 |content=B |typ=p}}<div style="border: 1px solid #BBBBBB; border-top: 0; border-radius:3px; padding: 0 5px; margin-right: 3px; height: 3em; overflow: auto;">{{Hilfe/mark|B<br />Berlin<br />Brasilien<br />Bayern|blau}}<br />
…</div>
|}
----
Inhalt wurde entfernt
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Lemma'''
|-
| {{Hilfe/inputarea |typ=d}}
|}
|- id="type.wiki-user-name"
| '''wiki-user-name'''
<syntaxhighlight lang="javascript">
"Benutzer": {
  …
  "type": "wiki-user-name",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Benutzer'''
|-
| {{Hilfe/inputarea |border=2 |typ=p}}
|}
----
Bei der Eingabe wird ein Feld mit möglichen Benutzernamen ausgeklappt, aus dem ein vorhandener Benutzername ausgewählt werden kann. Es kann auch ein nicht existierender Name eingegeben werden.
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Benutzer'''
|-
| {{Hilfe/inputarea |border=2 |content=A |typ=p}}<div style="border: 1px solid #BBBBBB; border-top: 0; border-radius:3px; padding: 0 5px; margin-right: 3px; height: 3em; overflow: auto;">{{Hilfe/mark|A<br />ABC<br />Android–B<br />Alpha-Centauri|blau}}<br />
…</div>
|}
|- id="type.wiki-template-name"
| '''wiki-template-name'''
<syntaxhighlight lang="javascript">
"Navigationsleiste 1": {
  …
  "type": "wiki-template-name",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Navigationsleiste 1'''
|-
| {{Hilfe/inputarea |border=2 |typ=p}}
|}
----
Bei der Eingabe wird ein Feld mit möglichen Vorlagennamen ausgeklappt, aus dem eine vorhandene Vorlage ausgewählt werden kann. Es kann auch ein nicht existierender Name eingegeben werden.
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Navigationsleiste 1'''
|-
| {{Hilfe/inputarea |border=2 |content=Navigationsleiste B |typ=p}}<div style="border: 1px solid #BBBBBB; border-top: 0; border-radius:3px; padding: 0 5px; margin-right: 3px; height: 3em; overflow: auto;">{{Hilfe/mark|Navigationsleiste Bundesstraßen in Deutschland<br />Navigationsleiste Bundesautobahnen<br />Navigationsleiste brasilianische Botschafter<br />Navigationsleiste Boeing Hubschrauber|blau}}<br />
…</div>
|}
|- class="hintergrundfarbe1"
|colspan="2"| Wird versucht, um das Lemma oder den Benutzernamen Klammern zur Verlinkung <nowiki>[[]]</nowiki>, Vorlageneinbindung <nowiki>{{}}</nowiki> oder als Codeformatierung durch [[Hilfe:Tags|Tags]] &lt;&gt; einzufügen, so wird das Eingabefeld rot umrandet. Der Versuch ein Pipe&nbsp;<code>|</code> im Feld zu setzen hat dieselbe Wirkung, während ein Schrägstrich <code>/</code> bislang nicht moniert wird (obwohl in Benutzernamen unzulässig). Auch eine Löschung der Eingabe führt zu dieser roten Anzeige, anschließend bleibt das leere Eingabefeld <span style="border: 1px solid #DD0000; border-radius: 3px; padding: 2px;">rot</span> gekennzeichnet, bis es wieder aktiv angeklickt wird. Eine Meldung erfolgt nicht. Beide Typen sorgen für eine Beschränkung von maximal 255 im Eingabefeld, sobald diese Zahl überschritten wird, wird das Feld ebenfalls rot umrandet dargestellt. Benutzernamen wären allerdings auf 34 Zeichen beschränkt.
----
{{Info}} [[Wikitext|Wiksyntax]], die Links oder Code erzeugen würde, wird im Eingabefeld erkannt. Eine solche Eingabe sollte nicht übernommen oder gar gespeichert werden, da sie unvorhergesehene Effekte erzeugen kann.
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Lemma/Benutzer/File/Template'''
|-
| {{Hilfe/inputarea |border=2 |content=&#91;[ |typ=d}}<!-- da stimmt etwas nicht das sieht eher lila umrahmt aus oder anders 1px blau 1px rot-->
|}
|- class="hintergrundfarbe5"
! colspan="2"|
|- id="type.line"
| '''line'''
<syntaxhighlight lang="javascript">
"Kurztext": {
  …
  "type": "line",
  …
},
</syntaxhighlight>
|
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Kurztext'''
|-
| {{Hilfe/inputarea |border= 2 |typ= p}}
|}
{{Info}} Es erfolgt während der Eingabe „keine“ automatische Beschränkung der Textlänge, jegliche Eingabeformen sind möglich.<ref name="Stand" />
|- class="hintergrundfarbe5"
! colspan="2"|
|- class="hintergrundfarbe1"
|colspan="2"| Der Parameter ist als [[boolean|boolesche Variable]] deklariert und erwartet einen Wert <code>0</code> oder <code>1</code>. Dies kann im Dialogfeld über eine [[Checkbox]] abgefragt werden. Hier sollte ein Autowert vorgegeben werden, damit die Anzeige einer Box anstelle eines Texteingabefeldes bereits beim Aufruf der Vorlage erzeugt wird. Fehlt die [[#p.autovalue|Autovorgabe]], so wird geprüft, ob eine Eingabe im Textfeld erfolgt ist.
|- id="type.boolean"
| '''boolean'''
<syntaxhighlight lang="javascript">
"Ticbox": {
  …
  "type": "boolean",
  "autovalue": "0",
  …
},
</syntaxhighlight>
| Zwischen zwei Zuständen abfragen, Vorgabe „0“ = Checkbox nicht ausgewählt
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Ticbox'''
|-
| {{Hilfe/ticbox|OOJS=1|last=1|tic=0}}
|}
|-
|
<syntaxhighlight lang="javascript">
"Ticbox": {
  …
  "type": "boolean",
  "autovalue": "1",
  …
},
</syntaxhighlight>
| Zwischen zwei Zuständen abfragen, Vorgabe „1“ = Checkbox ausgewählt
{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Ticbox'''
|-
| {{Hilfe/ticbox|OOJS=1|last=1|tic=1|typ=p}}
|}
|-
|
<syntaxhighlight lang="javascript">
"Ticbox": {
  …
  "type": "boolean",
  …
},
</syntaxhighlight>
| Zwischen zwei Zuständen abfragen, ohne Vorgabe erzeugt keine Checkbox sondern ein Eingabefeld.<ref>Durch Eingabe von <code>0</code> oder <code>1</code> wandelt sich dieses Feld in eine Checkbox um.</ref>

{| style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''Ticbox'''
|-
| {{Hilfe/inputarea |border= 2 |content=Text |typ= p}}
|}
|- class="hintergrundfarbe5"
! colspan="2"|
|- class="hintergrundfarbe1"
|colspan="2"| Für diesen Parameter gibt es eine vordefinierte Vorschlagsliste. Die Werte können durch einfaches Anklicken übernommen werden.
|- id="type.suggestedvaues"
| '''suggestedvalues'''
<syntaxhighlight lang="javascript">
"lang": {
	"suggestedvalues": [
		"en",
        "fr",
		"la",
        "es",
        "it",
        "ru",
        "…"
	]
},
</syntaxhighlight>
|
{| class="toptextcells" style="border:1px solid #BBBBBB; width:30em; border-radius:3px; font-size:90%;"
|-
| '''lang'''
|-
| <div style="border: 1px solid #BBBBBB; border-radius: 3px;"><div style="margin-top:-4px;">{{Hilfe/inputarea |border=2 |placeholder=Standard: deutschsprachig |typ=p |expand=1}}</div>
{| class="toptextcells" style="width: 100%; padding: 2px; line-height:1em;"
|-
| en
|-
| fr
|-
| la
|-
| es
|-
| it
|-
| ru
|-
| …
|}</div>
|}
|}</onlyinclude>

== Anmerkungen ==
<references />

{{Hilfe/Weitere Informationen|Liste=
* [[Hilfe:Vorlagendokumentation]]
* [[Hilfe:TemplateData/JSON]]
* [[Hilfe:Vorlagen/VisualEditor]]
}}
<noinclude>
[[Kategorie:Hilfe:VisualEditor]]
[[Kategorie:Hilfe:Vorlagen]]
</noinclude>