Feature-Status
Ein Feature-Status gibt allgemein den Stand der plattformübergreifenden Implementierung und Standardisierung einer bestimmten Webplattform-Funktion an, wie zum Beispiel einer Web-API-Methode oder einer CSS-Eigenschaft.
Ein Feature kann einen der folgenden Status haben:
Warnung:
Aktualisieren Sie die Feature-Status im mdn/content Repository nicht manuell.
Die Dokumentationsquelle wird automatisch aktualisiert mit Informationen aus dem GitHub mdn/browser-compat-data Repository.
Wenn keiner der oben genannten Status zutrifft, wird die Funktion als stabile und standardmäßige Funktion betrachtet. Für weitere Informationen zu diesen Begriffen, siehe die Seite "Experimental, deprecated, and obsolete".
Informationen darüber, wie der Status für eine Funktion bestimmt wird, finden Sie im Abschnitt choosing status properties im @mdn/browser-compat-data (BCD) Repository.
Wie Feature-Status hinzugefügt oder aktualisiert werden
Die Feature-Status aller auf MDN dokumentierten Funktionen werden im zugehörigen @mdn/browser-compat-data (BCD) Repository nachverfolgt. Eine Automatisierung aktualisiert automatisch die Status 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 BCD-Abfrage, die benötigt wird, um die Funktion in den Kompatibilitätsdaten zu finden. 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 im MDN-Inhalt zu aktualisieren, müssen Sie eine Pull-Request einreichen im BCD-Repository. Nachdem Ihre Änderungen genehmigt und in BCD gemerget wurden, fließen sie in eine wöchentliche Veröffentlichung ein, und eine automatisierte Pull-Request aktualisiert die Status im mdn/content Repository für jede Veröffentlichung.
Wie werden Feature-Status im Inhalt angegeben?
Die folgenden Abschnitte dokumentieren die Mechanismen, die verwendet werden, um Feature-Statusinformationen in MDN-Dokumente einzufügen und darzustellen. Wie erwähnt, sollten diese als schreibgeschützt betrachtet werden, da ihre Einfügung in den Inhalt automatisiert ist.
Feature-Status-Symbole in Seitenleisten
Die status-Eigenschaft im Frontmatter der Seite wird verwendet, um Symbole für den Status von Funktionen zu erzeugen, wenn diese in Seitenleisten angezeigt werden.
---
title: Feature name
status:
- deprecated
- experimental
- non-standard
browser-compat: api.feature
---
Feature-Status-Page-Banner
Die folgenden Makros werden verwendet, um die Status-Banner in Seitenüberschriften darzustellen:
{{Deprecated_Header}}-
Für den
deprecatedStatus. Es erzeugt ein Veralteter-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
experimentalStatus. Es erzeugt ein Experimenteller-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-standardStatus. 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.
Feature-Status-Symbole in Definitionslisten
Die folgenden Makros werden verwendet, um Inline-Status-Symbole neben Items von Definitionslisten darzustellen:
{{Experimental_Inline}}Icon:{{Non-standard_Inline}}Icon:{{Deprecated_Inline}}Icon:
Wenn eine Web-Feature-Seite Status-Banner hat, dann werden die Inline-Makros der gleichen 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 als experimentell mit dem {{Experimental_Inline}} Makro in der Definitionsliste markiert.