Referenz - Seiten für den schnellen Überblick
bearbeitet von Matthias ScharwiesServus!
@Rolf B hatte mir vor einiger Zeit geschrieben, dass er die [HTML-Element-Referenz um Feld "Zusatztext" erweitert hat](https://forum.selfhtml.org/self/2022/aug/24/option-datalist-mit-mehr-als-einem-leerzeichen/1801536#m1801536). Trotzdem möchte ich erst einmal die **CSS-Referenz** vorstellen und dann diskutieren:
[**CSS/Eigenschaften/border**](https://wiki.selfhtml.org/wiki/CSS/Eigenschaften/border)
* die erste Zeile `{{CSS-Referenz-Eigenschaft| …}}` ruft eine [Vorlage mit vielen Parametern](https://wiki.selfhtml.org/wiki/Vorlage:CSS-Referenz-Eigenschaft) auf. Die ist geschützt, da sie mehr als 250mal aufgerufen wird. Änderungen **müssen vorher im Team besprochen werden**.
* eine kurze Einführung erklärt, was die Eigenschaft macht.
* dann folgt eine Tabelle mit …
- den möglichen Werten
- einer Zeile für die Vererbung steuernden Werte
- einer Zeile mit dem Defaultwert
* auf welche Elemente die Eigenschaft anwendbar ist
* ob sie vererbbar ist
* ob sie animierbar ist
* einer möglichen Angabe von caniuse
[![](/images/21246070-336d-11ed-b223-b42e9947ef30.png?size=medium)](/images/21246070-336d-11ed-b223-b42e9947ef30.png)
1. Sollte man die Tabelle evtl. in eine dl umwandeln?
- wie sollte man mehrere Zeilen dd einbauen - wohl eher nicht mit `<br>`, oder?
**2.** Der Satz mit den Vererbung steuernden Werten sollte nur dort stehen, wo ge- und vererbt werden kann, oder?
**3.** Wie kann man den Default-Wert stärker hervorheben? (Früher war es eine eigene Spalte; jetzt geht er imho unter.)
Konsens ist wohl, dass dieser Bereich frei von Problemen mit Browser-Unterstützung, etc bleibt.
Danach folgt:
[![](/images/dc7788ca-336d-11ed-a21a-b42e9947ef30.png?size=medium)](/images/dc7788ca-336d-11ed-a21a-b42e9947ef30.png)
Dort haben wir die Tabellen schon entfernt.
Das **Beispiel** soll sehr kurz sein. In der Erklärung kann man schon mögliche Probleme beim Einsatz aufwerfen.
Für Hinweise gibt es die 2 Parameter `Hinweis =`und `Tipp =` . Hier sollte eigentlich ein Satz stehen. Bei einer Liste in Mediawiki-Syntax `*` wird das erste li nicht gerendert, sondern als * dargestellt. Das habe ich hier mit einem vorangestelllten `<br>`gelöst.
Wichtig: **kurze** *Best practice*-Tipps und Warnungen sind ok, optimalerweise verlinken wir auf ein Tutorial mit Live-Beispielen!
Evtl. sollte man das `Siehe_auch`, das auf eins oder mehrere Tutorials verlinkt vor die Weblinks stellen.
Ich habe mal einen Versuch mit dl erstellt: [CSS/Eigenschaften/border-versuch](https://wiki.selfhtml.org/wiki/CSS/Eigenschaften/border-versuch). Ich persönlich würde zuerst das Wiki-Makeover abschließen, stelle das Projekt so aber schon mal vor.
# HTML-Referenz
Hier ein Beispiel für die HTML-Referenz: [HTML/Elemente/option](https://wiki.selfhtml.org/wiki/HTML/Elemente/option)
[![](/images/8698e4b0-336f-11ed-bfa1-b42e9947ef30.png?size=medium)](/images/8698e4b0-336f-11ed-bfa1-b42e9947ef30.png)
Ich weiß nicht, warum die Tabelle nach unten bis hinter die Weblinks gerutscht ist. Evtl lag es an der Länge des ganzen Tabellenblocks, der dann das Beispiel ganz nach unten verschoben hätte.
Hier würde ich auch versuchen wollen, die obere Tabelle durch dl zu ersetzen.
Bei der **Syntax** würde ich nur Start- und End-Tag darstellen, bei optional einen Link auf das entsprechende Tutorial. Die beiden Code-Beispiele würde ich weglassen, bei [body](https://wiki.selfhtml.org/wiki/HTML/Elemente/body#Weblinks) gab's schon mal einen der behauptete, dass wir so den Einsatz mehrerer body-Elemente propagieren würden.
Die zweite Tabelle `table.attribute-reference` hatte bis eben nur eine Breite von 60%; habe ich gerade auf 100% geändert. Evtl. sollte man hier wie bei den Universalattributen einen Verbergen-Modus einbauen.
# tl;dr
Was haltet ihr davon, das irgendwann so umzusetzen?
Herzliche Grüße
Matthias Scharwies
--
Einfach mal was von der [ToDo-Liste](https://wiki.selfhtml.org/wiki/Kategorie:ToDo) auf die Was-Solls-Liste setzen.“
Referenz - Seiten für den schnellen Überblick
bearbeitet von Matthias ScharwiesServus!
@Rolf B hatte mir vor einiger Zeit geschrieben, dass er die [HTML-Element-Referenz um Feld "Zusatztext" erweitert hat](https://forum.selfhtml.org/self/2022/aug/24/option-datalist-mit-mehr-als-einem-leerzeichen/1801536#m1801536). Trotzdem möchte ich erst einmal die **CSS-Referenz** vorstellen und dann diskutieren:
[**CSS/Eigenschaften/border**](https://wiki.selfhtml.org/wiki/CSS/Eigenschaften/border)
* die erste Zeile `{{CSS-Referenz-Eigenschaft| …}}` ruft eine [Vorlage mit vielen Parametern](https://wiki.selfhtml.org/wiki/Vorlage:CSS-Referenz-Eigenschaft) auf. Die ist geschützt, da sie mehr als 250mal aufgerufen wird. Änderungen **müssen vorher im Team besprochen werden**.
* eine kurze Einführung erklärt, was die Eigenschaft macht.
* dann folgt eine Tabelle mit …
- den möglichen Werten
- einer Zeile für die Vererbung steuernden Werte
- einer Zeile mit dem Defaultwert
* auf welche Elemente die Eigenschaft anwendbar ist
* ob sie vererbbar ist
* ob sie animierbar ist
* einer möglichen Angabe von caniuse
[![](/images/21246070-336d-11ed-b223-b42e9947ef30.png?size=medium)](/images/21246070-336d-11ed-b223-b42e9947ef30.png)
1. Sollte man die Tabelle evtl. in eine dl umwandeln?
- wie sollte man mehrere Zeilen dd einbauen - wohl eher nicht mit `<br>`, oder?
**2.** Der Satz mit den Vererbung steuernden Werten sollte nur dort stehen, wo ge- und vererbt werden kann, oder?
**3.** Wie kann man den Default-Wert stärker hervorheben? (Früher war es eine eigene Spalte; jetzt geht er imho unter.
Konsens ist wohl, dass dieser Bereich frei von Problemen mit Browser-Unterstützung, etc bleibt.
Danach folgt:
[![](/images/dc7788ca-336d-11ed-a21a-b42e9947ef30.png?size=medium)](/images/dc7788ca-336d-11ed-a21a-b42e9947ef30.png)
Dort haben wir die Tabellen schon entfernt.
Das **Beispiel** soll sehr kurz sein. In der Erklärung kann man schon mögliche Probleme beim Einsatz aufwerfen.
Für Hinweise gibt es die 2 Parameter `Hinweis =`und `Tipp =` . Hier sollte eigentlich ein Satz stehen. Bei einer Liste in Mediawiki-Syntax `*` wird das erste li nicht gerendert, sondern als * dargestellt. Das habe ich hier mit einem vorangestelllten `<br>`gelöst.
Wichtig: **kurze** *Best practice*-Tipps und Warnungen sind ok, optimalerweise verlinken wir auf ein Tutorial mit Live-Beispielen!
Evtl. sollte man das `Siehe_auch`, das auf eins oder mehrere Tutorials verlinkt vor die Weblinks stellen.
Ich habe mal einen Versuch mit dl erstellt: [CSS/Eigenschaften/border-versuch](https://wiki.selfhtml.org/wiki/CSS/Eigenschaften/border-versuch). Ich persönlich würde zuerst das Wiki-Makeover abschließen, stelle das Projekt so aber schon mal vor.
# HTML-Referenz
Hier ein Beispiel für die HTML-Referenz: [HTML/Elemente/option](https://wiki.selfhtml.org/wiki/HTML/Elemente/option)
[![](/images/8698e4b0-336f-11ed-bfa1-b42e9947ef30.png?size=medium)](/images/8698e4b0-336f-11ed-bfa1-b42e9947ef30.png)
Ich weiß nicht, warum die Tabelle nach unten bis hinter die Weblinks gerutscht ist. Evtl lag es an der Länge des ganzen Tabellenblocks, der dann das Beispiel ganz nach unten verschoben hätte.
Hier würde ich auch versuchen wollen, die obere Tabelle durch dl zu ersetzen.
Bei der **Syntax** würde ich nur Start- und End-Tag darstellen, bei optional einen Link auf das entsprechende Tutorial. Die beiden Code-Beispiele würde ich weglassen, bei [body](https://wiki.selfhtml.org/wiki/HTML/Elemente/body#Weblinks) gab's schon mal einen der behauptete, dass wir so den Einsatz mehrerer body-Elemente propagieren würden.
Die zweite tabelle `table.attribute-reference` hatte bis eben nur eine Breite von 60%; habe ich gerade auf 100% geändert. Evtl. sollte man hier wie bei den Universalattributen einen Verbergen-Modus einbauen.
# tl;dr
Was haltet ihr davon, das irgendwann so umzusetzen?
Herzliche Grüße
Matthias Scharwies
--
Einfach mal was von der [ToDo-Liste](https://wiki.selfhtml.org/wiki/Kategorie:ToDo) auf die Was-Solls-Liste setzen.“