Benutzer:Sonne7/Vorlagen/Vorlage:Box

< Benutzer:Sonne7
Version vom 12. April 2021, 04:55 Uhr von Sonne7 (Diskussion | Beiträge) (Erweiterung vom Code und vom Abschnitt 'Parameter' (Doku mit Tab.) um die Unterstützung vom ersten unbenannten Parameter ('1' m. Fehlerfall) sowie Änderung der Beispiele im Abschnitt 'Anwendung' (Tab. m. v.a. WikiSyntax+Ergebnis) + neues Fehlerfall-Bsp.)
-fehlende-'Text'-Angabe-

Parameter

Durch die ursprünglich gesamt 5 Parameter dieser Vorlage 'Box' (mit der deutschen Wikipedia als inzwischen obsolete Quelle) werden zusätzlich zur Angabe vom auszugebenden Text sowohl die Farbangaben für den Rahmen, den Hintergrund und die Schrift als auch die Angabe der Rahmenbreite unterstützt. Durch die weiteren 2 Parameter (nicht von der deutschen Wikipedia sowie in der Tabelle bei 'Anmerkung' mit '(neu)' markiert) werden nun auch die beiden Angaben für den äußeren und inneren Abstand (jeweils einheitlich für oben/links/unten/rechts) unterstützt.

Gesamt sind es 7 Parameter, wovon die 6 Daten-Parameter alle einen Defaultwert (in der Tabelle angegeben) haben und somit nur die Textangabe keinen nutzbaren Defaultwert hat (nur eine Fehlerausgabe wird diesbezüglich bereitgestellt). Die Textangabe kann nun alternativ auch in Form des ersten unbenannten Parameters angeführt werden.

In der Tabelle ist zu jedem Parameter dessen Name (in der Wiki-Syntax), die durch ihn bewirkte 'CSS-Funktion' (also die so setzbare CSS-Eigenschaft), dessen Bedeutung (textuelle Benennung) sowie dessen Defaultwert (entweder ein Farbwert oder eine Zahl) und eine ihm zugehörige Anmerkung (Hinweis zur Einheitsangabe oder zum Defaultwert sowie wo zutreffend auch die Markierung 'neu')) angeführt.

Name CSS-Funktion Bedeutung Defaultwert Anmerkung
bw border-width Rahmenbreite 2 Angabe ohne 'px'
bc border-color Rahmenfarbe #DDDDDD (default ist grau)
m margin Äußerer Abstand 0 Angabe ohne 'px' / (neu)
p padding Innerer Abstand 3 Angabe ohne 'px' / (neu)
b background Hintergrundfarbe #FFFFFF (default ist weiß)
c color Textfarbe #000000 (default ist schwarz)
Text
1
- Inhalt - (kein default)

Anwendung

Der praktische Einsatz dieser Vorlage wird anhand von 3 Beispielen demonstriert, die jeweils aus einer 'Wiki-Syntax' (Code) und deren 'Ergebnis' (Grafik) sowie als 'Anmerkung' der ergänzenden Angabe der Anzahl bzw. Art der darin genutzten Parameter bestehen. Ergänzend ist auch in selbiger Form zusätzlich noch 1 'Fehlerfall'-Beispiel angeführt.

Wiki-Syntax Ergebnis Anmerkung
Beispiel 1:   {{Benutzer:Sonne7/Vorlagen/Vorlage:Box|Beispieltext 1}}  
Beispieltext 1
 
alle Default-Parameter + Text
Beispiel 2:   {{Benutzer:Sonne7/Vorlagen/Vorlage:Box|bw=5|bc=lightcyan|b=darkcyan|c=white|Text=Beispieltext 2}}  
Beispieltext 2
 
4 Parameter (alle alt) + Text
Beispiel 3:   {{Benutzer:Sonne7/Vorlagen/Vorlage:Box|bw=1|bc=darkred|m=4|p=1|b=lightyellow|c=green|'''Beispieltext 3'''}}  
Beispieltext 3
 
6 Parameter (4 alt & 2 neu) + Text
Fehlerfall:   {{Benutzer:Sonne7/Vorlagen/Vorlage:Box|b=skyblue}}  
-fehlende-'Text'-Angabe-
 
Fehleranzeige:
Kein Parameter 'Text' angegeben!

Kopiervorlage:
Zur praktischen Nutzung dieser Vorlage dient die folgende einzeilige Kopiervorlage, die alle 7 Parameter der Vorlage beinhaltet. (Anm.: Nicht benötigte Parameter kann man nach kopieren des Inhalts der einzeiligen Kopiervorlage aus der so erstellten Kopie entfernen, was für den jeweiligen Parameter mit dem Namen '*' in Form des entsprechenden '|*='-Teils erfolgt).

{{Benutzer:Sonne7/Vorlagen/Vorlage:Box|bw= |bc= |m= |p= |b= |c= |Text= }}

Anmerkung: Zukünftig, wenn diese Vorlage 'Box' im globalen Vorlagenraum ('Vorlage:') steht, vereinfacht sich die Kopiervorlage zu {{Box|bw= |bc= |m= |p= |b= |c= |Text= }}, was bei weitem handlicher aussieht, bzw. das Minimum davon sogar zu {{Box|Text= }}.

Hinweis: Quelle der originalen 'Vorlage:Box' (mit gesamt 5 Parametern) war die deutsche Wikipedia, bei der diese aber inzwischen als obsolete (und somit logisch auch als zumindest zukünftig zu löschend) gesehen wird.