Funktionsstatus

Ein Funktionsstatus gibt im Allgemeinen den Stand der plattformübergreifenden Implementierung und Standardisierung eines bestimmten Webplattform-Features an, wie zum Beispiel einer Web-API-Methode oder einer CSS-Eigenschaft.

Es kann einer der folgenden sein:

Warnung: Aktualisieren Sie die Funktionsstatus nicht manuell im mdn/content-Repository. Die Quelle der Dokumentation wird automatisch aktualisiert basierend auf Informationen im GitHub-Repository mdn/browser-compat-data.

Wenn keiner der oben genannten Status zutrifft, wird die Funktion als stabil und standardisiert betrachtet. Weitere Informationen zu diesen Begriffen finden Sie auf der Seite "Experimental, deprecated, and obsolete".

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

Wie werden Funktionsstatus hinzugefügt oder aktualisiert?

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

Die Automatisierung verwendet den Schlüssel browser-compat im Front-Matter. Der Schlüssel speichert die BCD-Abfrage, die erforderlich ist, um das Feature in den Kompatibilitätsdaten zu lokalisieren. Wenn der browser-compat-Schlüssel mehrere Werte hat, verwendet die Automatisierung nur den ersten Wert, um Statusmakros darzustellen.

Hinweis: Um den Status eines Features im MDN-Inhalt zu aktualisieren, müssen Sie einen Pull-Request einreichen im BCD-Repository. Nachdem Ihre Änderungen genehmigt und in BCD zusammengeführt wurden, gehen sie in eine wöchentliche Veröffentlichung, und ein automatisierter Pull-Request aktualisiert die Status im mdn/content-Repository für jede Veröffentlichung.

Wie werden Funktionsstatus im Inhalt angegeben?

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

Funktionsstatussymbole in Seitenleisten

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

yaml

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

Funktionsstatusseitenbanner

Die folgenden Makros werden verwendet, um die Statusbanner in Seitenüberschriften darzustellen:

{{Deprecated_Header}}: Für den deprecated-Status. Es erzeugt ein Abgelaufen-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 den experimental-Status. Es erzeugt 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 den non-standard-Status. Es erzeugt ein Nicht-Standard-Status-Banner:
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Funktionsstatussymbole in Definitionslisten

Die folgenden Makros werden verwendet, um Inline-Statussymbole neben den Elementen der Definitionsliste darzustellen:

{{Experimental_Inline}} Symbol: Experimentell
{{Non-standard_Inline}} Symbol: Nicht standardisiert
{{Deprecated_Inline}} Symbol: Veraltet

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