Spezifikationstabellen
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
Jede Referenzseite auf MDN sollte Informationen über die Spezifikation(en) bereitstellen, in der/denen diese API oder Technologie definiert wurde. Dieser Artikel zeigt, wie diese Tabellen aussehen und erklärt, wie man sie hinzufügt.
Die Definition des Spezifikationsabschnitts ist ähnlich der Definition der Kompatibilitätstabelle, wird häufig aus derselben Datenquelle generiert und erscheint typischerweise direkt davor auf einer Seite.
Standard-Spezifikationstabellen
Der Standard-Spezifikationsabschnitt sollte wie folgt aussehen:
## Specifications
{{Specifications}}
Das {{Specifications}}
-Makro generiert die Spezifikationstabelle basierend auf dem/den Wert(en) im Front-Matter der Seite.
Standardmäßig werden die Werte im browser-compat
-Schlüssel verwendet.
Jeder Wert verweist auf ein bestimmtes Feature sowie dessen zugehörige Kompatibilitäts- und Spezifikationsinformationen im browser-compat-data-Repository.
Zum Beispiel hat die text-align
-Seite den folgenden Schlüssel, den sie verwendet, um die zugehörigen Spezifikationsinformationen abzurufen.
browser-compat: css.property.text-align
Einige Features werden in dem oben genannten Repository nicht gepflegt.
In diesen Fällen können Spezifikationsinformationen mithilfe des spec-urls
-Schlüssels zum Front-Matter der Seite hinzugefügt werden.
Zum Beispiel hat das aria-atomic
Attribut den Front-Matter-Schlüssel:
spec-urls: https://w3c.github.io/aria/#aria-atomic
Die Spezifikationstabelle für den css.property.text-align
-Schlüssel oben wird in einer Tabelle wie folgt dargestellt:
Spezifikationen
Specification |
---|
CSS Logical Properties and Values Level 1 # text-align |
CSS Text Module Level 3 # text-align-property |
Nicht standardisierte Features
Beim Dokumentieren eines nicht standardisierten Features, insbesondere eines, das aus einem Standardisierungspfad entfernt wurde, sollten Sie das {{Specifications}}
-Makro nicht aufrufen.
Stattdessen versuchen Sie, Informationen über den Status des Features und mögliche Alternativen bereitzustellen. Beispiele:
- Diese Methode befindet sich nicht mehr auf einem Standardisierungspfad. Sie wird aus Kompatibilitätsgründen beibehalten. Verwenden Sie stattdessen diese andere Methode.
- Diese Methode war ursprünglich Teil von DOM Level 2 Traversal and Range, ist aber in der aktuellen DOM-Spezifikation nicht vorhanden. Dieses Feature befindet sich nicht mehr auf dem Weg, ein Standard zu werden.
- Dieser Ereignis-Handler war Teil der alten WebVR API, die durch die WebXR Device API ersetzt wurde. Es ist nicht mehr auf dem Weg, ein Standard zu werden.