Funktionsstatus

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

Ein Funktionsstatus gibt im Wesentlichen den plattformübergreifenden Implementierungs- und Standardisierungsstand einer bestimmten Web-Plattform-Funktion an, wie z.B. eine Web-API-Methode oder eine CSS-Eigenschaft. Es handelt sich um einen der folgenden:

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".

Wie der Status einer Funktion bestimmt wird, erfahren 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 Funktionen werden im begleitenden @mdn/browser-compat-data (BCD)-Repository nachverfolgt. Eine Automatisierung aktualisiert die Status im mdn/content-Repository automatisch, wenn 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 Lokalisierung der Funktion in den Kompatibilitätsdaten erforderliche BCD-Abfrage. Wenn der browser-compat-Schlüssel mehrere Werte hat, verwendet die Automatisierung nur den ersten Wert, um Statusmakros darzustellen.

Hinweis: Um den Status einer Funktion 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, aktualisiert ein automatisierter Pull-Request die Status im mdn/content-Repository.

Wie werden Funktionsstatus im Inhalt angegeben?

Die folgenden Abschnitte dokumentieren die Mechanismen, die zum Einfügen und Darstellen von Funktionsstatusinformationen in MDN-Dokumenten verwendet werden. Wie bereits erwähnt, sollten diese nur lesbar sein, da ihre Aufnahme in den Inhalt automatisiert ist.

Funktionsstatus-Symbole in Seitenleisten

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

yml

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

Funktionsstatus-Seitenbanner

Die folgenden Makros werden verwendet, um die Statusbanner in Seitenköpfen darzustellen:

{{Deprecated_Header}}: Für den deprecated-Status. 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 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 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.

Funktionsstatus-Symbole in Definitionslisten

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

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

Wenn eine Webseite mit Funktionsbannern gekennzeichnet ist, werden die Inline-Makros desselben Status explizit für jedes Mitglied/Wert der Funktion in der Definitionsliste verwendet. Zum Beispiel, wenn eine Seite als experimentell mit {{SeeCompatTable}} markiert ist, dann wird jedes Mitglied/Wert der Funktion explizit experimentell mit dem {{Experimental_Inline}}-Makro in der Definitionsliste gekennzeichnet.