1. El proyecto MDN
  2. Pautas de redacción
  3. Estructuras de página
  4. Tipos de página
  5. Plantilla de subpágina de evento de API

Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

Plantilla de subpágina de evento de API

Nota: Elimina toda esta nota explicativa antes de publicar.

Front matter de la página:

El front matter en la parte superior de la página se usa para definir los "metadatos de la página". Debes actualizar los valores adecuadamente para cada evento en particular.

md
---
title: "NameOfTheParentInterface: NameOfTheEvent event"
slug: Web/API/NameOfTheParentInterface/NameOfTheEvent_event
page-type: web-api-event
status:
  - deprecated
  - experimental
  - non-standard
browser-compat: path.to.feature.NameOfTheEvent_event
---
title

El título que se muestra en la parte superior de la página. Debe tener el formato "NameOfTheParentInterface: NameOfTheEvent event". Por ejemplo, el evento animationcancel de la interfaz Window tiene como title Window: animationcancel event.

slug

El final de la ruta URL después de https://developer.mozilla.org/en-US/docs/. Tendrá un formato como Web/API/NameOfTheParentInterface/NameOfTheEvent_event.

page-type

La clave page-type para los eventos de Web/API es siempre web-api-event.

status

Indicadores que describen el estado de esta característica. Es un array que puede contener uno o más de los siguientes valores: experimental, deprecated, non-standard. Esta clave no debe establecerse manualmente: se establece automáticamente en función de los valores de los datos de compatibilidad del navegador para dicha característica. Consulta "Cómo se añaden o actualizan los estados de las características".

browser-compat

Reemplaza el marcador de posición path.to.feature.NameOfTheEvent_event con la cadena de consulta del evento en el Repositorio de datos de compatibilidad del navegador. La cadena de herramientas usa automáticamente esta clave para completar las secciones de compatibilidad y especificaciones (sustituyendo las macros {{Compat}} y {{Specifications}}).

Ten en cuenta que primero puede que debas crear o actualizar una entrada para el evento en nuestro Repositorio de datos de compatibilidad del navegador, y esta entrada deberá incluir información de especificación. Consulta nuestra guía sobre cómo hacerlo.

Macros de la parte superior de la página

Varias llamadas a macros aparecen en la parte superior de la sección de contenido (justo debajo del front matter de la página).

La cadena de herramientas añade estas macros automáticamente (no es necesario añadirlas ni eliminarlas):

  • {{SeeCompatTable}}: genera un aviso de Esta es una tecnología experimental que indica que la tecnología es experimental. Si es experimental y la tecnología está oculta tras una preferencia (pref) en Firefox, también debes completar una entrada para ella en la página Funciones experimentales en Firefox.
  • {{Deprecated_Header}}: genera un aviso de Obsoleto que indica que se desaconseja el uso de la tecnología.
  • {{Non-standard_Header}}: genera un aviso de No estándar que indica que la característica no forma parte de ninguna especificación.

Debes actualizar o eliminar las siguientes macros según las indicaciones a continuación:

  • {{SecureContext_Header}}: genera un aviso de Contexto seguro que indica que la tecnología solo está disponible en un contexto seguro. Si no es así, puedes eliminar la llamada a la macro. Si es así, también debes completar una entrada para ella en la página Características restringidas a contextos seguros.
  • {{AvailableInWorkers}}: genera una nota de Disponible en workers que indica que la tecnología está disponible en un contexto de worker. Si solo está disponible en el contexto de ventana (window), puedes eliminar la llamada a la macro. Si también está disponible, o solo está disponible en el contexto de worker, es posible que también debas pasarle un parámetro debido a su disponibilidad (consulta el código fuente de la macro {{AvailableInWorkers}} para ver todos los valores disponibles); también es posible que debas completar una entrada para ella en la página API web disponibles en workers.
  • {{APIRef("GroupDataName")}}: esto genera la barra lateral de referencia de la izquierda que muestra enlaces de referencia rápida relacionados con la página actual. Por ejemplo, todas las páginas de la WebVR API tienen la misma barra lateral, que apunta a las demás páginas de la API. Para generar la barra lateral correcta para tu API, debes añadir una entrada GroupData a nuestro repositorio de GitHub e incluir el nombre de esa entrada dentro de la llamada a la macro en lugar de GroupDataName. Consulta nuestra guía Barras laterales de referencia de API para obtener información sobre cómo hacerlo.

No añadas manualmente las macros de encabezado de estado. Consulta la sección "Cómo se añaden o actualizan los estados de las características" para añadir estos estados a la página.

Justo después de este bloque de nota se muestran ejemplos de los avisos de Contexto seguro, Disponible en workers, Experimental, Obsoleto y No estándar.

Enlace al objeto padre

Añade un enlace a esta nueva página desde la sección Eventos de su objeto padre. Por ejemplo, Element: wheel event está enlazado desde Element Eventos.

Si el objeto padre no tiene una sección Eventos, añade una. Si se trata de una nueva "clase" de evento, entonces debes añadir un enlace a esta sección del padre desde la guía Eventos del DOM.

Recuerda eliminar toda esta nota explicativa antes de publicar.

Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.

Nota: Esta característica está disponible en Web Workers.

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 el contenido de la página con un párrafo introductorio: empieza nombrando el evento, indicando a qué interfaz pertenece y explicando qué hace. Lo ideal es que sean una o dos frases breves. Puedes copiar la mayor parte de este texto del resumen de la propiedad en la página de referencia de la API correspondiente.

Sintaxis

Usa el nombre del evento en métodos como addEventListener(), o establece una propiedad de manejador de eventos.

js
addEventListener("NameOfTheEvent", (event) => { })

onNameOfTheEvent = (event) => { }

Tipo de evento

Si el evento tiene un tipo especial, menciónalo junto con su herencia. Si no, indica que se trata de un evento genérico:

Un Event genérico.

O, por ejemplo:

Un XRSessionEvent. Hereda de Event.

Event XRSessionEvent

Descripción

Si quieres proporcionar texto adicional (demasiado largo para el resumen), añade una sección Descripción. Puede contener los encabezados

Activación

y

Casos de uso

que pueden aportar más información.

Ejemplos

Ten en cuenta que usamos el plural "Ejemplos" incluso si la página contiene solo un ejemplo.

Un encabezado descriptivo

Cada ejemplo debe tener un encabezado H3 (###) que lo identifique. El encabezado debe describir qué hace el ejemplo. Por ejemplo, "Un ejemplo sencillo" 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 posterior al encabezado.

Consulta nuestra guía sobre cómo añadir ejemplos de código para obtener más información.

Nota: A veces querrás enlazar a ejemplos que se encuentran en otra página.

Escenario 1: Si tienes algunos ejemplos en esta página y otros más en otra página:

Incluye un encabezado H3 (###) para cada ejemplo de esta página y, al final, un último encabezado H3 (###) con el texto "Más ejemplos", bajo el cual puedes enlazar a los ejemplos de otras páginas. Por ejemplo:

md
## Examples

### Using the fetch API

Example of Fetch

### More examples

Links to more examples on other pages

Escenario 2: Si solo tienes ejemplos en otra página y ninguno en esta:

No añadas ningún encabezado H3; simplemente añade los enlaces directamente debajo del encabezado H2 "Examples". Por ejemplo:

md
## Examples

For examples of this API, see [the page on fetch()](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 la API actual. Para más pautas, consulta la sección Véase también en la Guía de estilo de redacción.

  • enlace1
  • enlace2
  • enlace_externo (año)

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content