Quelltext der Seite Vorlage:Box/Doku

{{DU}}
{{high-use}}
{{Benutzt Templatestyles}}
== Verwendung ==
* '''Funktion:''' Diese Vorlage dient dazu, den Textkörper und Titel von Textboxen auf den Portalseiten zu formatieren.
* '''Verwendung:'''
** {{Tlc|Box|{{Var|title{{=}}Titel}}|{{Var|content{{=}}Vorlage}}|{{Var|color{{=}}Nummer}}|{{Var|id{{=}}anId}}|1{{=}}Text}}
* '''Optionale Parameter:'''
** {{Para|title}} Ausschrift im Kopf der Box.
** {{Para|color}} Nummer eines Farbmusters 
*** 1 = Blau
*** 2 = Grün
*** 3 = Rot
** {{Para|image}} Bild in der linken oberen Ecke.
** {{Para|content}} Name der einzufügenden Vorlage.
** {{Para|isFirst|yes}} Unterdrückt den oberen Rand der Box.
** {{Para|center|yes}} Zentriert die Überschrift.
** {{Para|expanded|yes}} Box wird einklappbar.
** {{Para|collapsed|yes}} Box wird ausklappbar.
** {{Para|styles}} CSS-Stile der gesamten Box.
** {{Para|textStyles}} CSS-Stile des Textteils.
** {{Para|imgStyles}} CSS-Stile des Bild-Containers.
** {{Para|position}} left, links, right, rechts, centered, mitte: Position einer textumflossenen Box.
** {{Para|width}} Breite der Box.
** {{Para|id}} Potentielles Sprungziel (Anker).
** {{Para|addClasses}} Zusätzliche Klassenbezeichner.

== Abgeleitete Vorlagen ==

* {{tl|Tipp}}, {{tl|Infobox}}, {{tl|Anekdote}}, {{tl|Maps}}, {{tl|Navigationsleiste}}

== Templatedata ==
<templatedata>
{
	"description": "Erstellt eine hervorgehobene Textbox",
	"params": {
		"1": {
			"label": "Text in der Textbox",
			"description": "Hier wird der in der Textbox darzustellende Textinhalt eingetragen.",
			"type": "string",
			"required": true,
			"aliases": [
				"text"
			]
		},
		"title": {
			"label": "Titel der Textbox",
			"description": "Der Titel wird, wenn angegeben, oberhalb der Box dargestellt.",
			"type": "string",
			"required": false
		},
		"color": {
			"label": "Farbmuster",
			"description": "Nummer des Farbmusters. Gegenwärtig werden 1 (Standard) und 2 unterstützt.",
			"type": "number",
			"required": false
		},
		"content": {
			"label": "Name der einzufügenden Vorlage",
			"description": "Name einer Vorlage, die den anzuzeigenden Text enthält.",
			"type": "string",
			"required": false
		},
		"isFirst": {
			"label": "Oberste Box",
			"description": "ja, yes, wenn die Box das oberste Element ist.",
			"type": "string",
			"required": false
		},
		"center": {
			"label": "Zentrierung",
			"description": "Bewirkt mit ja, yes die Zentrierung des Titels.",
			"type": "string",
			"required": false,
			"example": "yes"
		},
		"styles": {
			"label": "Stilangaben",
			"description": "Weitere CSS-Stilangaben der Box",
			"type": "string",
			"required": false
		},
		"id": {
			"label": "Identifier",
			"description": "Identifier als mögliches Sprungziel.",
			"type": "string",
			"required": false
		},
		"textStyles": {
			"label": "Textstile",
			"description": "CSS-Stile des Textteils",
			"type": "string"
		},
		"position": {
			"label": "Position",
			"description": "Position einer möglichen textumflossenen Box",
			"example": "left, links, right, rechts, centered, mitte",
			"type": "string"
		},
		"width": {
			"label": "Breite",
			"description": "Breite der Box in CSS-Maßeinheiten",
			"example": "50%, 300px"
		},
		"addClasses": {
			"label": "Klassen",
			"description": "Zusätzliche Klassenbezeichner",
			"type": "line"
		},
		"expanded": {
			"label": "Ausgeklappt",
			"description": "Box wird mit yes einklappbar",
			"example": "yes",
			"type": "line"
		},
		"collapsed": {
			"label": "Eingeklappt",
			"description": "Box wird mit yes ausklappbar",
			"example": "yes",
			"type": "line"
		},
		"image": {
			"label": "Bild",
			"description": "Bild in der linken oberen Ecke",
			"type": "line"
		},
		"imgStyles": {
			"label": "Bildstile",
			"description": "CSS-Stile des Bild-Containers",
			"type": "string"
		}
	},
	"paramOrder": [
		"title",
		"center",
		"color",
		"image",
		"1",
		"content",
		"isFirst",
		"expanded",
		"collapsed",
		"position",
		"width",
		"styles",
		"textStyles",
		"imgStyles",
		"id",
		"addClasses"
	]
}
</templatedata>

== CSS-Stilvorlagen ==

* [[Vorlage:Box/styles.css]]

== Verwendete CSS-Klassenbezeichner ==

=== Bestandteile der Box ===

* <code>voy-box-wrapper</code> – Container für die gesamte Box.
* <code>voy-box-first</code> – Für <code>voy-box-wrapper</code> zusätzliche Klasse, die anzeigt, dass diese Box eine von mehreren folgenden Boxen ist.
* <code>voy-box-header</code> – Überschrift der Box.
* <code>voy-box-image</code> – Abbildung in der Box.
* <code>voy-box-content</code> – Textteil der Box.

=== Abgeleitete Vorlagen ===

* <code>voy-navigation-bar</code> – Für <code>voy-box-wrapper</code> zusätzliche Klasse für Navigationsleisten, siehe [[Vorlage:Navigationsleiste]].

=== Positionen der Box ===

* <code>voy-box-centered</code> – Für <code>voy-box-wrapper</code> zusätzliche Klasse, die eine mittige Positionierung bewirkt.
* <code>voy-box-left</code> – Für <code>voy-box-wrapper</code> zusätzliche Klasse, die eine linksbündige Positionierung bewirkt.
* <code>voy-box-right</code> – Für <code>voy-box-wrapper</code> zusätzliche Klasse, die eine rechtsbündige Positionierung bewirkt.

=== Farben der Box ===

* <code>voy-box-var-1</code> – Ergänzende Klasse zu <code>voy-box-wrapper</code>, die die erste Farbvariante (blau) für den/die Rahmen und die Überschrift definiert.
* <code>voy-box-var-2</code> – Ergänzende Klasse zu <code>voy-box-wrapper</code>, die die zweite Farbvariante (grün) für den/die Rahmen und die Überschrift definiert.
* <code>voy-box-var-3</code> – Ergänzende Klasse zu <code>voy-box-wrapper</code>, die die dritte Farbvariante (rot) für den/die Rahmen und die Überschrift definiert.

=== Elemente in der Überschrift ===

* <code>voy-box-edit-link</code> – Klasse für den Bearbeiten-Link.
* <code>mw-collapsible-toggle</code> – Klasse, die anzeigt, dass ein Einklappen-Link eingefügt werden soll.
* <code>mw-collapsed</code> – Klasse, die anzeigt, dass die Box eingeklappt ist.
* <code>mw-collapsible-content</code> – Klasse für Elemente, die beim Einklappen ausgeblendet werden sollen.

=== Formatierung ===

* <code>voy-text-center</code> – Klasse für zentrierte Darstellung in der Überschrift und im Textkörper.

== Generierter HTML-Quellcode ==

<syntaxhighlight lang="html">
<div class="voy-box-wrapper voy-box-var-1|voy-box-var-2|voy-box-var-3
 voy-box-centered|voy-box-left|voy-box-right voy-box-first mw-collapsible mw-collapsed addClasses"
 styles="width: width|40%; styles">

 <div class="voy-box-edit-link plainlinks">[ <a href="...">Bearbeiten</a> ]</div>
 <div class="voy-box-image mw-collapsible-content" style="imgStyles" }}>image</div>
 <div class="voy-box-header voy-text-center" id="id">title</div>
 <div class="voy-box-content mw-collapsible-content" style="textStyles" }}>{{content}}|text</div>
</div>
</syntaxhighlight>
{{Dokumentation Textboxen siehe auch}}
__NOTOC__ __NOEDITSECTION__
<includeonly><!-- Kategorien bitte hier, Interwiki-Links bitte nach Wikidata -->
{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|
[[Kategorie:Vorlagen:Textboxen]][[Kategorie:Vorlagen:Infoboxen‎]]
[[Kategorie:Vorlagen:Klappbare Elemente]]
[[Kategorie:Vorlagen:Corporate Design]]
}}</includeonly>