Feature-Status
Ein Feature-Status gibt im Allgemeinen den plattformübergreifenden Implementierungs- und Standardisierungsstatus einer bestimmten Webplattform-Funktion an, wie z.B. eine Web-API-Methode oder eine CSS-Eigenschaft.
Er kann einer der folgenden sein:
Warnung:
Aktualisieren Sie die Feature-Status im mdn/content Repository nicht manuell.
Die Dokumentationsquelle wird automatisch aktualisiert basierend auf Informationen im GitHub-Repository mdn/browser-compat-data.
Wenn keiner der oben genannten Status zutrifft, wird das Feature als stabiles und standardisiertes Feature betrachtet. Weitere Informationen zu diesen Begriffen finden Sie auf der Seite "Experimental, deprecated, and obsolete".
Um Informationen darüber zu erhalten, wie der Status für ein Feature bestimmt wird, sehen Sie sich den Abschnitt Choosing Status Properties im @mdn/browser-compat-data (BCD) Repository an.
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 verfolgt. 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 BCD-Abfrage, die erforderlich ist, um das Feature in den Kompatibilitätsdaten zu lokalisieren. Wenn der browser-compat Schlüssel mehrere Werte hat, wird nur der erste Wert verwendet, 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 im BCD zusammengeführt wurden, gehen Sie in eine wöchentliche Veröffentlichung, und ein automatisierter Pull Request aktualisiert die Status im mdn/content Repository bei jeder Veröffentlichung.
Wie werden Feature-Status im Inhalt spezifiziert?
Die folgenden Abschnitte dokumentieren die Mechanismen, die verwendet werden, um Statusinformationen in MDN-Dokumenten einzufügen und darzustellen. Wie erwähnt, sollten diese als nur lesbar betrachtet werden, da ihre Aufnahme in den Inhalt automatisiert ist.
Feature-Status-Icons in Seitenleisten
Die status-Eigenschaft im Seiten-Front Matter wird verwendet, um Status-Icons für Funktionen zu generieren, wenn sie in Seitenleisten angezeigt werden.
---
title: Feature name
status:
- deprecated
- experimental
- non-standard
browser-compat: api.feature
---
Feature-Status-Seitenbanner
Warnung:
Das {{Deprecated_Header}}-Makro ist nicht mehr erforderlich, um ein veraltetes Status-Banner zu generieren. Die Plattform generiert nun automatisch das Banner unter Verwendung der status Front Matter-Eigenschaft oder Daten von web-features.
Die folgenden Makros werden verwendet, um die Status-Banner in den Seitenüberschriften darzustellen:
{{SeeCompatTable}}-
Für den
experimentellenStatus. Es generiert ein experimentelles 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
nicht-standardisiertenStatus. Es generiert ein nicht-standardisiertes 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-Icons in Definitionslisten
Die folgenden Makros werden verwendet, um Inline-Status-Icons neben Einträgen in Definitionslisten darzustellen:
{{Experimental_Inline}}Icon:{{Non-standard_Inline}}Icon:{{Deprecated_Inline}}Icon:
Wenn eine Web-Feature-Seite Status-Banner hat, werden die Inline-Makros des gleichen Status explizit für jedes Mitglied/Wert des Features in der Definitionsliste verwendet.
Zum Beispiel, wenn eine Seite als experimentell mit {{SeeCompatTable}} markiert ist, dann wird jedes Mitglied/Wert des Features explizit als experimentell mit dem Makro {{Experimental_Inline}} in der Definitionsliste gekennzeichnet.