Zum Inhalt springen

Vorlage:Kasten/Doku

Aus Wikibooks

Verwendung

[Bearbeiten]

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

[Bearbeiten]

Der inhalt-Parameter

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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]

ParameterBeschreibungTypStatus
Inhaltinhalt 1

Der Inhalt des Kastens.

Wikitexterforderlich
Stylestyle

Das Design des Kastens.

Einzeiliger Textvorgeschlagen
Positionposition

Die Positionierung und Ausrichtung des Kastens.

Standard
ganze Breite
Einzeiliger Textoptional
Breitewidth

Die Breite des Kastens.

Einzeiliger Textoptional
Maximale Breitemax-width

Die maximale Breite des Kastens.

Einzeiliger Textoptional
Minimale Breitemin-width

Die minimale Breite des Kastens.

Standard
15em
Einzeiliger Textoptional
Außenabstandaußenabstand

Außenabstand bei mittig zentrierten Kästen.

Einzeiliger Textoptional
Clearclear

Wert der CSS-Eigenschaft „clear“.

Einzeiliger Textoptional
Inline?inline

Setze diesen Parameter auf „ja“, wenn der Inhalt nur Inline-Text ist.

Standard
nein
Einzeiliger Textoptional
No-Mobile?nomobile

Setze diesen Parameter auf „ja“, wenn der Inhalt auf mobilen Seiten versteckt werden soll.

Einzeiliger Textoptional
No-Print?noprint

Setze diesen Parameter auf „ja“, wenn der Inhalt in der Druckversion der Seite versteckt werden soll.

Einzeiliger Textoptional
Mf-IDmf-id

MF-ID (siehe Vorlagendokumentation)

Einzeiliger Textoptional
Kasten-Tag-Namehtml-tag

Name des HTML Tag Namens für den Kasten

Standard
div
Einzeiliger Textoptional
IDid

Setzt das HTML-Attribut id des Kastens.

Einzeiliger Textoptional
Float-Objekte beachten?float-objekte-beachten

Sollen anderene gefloatete Objekte für die Breitenbestimmung berücksichtigt werden?

Standard
ja
Einzeiliger Textoptional
Weiteres CSScss

Weiteres CSS für den Kasten

Einzeiliger Textoptional

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.