Feature-Status

Ein Feature-Status bietet Entwicklern Informationen über den Implementierungsstand eines Features bei Browser-Anbietern und ist einer der folgenden:

Wenn keiner der obigen Status zutrifft, wird das Feature als stabiles und standardisiertes Feature angesehen. Dieser Status wird nicht explizit auf Inhaltsseiten hinzugefügt. Weitere Informationen zu diesen Begriffen finden Sie auf der Seite "Experimental, deprecated, and obsolete".

Detaillierte Anweisungen zur Auswahl eines Status für ein Feature finden Sie im Abschnitt choosing status properties im @mdn/browser-compat-data (BCD)-Repository.

Anleitung zum Hinzufügen oder Aktualisieren von Feature-Status

Die Feature-Status aller auf MDN dokumentierten Features sind im zugehörigen @mdn/browser-compat-data (BCD)-Repository-Eintrag definiert und werden automatisch im mdn/content-Repository aktualisiert, sobald eine neue Version von BCD veröffentlicht wird.

Warnung: Aktualisieren Sie Feature-Status NICHT manuell im mdn/content-Repository. Um den Status eines Features zu aktualisieren, müssen Sie einen Pull-Request einreichen im BCD-Repository. Nachdem Ihre Änderungen genehmigt und in BCD zusammengeführt wurden, werden die Status mittels eines automatisierten Pull-Requests im mdn/content-Repository aktualisiert.

Die Automatisierung verwendet den Schlüssel browser-compat in den 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 enthält, verwendet die Automatisierung nur den ersten Wert, um Status-Makros darzustellen.

Wie werden Feature-Status in Inhalten angegeben?

Die folgenden Abschnitte dokumentieren Mechanismen, mit denen Feature-Status in MDN-Dokumenten dargestellt werden. Wie bereits erwähnt, sollten Sie diese Mechanismen als schreibgeschützt betrachten, da ihre Einbindung in den Inhalt automatisiert ist.

Feature-Status-Symbole in Sidebars

Um Status-Symbole für ein in Sidebars aufgeführtes Feature zu zeigen, wird die Front-Matter status-Eigenschaft verwendet:

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

Beim Rendern von Sidebars sucht der Code nach den Status in den Front-Matter jeder Seite. Wie bereits erwähnt, werden diese Status automatisch aktualisiert; Sie müssen sie nicht manuell ändern.

Feature-Status-Banner auf Seiten

Die folgenden Makros werden verwendet, um die Status-Banner in Seiten-Headern darzustellen:

{{SeeCompatTable}}

Für den experimental-Status. Es erzeugt ein Banner für den Experimentellen Status:

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 Banner für den Nicht-Standard-Status:

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.

{{Deprecated_Header}}

Für den deprecated-Status. Es erzeugt ein Banner für den Veralteten Status:

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.

Feature-Status-Symbole in Definitionslisten

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

Siehe auch