Funktionsstatus

Ein Funktionsstatus gibt im Allgemeinen den plattformübergreifenden Implementierungs- und Standardisierungsstatus eines bestimmten Webplattform-Features an, wie z. B. einer Web-API-Methode oder einer CSS-Eigenschaft.

Es handelt sich um einen der folgenden:

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

Wenn keiner der oben genannten Status zutrifft, wird das Feature als stabiles und standardmäßiges Feature betrachtet. Für weitere Informationen zu diesen Begriffen siehe die Seite "Experimentell, veraltet und überholt".

Für Informationen dazu, wie der Status für ein Feature bestimmt wird, siehe den Abschnitt Auswahl von Status-Eigenschaften im @mdn/browser-compat-data (BCD) Repository.

Wie werden Funktionsstatus hinzugefügt oder aktualisiert?

Die Funktionsstatus aller auf MDN dokumentierten Features werden im begleitenden @mdn/browser-compat-data (BCD)-Repository nachverfolgt. Eine Automatisierung aktualisiert die Status im mdn/content-Repository automatisch, 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 eine 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 Status-Makros darzustellen.

Hinweis: Um den Status eines Features in den MDN-Inhalten zu aktualisieren, müssen Sie einen Pull-Request einreichen im BCD-Repository. Nach der Genehmigung und Zusammenführung Ihrer Änderungen in BCD geht es 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 in Inhalten angegeben?

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

Funktionsstatussymbole in Sidebars

Die status-Eigenschaft im Front-Matter der Seite wird verwendet, um Statussymbole für Features zu erzeugen, wenn sie in Sidebars angezeigt werden.

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

Funktionsstatus-Banner auf Seiten

Die folgenden Makros werden verwendet, um die Status-Banner in den Kopfzeilen der Seite darzustellen:

{{Deprecated_Header}}

Für den Status deprecated. Es erzeugt 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 den Status experimental. 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 Status non-standard. Es erzeugt 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.

Funktionsstatussymbole in Definitionslisten

Die folgenden Makros werden verwendet, um Inline-Statussymbole neben Definitionslisteneinträgen darzustellen:

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

Siehe auch