Tablas de especificaciones
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
* Some parts of this feature may have varying levels of support.
Cada página de referencia en MDN debe proporcionar información sobre la especificación o especificaciones en las que se definió esa API o tecnología. Este artículo muestra el aspecto de estas tablas y explica cómo agregarlas.
La definición de la sección de especificaciones es similar a la definición de la tabla de compatibilidad, comúnmente se genera a partir de la misma fuente de datos y, por lo general, aparece inmediatamente antes de esta en una página.
Tablas de especificaciones estándar
La sección de especificaciones estándar debería verse así:
## Especificaciones
{{Specifications}}
La macro {{Specifications}} genera la tabla de especificaciones basándose en los valores del front-matter de la página.
Por defecto, la macro utiliza los valores de la clave browser-compat.
Cada valor hace referencia a una característica particular y a su información de compatibilidad y especificación asociada en el repositorio browser-compat-data.
Por ejemplo, la página text-align tiene la siguiente clave, que utiliza para obtener la información de especificación asociada.
browser-compat: css.property.text-align
Algunas características no se mantienen en el repositorio anterior.
En estos casos, la información de especificación se puede agregar al front-matter de la página usando la clave spec-urls.
Por ejemplo, el atributo aria-atomic tiene la clave en el front-matter:
spec-urls: https://w3c.github.io/aria/#aria-atomic
La macro genera la tabla de especificaciones para la clave css.property.text-align anterior como se muestra a continuación:
Especificaciones
| Specification |
|---|
| CSS Logical Properties and Values Module Level 1 # text-align |
| CSS Text Module Level 3 # text-align-property |
Características no estándar
Al documentar una característica no estándar, en particular una que se haya eliminado de un proceso de estandarización, no se debe llamar a la macro {{Specifications}}.
En su lugar, se debe intentar proporcionar información sobre el estado de la característica y las posibles alternativas. Ejemplos:
- Este método ya no está en proceso de estandarización. Se conserva por motivos de compatibilidad. Utilizar este otro método en su lugar.
- Este método originalmente formaba parte de DOM Level 2 Traversal and Range, pero está ausente en la especificación DOM actual. Esta característica ya no está en camino de convertirse en un estándar.
- Este manejador de eventos era parte de la antigua WebVR API que ha sido reemplazada por la WebXR Device API. Ya no está en camino de convertirse en un estándar.