Estado de una característica
El estado de una característica indica, en términos generales, el estado de implementación y estandarización entre navegadores de una característica particular de la plataforma web, como un método de API web o una propiedad CSS.
Es uno de los siguientes:
Advertencia:
No actualices manualmente los estados de las características en el repositorio mdn/content.
La documentación se actualiza automáticamente a partir de la información del repositorio mdn/browser-compat-data en GitHub.
Si no se aplica ninguno de los estados anteriores, la característica se considera estable y estándar. Para más información sobre estos términos, consulta la página "Experimental, obsoleta y en desuso".
Para obtener información sobre cómo se determina el estado de una característica, consulta la sección choosing status properties en el repositorio @mdn/browser-compat-data (BCD).
¿Cómo se agregan o actualizan los estados de las características?
Los estados de todas las características documentadas en MDN se rastrean en su repositorio adjunto @mdn/browser-compat-data (BCD). Una automatización actualiza automáticamente los estados en el repositorio mdn/content cada vez que se publica una nueva versión de BCD.
La automatización utiliza la clave browser-compat en el front-matter. Esta clave almacena la consulta de BCD necesaria para localizar la característica en los datos de compatibilidad. Si la clave browser-compat tiene varios valores, la automatización usa únicamente el primero para renderizar las macros de estado.
Nota:
Para actualizar el estado de una característica en el contenido de MDN, tienes que enviar una pull request en el repositorio de BCD. Una vez que tus cambios sean aprobados y fusionados en BCD, se incluirán en una versión de lanzamiento semanal, y una pull request automatizada actualizará los estados en el repositorio mdn/content para cada versión de lanzamiento.
¿Cómo se especifican los estados de las características en el contenido?
Las siguientes secciones documentan los mecanismos que se utilizan para insertar y renderizar información sobre el estado de las características en los documentos de MDN. Como se mencionó, estos deben considerarse de solo lectura, ya que su inclusión en el contenido es automática.
Iconos de estado en las barras laterales
La propiedad status del front-matter de la página se utiliza para generar iconos de estado para las características cuando se muestran en las barras laterales.
---
title: Feature name
status:
- deprecated
- experimental
- non-standard
browser-compat: api.feature
---
Banners de estado en las páginas
Las siguientes macros se utilizan para renderizar los banners de estado en los encabezados de las páginas:
{{Deprecated_Header}}-
Para el estado
deprecated. Genera un banner de Estado obsoleto:Obsoleto: Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.
{{SeeCompatTable}}-
Para el estado
experimental. Genera un banner de Estado experimental:Experimental: Esta es una tecnología experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producción. {{Non-standard_Header}}-
Para el estado
non-standard. Genera un banner de Estado no estándar:No estándar: Esta función no está estandarizada. No recomendamos usar funciones no estándar en producción, ya que tienen un soporte limitado en los navegadores y pueden cambiar o eliminarse. Sin embargo, pueden ser una alternativa adecuada en casos específicos donde no exista una opción estándar.
Iconos de estado en las listas de definiciones
Las siguientes macros se utilizan para mostrar iconos de estado en línea junto a los elementos de la lista de definiciones:
{{Experimental_Inline}}icono:{{Non-standard_Inline}}icono:{{Deprecated_Inline}}icono:
Si una página de característica web tiene banners de estado, entonces las macros en línea de los mismos estados se utilizan explícitamente para cada miembro o valor de la característica en la lista de definiciones.
Por ejemplo, si una página está marcada como experimental usando {{SeeCompatTable}}, entonces cada miembro o valor de la característica se marca explícitamente como experimental usando la macro {{Experimental_Inline}} en la lista de definiciones.