Vorlage:Navigationsleiste/Doku: Unterschied zwischen den Versionen

Aktuelle Version vom 13. Februar 2023, 17:46 Uhr

Dies ist eine nachgeordnete Seite der Dokumentation von Vorlage:Navigationsleiste.
Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Vorlage-Seite ist.

Verwendung

Funktion: Diese Vorlage dient der einheitlichen Darstellung von Navigationsleisten. Sie sollte nicht direkt verwendet, sondern über eine abgeleitete Vorlage. Die Möglichkeit des Ein- und Ausklappens besteht nur bei aktivierten JavaScript. Ist JavaScript deaktiviert, werden alle Navigationsleisten aufgeklappt angezeigt. Im Druck werden Navigationsleisten nicht ausgegeben, weil die Links nicht genutzt werden können.
Verwendung: {{Navigationsleiste}}

Erforderliche Parameter:
- |title= Titel
- |content= Inhalt

Optionale Parameter:
- |image= Bild
- |collapsed= yes: Navigationsleiste ist eingeklappt
- |styles= CSS-Stile der gesamten Box.
- |textStyles= CSS-Stile des Textteils.
- |imgStyles= CSS-Stile des Bild-Containers.
- |addClasses= Zusätzliche Klassenbezeichner.

CSS-Klassenbezeichner

voy-navigation-bar Zusätzlicher Klassenbezeichner des Containers
Weiterer Klassenbezeichner siehe unter Vorlage:Box

Individuelle Gestaltung

Die Einbindung der Sprachvorlage lässt sich über CSS individuell gestalten, entweder zentral über die Systemdatei Mediawiki:common.css oder benutzerspezifische Einstellungen Benutzer:<Dein Name>/common.css. Für Programmierer ist es damit auch möglich an jedem Feld per Javascript Änderungen vorzunehmen und Werkzeuge zu programmieren. Folgende Klassen wurden verwendet:

.voy-navigation-bar – Diese Klasse besitzen alle Navigationsleisten
.voy-navigation-block – Diese Klasse besitzen alle Navigationscontainer (siehe Vorlage {{Navigationsblock}})

Hier einige Beispiele zur Anwendung:

.voy-navigation-block, .voy-navigation-bar { display: none; } – Deaktiviert alle Navigationsleisten und -blöcke auf allen Seiten
.ns-0 .voy-navigation-bar { display: none; } – Deaktiviert alle Navigationsleisten auf Seiten im Hauptnamensraum (unsere Reiseartikel). Metaartikel, Diskussionsseiten usw. bleiben davon unberührt

weitere Vorlagen

{{Navigationsblock}} – Eine Vorlage, die mehrere Navigationsleisten zu einem Block zusammenfassen kann

Siehe auch

Wikivoyage:CSS-Klassen – Dokumentation der auf Wikivoyage verwendeten CSS-Klassen
MediaWiki:Common.css – Zentrale Datei mit den standardmäßigen Designvorgaben dieses Wikis (nur für Administratoren bearbeitbar)

TemplateData

Diese Vorlage dient der einheitlichen Darstellung von Navigationsleisten.

Vorlagenparameter
Parameter		Beschreibung	Typ	Status
title	`title`	Titel Beispiel Titel der navigationsleiste	Einzeiliger Text	erforderlich
Inhalt	`content`	Inhalt der Navigationsleiste	Mehrzeiliger Text	erforderlich
Bild	`image`	Bild in der linken oberen Ecke Beispiel [[Datei:Flag of the Netherlands.svg\|90px\|Flagge der Niederlande]]	Einzeiliger Text	optional
Eingeklappt	`collapsed`	Navigationsleiste zu Beginn eingeklappt Standard ausgeklappt Beispiel yes	Einzeiliger Text	optional
Stile	`styles`	CSS-Stile der Navigationsleiste	Mehrzeiliger Text	optional
Textstile	`textStyles`	CSS-Stile des Textteils	Mehrzeiliger Text	optional
Bildstile	`imgStyles`	CSS-Stile des Bild-Containers	Mehrzeiliger Text	optional
Weitere Klassen	`addClasses`	Zusätzliche Klassenbezeichner für die Navigationsleiste	Mehrzeiliger Text	optional

@@ Zeile 1: / Zeile 1: @@
 {{DU}}
-* '''Funktion:''' Diese Vorlage dient der einheitlichen Darstellung von Navigationsleisten. Sie sollte ''nicht direkt'' verwendet, sondern über eine abgeleitete Vorlage. Die Möglichkeit des Ein- und Ausklappens besteht nur bei aktivierten JavaScript. Ist JavaScript deaktiviert, werden alle Navigationsleisten aufgeklappt angezeigt.
+== Verwendung ==
-* '''Verwendung:''' <code><nowiki>{{Navigationsleiste|title=Titel|content=Inhalt|image=Bild}}</nowiki></code>
+* '''Funktion:''' Diese Vorlage dient der einheitlichen Darstellung von Navigationsleisten. Sie sollte ''nicht direkt'' verwendet, sondern über eine abgeleitete Vorlage. Die Möglichkeit des Ein- und Ausklappens besteht nur bei aktivierten JavaScript. Ist JavaScript deaktiviert, werden alle Navigationsleisten aufgeklappt angezeigt. Im Druck werden Navigationsleisten nicht ausgegeben, weil die Links nicht genutzt werden können.
+* '''Verwendung:''' {{Tlc|Navigationsleiste|title=Titel|content=Inhalt|image=Bild}}
 * '''Erforderliche Parameter:'''
-** <code><nowiki>|title=</nowiki></code> Titel
+** {{Para|title}} Titel
-** <code><nowiki>|content=</nowiki></code> Inhalt
+** {{Para|content}} Inhalt
 * '''Optionale Parameter:'''
-** <code><nowiki>|image=</nowiki></code> Bild
+** {{Para|image}} Bild
-* '''Siehe auch:'''
+** {{Para|collapsed}} yes: Navigationsleiste ist eingeklappt
-** [[MediaWiki:Common.css]]
+** {{Para|styles}} CSS-Stile der gesamten Box.
-** [[MediaWiki:Common.js]]
+** {{Para|textStyles}} CSS-Stile des Textteils.
-** [[MediaWiki:NavigationBar.js]]
+** {{Para|imgStyles}} CSS-Stile des Bild-Containers.
-* '''Konfiguration:'''
+** {{Para|addClasses}} Zusätzliche Klassenbezeichner.
-** Die JavaScript-Variable ''NavigationBarShowDefault'', die standardmäßig auf 1 gesetzt ist, legt die Anzahl Navigationsleisten fest, bis zu der ''alle'' Navigationsleisten aufgeklappt werden, ansonst zugeklappt sind. Der Wert dieser Variablen lässt sich in der nutzereigenen JavaScript-Datei [[Special:Mypage/monobook.js]] überschreiben.
-</div>
+== CSS-Klassenbezeichner ==
-__NOTOC__ __NOEDITSECTION__ <includeonly>[[Kategorie:Vorlagen:Navigationsleisten|0Navigationsleiste]]
+* <code>voy-navigation-bar</code> Zusätzlicher Klassenbezeichner des Containers
+* Weiterer Klassenbezeichner siehe unter [[Vorlage:Box]]
+{{Navigationsleiste Dokumentation allgemeine Informationen}}
+== TemplateData ==
+<templatedata>
+{
+	"params": {
+		"title": {
+			"description": "Titel",
+			"example": "Titel der navigationsleiste",
+			"type": "line",
+			"required": true
+		},
+		"content": {
+			"label": "Inhalt",
+			"description": "Inhalt der Navigationsleiste",
+			"type": "string",
+			"required": true
+		},
+		"image": {
+			"label": "Bild",
+			"description": "Bild in der linken oberen Ecke",
+			"example": "[[Datei:Flag of the Netherlands.svg|90px|Flagge der Niederlande]]",
+			"type": "line"
+		},
+		"collapsed": {
+			"label": "Eingeklappt",
+			"description": "Navigationsleiste zu Beginn eingeklappt",
+			"example": "yes",
+			"type": "line",
+			"default": "ausgeklappt"
+		},
+		"styles": {
+			"label": "Stile",
+			"description": "CSS-Stile der Navigationsleiste",
+			"type": "string"
+		},
+		"textStyles": {
+			"label": "Textstile",
+			"description": "CSS-Stile des Textteils",
+			"type": "string"
+		},
+		"imgStyles": {
+			"label": "Bildstile",
+			"description": "CSS-Stile des Bild-Containers",
+			"type": "string"
+		},
+		"addClasses": {
+			"label": "Weitere Klassen",
+			"description": "Zusätzliche Klassenbezeichner für die Navigationsleiste",
+			"type": "string"
+		}
+	},
+	"description": "Diese Vorlage dient der einheitlichen Darstellung von Navigationsleisten."
+}
+</templatedata>
+__NOTOC__ __NOEDITSECTION__ <includeonly>[[Kategorie:Vorlagen:Navigationsleisten/Hilfsvorlagen|Navigationsleiste]][[Kategorie:Vorlagen:Klappbare Elemente]]
 [[Kategorie:Vom Druck ausschließen|Navigationsleiste]]</includeonly>