Plantilla de página de atributo HTML
Los atributos HTML se dividen en dos categorías: atributos específicos de elementos, que se aplican solo a ciertos elementos (p. ej., el atributo accept en <input type="file">), y atributos globales, que pueden usarse en cualquier elemento HTML (p. ej., class, id). Los primeros deben ubicarse en HTML/Reference/Attributes, mientras que los segundos deben ir en HTML/Reference/Global_attributes.
Ten en cuenta que la mayoría de los atributos específicos no necesitan artículos independientes si la lista de atributos en la referencia del elemento es suficiente para describir su comportamiento. Solo crea un artículo si el atributo tiene suficientes matices como para merecer sus propios ejemplos, o si es un atributo global.
Nota: Elimina toda esta nota explicativa antes de publicar.
Front matter de la página:
El front matter al principio de la página se usa para definir los "metadatos de la página". Los valores deben actualizarse adecuadamente para el atributo en cuestión.
---
title: nombre-del-atributo
slug: Web/HTML/Reference/Global_attributes/nombre-del-atributo
page-type: html-attribute
status:
- deprecated
- experimental
- non-standard
browser-compat: html.global_attributes.nombre-del-atributo
sidebar: htmlsidebar
---
- title
-
Encabezado del título que se muestra en la parte superior de la página. Formato:
nombre-del-atributo(solo el nombre del atributo). Por ejemplo, el atributoclasstiene un title declass. - slug
-
El final de la ruta URL después de
https://developer.mozilla.org/es/docs/. Tendrá el formatoWeb/HTML/Reference/Global_attributes/nombre-del-atributooWeb/HTML/Reference/Attributes/nombre-del-atributo, donde el nombre del atributo está en minúsculas. Por ejemplo, el atributoclasstiene un slug deWeb/HTML/Reference/Global_attributes/class. - page-type
-
Siempre
html-attribute. - status
-
Indicadores que describen el estado de esta funcionalidad. Es un arreglo que puede contener uno o más de los siguientes valores:
experimental,deprecated,non-standard. Esta clave no debe configurarse manualmente: se establece automáticamente según los valores en los datos de compatibilidad de navegadores. Consulta "Cómo se añaden o actualizan los estados de las funcionalidades". - browser-compat
-
Reemplaza el valor de marcador de posición
html.global_attributes.nombre-del-atributocon la cadena de consulta para el atributo global en el repositorio de datos de compatibilidad de navegadores. Para atributos específicos de elementos, usa el formatohtml.elements.nombre-del-elemento.nombre-del-atributo. La cadena de herramientas usa automáticamente esta clave para rellenar las secciones de compatibilidad y especificaciones (reemplazando las macros{{Compat}}y{{Specifications}}). -
Mantener como
htmlsidebar(todas las páginas bajo/web/html/usan esta barra lateral). Consulta Estructuras de página: barras laterales para más detalles.
Macros de la parte superior de la página
Varias llamadas a macros aparecen en la parte superior de la sección de contenido (inmediatamente después del front matter). Estas macros se añaden automáticamente mediante la cadena de herramientas (no es necesario añadirlas ni eliminarlas):
{{SeeCompatTable}}— genera un banner de Esta es una tecnología experimental que indica que la tecnología es experimental. Si es experimental y está oculta detrás de una preferencia en Firefox, también debes completar una entrada en la página Funcionalidades experimentales en Firefox.{{Deprecated_Header}}— genera un banner de Obsoleto que indica que el uso de la tecnología está desaconsejado.{{Non-standard_Header}}— genera un banner de No estándar que indica que la funcionalidad no forma parte de ninguna especificación.
No proporciones macros de encabezado de estado manualmente. Consulta la sección "Cómo se añaden o actualizan los estados de las funcionalidades" para añadir estos estados a la página.
Justo después de este bloque de notas se muestran ejemplos de los banners Experimental, Obsoleto y No estándar.
Recuerda eliminar toda esta nota explicativa antes de publicar.
Experimental: Esta es una tecnología experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producción.
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.
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.
Comienza presentando al lector el atributo y su uso.
Por ejemplo: El nombre-del-atributo atributo global describe o manipula [insertar descripción de uso].
Pruébalo
Esta sección es generada por la macro InteractiveExample. Incluye el título de la sección "Try it" y el editor de código. Consulta la sección de Ejemplos interactivos en nuestras Directrices de escritura para más información.
Si se incluye, síguelo con 1 o 2 párrafos breves que expliquen el comportamiento implementado y, opcionalmente, destaca cualquier interacción con JavaScript, CSS u otros atributos. Mantenlo conciso y evita duplicar la documentación completa; enlaza lo que sea necesario. Nuevamente, consulta la página del atributo class.
Valores
Proporciona una lista de los valores posibles para el atributo, si los hay (elimina si no aplica). Incluye el valor predeterminado si existe, y una breve descripción para cada valor.
Accesibilidad
Advierte sobre cualquier posible problema de accesibilidad que pueda existir al usar este atributo y cómo solucionarlo. Elimina esta sección si no hay nada que enumerar.
Ejemplos
Muestra ejemplos relevantes para este atributo y cómo usarlo en contextos prácticos de HTML. Ten en cuenta que usamos el plural "Ejemplos" incluso si la página solo contiene un ejemplo.
Un encabezado descriptivo
Cada ejemplo debe tener un encabezado H3 (###) que destaque el ejemplo. El encabezado debe ser descriptivo de lo que hace el ejemplo. Por ejemplo, "Un ejemplo simple" no dice nada sobre el ejemplo y, por lo tanto, no es un buen encabezado. El encabezado debe ser conciso. Para una descripción más larga, usa el párrafo después del encabezado.
Consulta nuestra guía sobre cómo añadir ejemplos de código para más información.
Nota: A veces querrás enlazar a ejemplos dados en otra página.
Caso 1: Si tienes algunos ejemplos en esta página y algunos más en otra página:
Incluye un encabezado H3 (###) para cada ejemplo en esta página y luego un encabezado H3 final (###) con el texto "Más ejemplos", bajo el cual puedes enlazar a los ejemplos en otras páginas. Por ejemplo:
## Ejemplos
### Uso del atributo `for`
Ejemplo del atributo `for`
### Más ejemplos
Enlaces a más ejemplos en otras páginas
Caso 2: Si solo tienes ejemplos en otra página y ninguno en esta:
No añadas encabezados H3; simplemente añade los enlaces directamente bajo el encabezado H2 "Ejemplos". Por ejemplo:
## Ejemplos
Para ver ejemplos de este atributo, consulta [la página sobre el atributo `for`](https://example.org/).
Especificaciones
{{Specifications}}
Para usar esta macro, elimina las comillas invertidas y la barra invertida en el archivo markdown.
Compatibilidad con navegadores
{{Compat}}
Para usar esta macro, elimina las comillas invertidas y la barra invertida en el archivo markdown.
Véase también
Incluye enlaces a páginas de referencia y guías relacionadas con el atributo actual. Para más pautas, consulta la sección Véase también en la Guía de estilo de escritura.
- enlace1
- enlace2
- enlace_externo (año)