Plantilla de página de elemento SVG
Nota: Elimina toda esta nota explicativa antes de publicar
Metadatos de la página:
Los metadatos en la parte superior de la página se utilizan para definir "metadatos de la página". Los valores deben actualizarse adecuadamente para el elemento en particular.
---
title: <NombreDelElemento>
slug: Web/SVG/Element/NombreDelElemento
page-type: svg-element
status:
- experimental
- deprecated
- non-standard
browser-compat: svg.elements.NombreDelElemento
---
- title
-
El título que se muestra en la parte superior de la página. Debe tener el formato <NombreDelElemento>. Por ejemplo, el elemento "g" tiene un título de
<g>
. - slug
-
El final de la ruta de URL después de
https://developer.mozilla.org/es/docs/
. Esto se formateará comoWeb/SVG/Element/NombreDelElemento
. - page-type
-
Siempre
svg-element
. - status
-
Incluye claves de estado de tecnología (apropiadas): experimental, desaprobada, no estándar (si no está en una pista de estándares).
- browser-compat
-
Reemplaza el valor de marcador de posición
svg.elements.NombreDelElemento
con la cadena de consulta para el elemento en el repositorio de datos de compatibilidad del navegador. La herramienta utiliza automáticamente la clave para completar las secciones de compatibilidad y especificación (reemplazando las macros{{Compat}}
y{{Specifications}}
).Ten en cuenta que es posible que primero necesites crear/actualizar una entrada para el elemento en nuestro repositorio de datos de compatibilidad del navegador, y la entrada debe incluir información de especificación. Consulta nuestra guía sobre cómo hacer esto.
Macros en la parte superior de la página
Aparecen varias llamadas a macros en la parte superior de la sección de contenido (inmediatamente debajo de los metadatos de la página). Debes actualizarlos o eliminarlos según el consejo siguiente:
-
{{SeeCompatTable}}
— esto genera un banner de Esta es una tecnología experimental que indica que la tecnología es experimental. Si la tecnología que estás documentando no es experimental, debes eliminar esto. Si es experimental, y la tecnología está oculta detrás de una preferencia en Firefox, también debes completar una entrada para ella en la página Características experimentales en Firefox. -
{{Deprecated_Header}}
— esto genera un banner de Obsoleto que indica que el uso de la tecnología está desaconsejado. Si no lo está, puedes eliminar la llamada a la macro. -
{{SecureContext_Header}}
— esto genera un banner de Contexto seguro que indica que la tecnología solo está disponible en un contexto seguro. Si no lo está, puedes eliminar la llamada a la macro. Si lo está, también debes completar una entrada para ella en la página Características restringidas a contextos seguros. -
{{SVGRef}}
— esto genera el menú lateral izquierdo de referencia para el elemento. El contenido del menú lateral depende de las etiquetas en los metadatos de la página. - Recuerda eliminar la macro
{{MDNSidebar}}
cuando copies esta página.
Se muestran muestras de los banners Experimental y Obsoleto justo después de este bloque de nota.
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.
Comienza el contenido en la página con un párrafo introductorio — comienza nombrando el elemento y diciendo qué hace. Idealmente, esto debería ser una o dos oraciones cortas.
Contexto de uso
{{svginfo}}
Para que aparezca la información correcta aquí, completa una entrada para el elemento en la macro {{svginfo}}
si aún no está.
Para usar esta macro, elimina las comillas invertidas y la barra invertida en el archivo Markdown.
Atributos
Atributos globales
Atributos específicos
- Incluye una lista con viñetas
- de todos los atributos SVG
- que puede tomar
Interfaz DOM
Este elemento implementa la interfaz {{domxref("NameOfSVGDOMElement")}}
.
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 nombre el ejemplo. El encabezado debe describir 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 agregar ejemplos de código para obtener más información.
Nota: A veces querrás vincular a ejemplos dados en otra página.
Escenario 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 vincular a los ejemplos en otras páginas. Por ejemplo:
## Ejemplos
### Usando la API fetch
Ejemplo de Fetch
### Más ejemplos
Enlaces a más ejemplos en otras páginas
Escenario 2: Si solo tienes ejemplos en otra página y ninguno en esta página:
No agregues ningún encabezado H3; simplemente agrega los enlaces directamente debajo del encabezado H2 "Ejemplos". Por ejemplo:
## Ejemplos
Para ejemplos de esta API, consulta [la página sobre 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 el elemento actual. Para obtener 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)