Vorlage:Kasten/Doku

Verwendung

Diese Vorlage bindet einen Kasten mit vordefiniertem Design auf einer Seite ein. Diese Vorlage kann beispielsweise überall da benutzt werden, wo man mit Hilfe von speziellen <div>-Tags das Design einer Seite ändern möchte.

Beispiel:

{{Kasten
 |style=Info
 |inhalt={{Blindtext}}
}}

Ergebnis:

Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Die Parameter

Der inhalt-Parameter

Der Inhalt eines Kastens wird über den Parameter inhalt oder 1 gesetzt. Die beiden Aufrufe

{{Kasten|inhalt=Text}}

und

{{Kasten|Text}}

sind also gleichbedeutend.

Der style-Parameter

Mit Hilfe des Parameters style kann das Design eines Kastens gesteuert werden. Folgende Designstile sind vordefiniert:

Wert für style	Ergebnis
Info	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Hinweis	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Fehlermeldung	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Systemnachricht	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
grauer Rahmen	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
blauer Rahmen	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
blauer Kasten	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
grauer Kasten	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
dezenter grauer Kasten	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
keine Wert für style	Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Es können einfach auch weitere Styles definiert werden. Wenn du für deine Arbeit weitere Styles brauchst, dann melde dich bitte bei Benutzer:Stephan Kulla.

Der Parameter position

Durch den Parameter position wird die Ausrichtung, Positionierung und Breite der Box gesteuert. Folgende Werte sind möglich:

Wert für position	Ergebnis
ganze Breite	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
float rechts	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
float links	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
links	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
rechts	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
mittig	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
keine Angabe eines Wertes für position	Der Kasten Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Die Breite des Kastens

Die Breite des Kasten wird über die 3 Parameter max-width, min-width und width gesteuert. Diese Parameter haben folgende Bedeutungen

Parameter	Bedeutung	Link auf entsprechende CSS-Eigenschaft
max-width	Definiert die maximale Breite des Kastens.	max-width
min-width	Definiert die minimale Breite des Kastens.	min-width
width	Setzt die Breite des Kastens explizit.	width

Für alle Parameter können Werte wie beispielsweise 50% oder 20em eingetragen werden, die auch für die entsprechenden CSS-Eigenschaften verwendet werden können. Je nachdem, was für position eingetragen ist, haben die Parameter eine unterschiedliche Bedeutung:

Wert für position	Bedeutung der Parameter max-width, min-width und width
ganze Breite oder keine Angabe des Parameters position	Der Kasten nimmt stets 100% der verfügbaren Breite ein. max-width, min-width und width werden ignoriert.
float rechts oder float links	Ist width gesetzt, so hat der Kasten stets die von width definierte Breite. Ist width undefiniert, so definiert max-width die maximal mögliche und min-width die minimal mögliche Breite. Wenn width nicht definiert ist, ist der Kasten auch nie Breiter als es notwendig ist.
links oder rechts	Der Kasten hat stets die Breite von width. max-width und min-width werden ignoriert.
mittig	Der Kasten hat stets die Breite von width. Ist außenabstand gesetzt, so definiert dieser Parameter die Kastenbreite (siehe nächsten Abschnitt) und width wird ignoriert. max-width und min-width werden stets ignoriert.

Es gelten folgende Standardwerte:

Wert für position	Standardwerte für max-width	Standardwert für min-width	Standardwert für width
ganze Breite oder keine Angabe des Parameters position	wird ignoriert	15em	wird ignoriert
float rechts oder float links	25%	15em	nicht gesetzt
links oder rechts	wird ignoriert	15em	33%
mittig	wird ignoriert	15em	50%

Der Parameter außenabstand bei mittig positionierten Kästen

Eine Besonderheit gibt es, wenn position auf mittig gestellt ist. Hier gibt es nämlich zwei Möglichkeiten die Breite eines Kastens zu definieren. Einmal kann die Breite über die obig erklärten Parameter gesetzt werden, zum anderen kann die Breite des Kastens dadurch definiert werden, dass der Außenabstand vom Kasten zum linken Rand bzw. vom Kasten zum rechten Rand gesetzt wird. Dadurch ergibt sich bei einem mittig gesetzten Kasten automatisch seine Breite.

Hierzu dient der Parameter außenabstand. Dieser gibt bei einem mittig gesetzten Kasten den Abstand zu den Außenrändern an. Es können alle Werte gesetzt werden, die für die CSS-Eigenschaften margin-left bzw. margin-right erlaubt sind (Der Wert für außenabstand wird direkt für margin-left bzw. margin-right verwendet).

Beispiel:

{{Kasten
 |style=blauer Rahmen
 |außenabstand=50px
 |position=mittig
 |inhalt={{Blindtext}}
}}

Ergebnis:

Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Beachte, dass wenn außenabstand gesetzt ist, die Paramter width, max-width und min-width keine Anwendung finden, weil die Breite des Kastens bereits über den Außenabstand gesteuert wird.

Weitere Parameter

Diese Vorlage basiert auf Vorlage:HTMLTag. Folgende Parameter der Vorlage:HTMLTag können auch benutzt werden:

• html-tag
• inline (Der Standardwert für diese Vorlage ist inline=nein)
• clear
• float-objekte-beachten
• css
• class
• nomobile
• noprint
• id
• mf-id

Gründe für diese Vorlage

Nach Möglichkeit sollte kein HTML auf Wikibooks-Seiten direkt enthalten sein, da dies zum einen den Quelltext kompliziert und schlechter lesbar macht und weil zum anderen das HTML mit dem dazugehörigen CSS nur von Experten bearbeitet werden kann. Der Quelltext für eine Vorlageneinbindung ist im Gegensatz dazu einfacher zu verstehen. Außerdem lässt sich so das Design von Wikibooks zentral über Vorlagen steuern.

Vorlagen-Spezifikation

Vorlage, um einen Kasten mit spezifischen Inhalt einzubinden.

Vorlagenparameter[Vorlagendaten bearbeiten]

Parameter		Beschreibung	Typ	Status
Inhalt	inhalt 1	Der Inhalt des Kastens.	Inhalt	erforderlich
Style	style	Das Design des Kastens.	Zeile	vorgeschlagen
Position	position	Die Positionierung und Ausrichtung des Kastens. Standard ganze Breite	Zeile	optional
Breite	width	Die Breite des Kastens.	Zeile	optional
Maximale Breite	max-width	Die maximale Breite des Kastens.	Zeile	optional
Minimale Breite	min-width	Die minimale Breite des Kastens. Standard 15em	Zeile	optional
Außenabstand	außenabstand	Außenabstand bei mittig zentrierten Kästen.	Zeile	optional
Clear	clear	Wert der CSS-Eigenschaft „clear“.	Zeile	optional
Inline?	inline	Setze diesen Parameter auf „ja“, wenn der Inhalt nur Inline-Text ist. Standard nein	Zeile	optional
No-Mobile?	nomobile	Setze diesen Parameter auf „ja“, wenn der Inhalt auf mobilen Seiten versteckt werden soll.	Zeile	optional
No-Print?	noprint	Setze diesen Parameter auf „ja“, wenn der Inhalt in der Druckversion der Seite versteckt werden soll.	Zeile	optional
Mf-ID	mf-id	MF-ID (siehe Vorlagendokumentation)	Zeile	optional
Kasten-Tag-Name	html-tag	Name des HTML Tag Namens für den Kasten Standard div	Zeile	optional
ID	id	Setzt das HTML-Attribut id des Kastens.	Zeile	optional
Float-Objekte beachten?	float-objekte-beachten	Sollen anderene gefloatete Objekte für die Breitenbestimmung berücksichtigt werden? Standard ja	Zeile	optional
Weiteres CSS	css	Weiteres CSS für den Kasten	Zeile	optional

Hinweis: Diese Vorlagen-Spezifikation wurde mit Hilfe der Parsererweiterung <templatedata> erstellt. Siehe Vorlage:TemplateData für eine Erklärung, wie du <templatedata> auf Wikibooks verwenden kannst.

<templatedata> wird unter anderem vom VisualEditor verwendet. Eine ausführliche Hilfe zu dieser Parsererweiterung findest auf der Seite Help:TemplateData.