Feature-Status

Warnung: Aktualisieren Sie nicht manuell die Feature-Status im mdn/content Repository. Die Dokumentationsquelle wird automatisch aktualisiert anhand von Informationen im GitHub-Repository mdn/browser-compat-data.

Ein Feature-Status zeigt im Allgemeinen an, wie der Stand der Implementierung und Standardisierung einer bestimmten Webplattform-Funktion ist, wie zum Beispiel einer Web-API-Methode oder einer CSS-Eigenschaft. Es ist einer der folgenden:

Wenn keiner der oben genannten Status zutrifft, wird das Feature als stabiles und standardisiertes Feature angesehen. Für weitere Informationen zu diesen Begriffen, siehe die Seite "Experimentell, veraltet und obsolet".

Informationen darüber, wie der Status für ein Feature festgelegt wird, finden Sie im Abschnitt Wahl der Status-Eigenschaften im @mdn/browser-compat-data (BCD) Repository.

Wie werden Feature-Status hinzugefügt oder aktualisiert?

Die Feature-Status aller auf MDN dokumentierten Features werden im dazugehörigen @mdn/browser-compat-data (BCD) Repository nachverfolgt. Eine Automatisierung aktualisiert die Status automatisch im mdn/content Repository, wann immer eine neue Version von BCD veröffentlicht wird.

Die Automatisierung verwendet den browser-compat Schlüssel im Front-Matter. Der Schlüssel speichert die für die Suche im Kompatibilitätsdaten notwendigen BCD-Abfrage. Wenn der browser-compat Schlüssel mehrere Werte hat, verwendet die Automatisierung nur den ersten Wert, um Status-Makros zu rendern.

Hinweis: Um den Status eines Features im MDN-Inhalt zu aktualisieren, müssen Sie einen Pull-Request einreichen im BCD-Repository. Nachdem Ihre Änderungen in BCD genehmigt und zusammengeführt wurden, aktualisiert ein automatisierter Pull-Request die Status im mdn/content Repository.

Wie werden Feature-Status im Inhalt spezifiziert?

Die folgenden Abschnitte dokumentieren die Mechanismen, die verwendet werden, um Feature-Statusinformationen in MDN-Dokumenten einzufügen und darzustellen. Wie erwähnt, sollten diese als schreibgeschützt betrachtet werden, da ihre Einbindung in den Inhalt automatisiert ist.

Feature-Status-Symbole in Seitenleisten

Die status-Eigenschaft im Seiten-Front-Matter wird verwendet, um Status-Symbole für Features zu generieren, wenn sie in Seitenleisten angezeigt werden.

yml
---
title: Feature name
status:
  - deprecated
  - experimental
  - non-standard
browser-compat: api.feature
---

Feature-Status-Seitenbanner

Die folgenden Makros werden verwendet, um die Status-Banner in Seitenköpfen darzustellen:

{{Deprecated_Header}}

Für deprecated Status. Es generiert ein Veraltet-Status-Banner:

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

{{SeeCompatTable}}

Für experimental Status. Es generiert ein Experimentell-Status-Banner:

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

{{Non-standard_Header}}

Für non-standard Status. Es generiert ein Nicht-Standard-Status-Banner:

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.

Feature-Status-Symbole in Definitionslisten

Die folgenden Makros werden verwendet, um Inline-Status-Symbole neben Einträgen in Definitionslisten darzustellen:

Wenn eine Web-Feature-Seite Status-Banner hat, werden die Inline-Makros für dieselben Status explizit für jedes Element/Wert des Features in der Definitionsliste verwendet. Zum Beispiel, wenn eine Seite mit {{SeeCompatTable}} als experimentell markiert ist, dann wird jedes Element/Wert des Features explizit als experimentell mit dem {{Experimental_Inline}} Makro in der Definitionsliste markiert.

Siehe auch