Elemento <xsl:output> de XSLT

Elementos XSLT

Definición y uso

El elemento <xsl:output> define el formato del documento de salida.

Comentarios:<xsl:output> es un elemento de nivel superior (top-level element), debe ser un nodo hijo de <xsl:stylesheet> o <xsl:transform>.

Sintaxis

<xsl:output
method="xml|html|text|name"
version="string"
encoding="string"
omit-xml-declaration="yes|no"
standalone="yes|no"
doctype-public="string"
doctype-system="string"
cdata-section-elements="namelist"
indent="yes|no"
media-type="string"/>

Atributo

Atributo Valor Descripción
method
  • xml
  • html
  • text
  • name
 Opcional. Define el formato de salida. El valor predeterminado es XML. Netscape 6 solo admite "html" y "xml".
version cadena Opcional. Establece la versión del W3C del formato de salida. (Únicamente se utiliza cuando method="html" o method="xml").
encoding cadena Opcional. Establece el valor de la propiedad de codificación en la salida.
omit-xml-declaration
  • sí
  • no

Opcional.

"yes" define que se debe omitir la declaración XML en la salida (<?xml...?>).

"no" define que debe incluirse una declaración XML en la salida. El valor predeterminado es "no".
standalone
    • sí
    • no
 Opcional. Define si el procesador XSLT debe generar una declaración de documento independiente; este valor debe ser "yes" o "no". El valor predeterminado es "no". Netscape 6 no admite esta propiedad.
doctype-public cadena Opcional. Especifica el identificador común que se debe usar en el DTD. Es decir, el valor de la propiedad PUBLIC del DOCTYPE en la salida.
doctype-system cadena Opcional. Especifica el identificador de sistema que se debe usar en el DTD. Es decir, el valor de la propiedad SYSTEM del DOCTYPE en la salida.
cdata-section-elements namelist Opcional. Una lista de elementos separados por espacios en blanco, cuyos contenidos de texto deben emitirse como parte CDATA.
indent
  • sí
  • no
 Opcional. Indica si se debe agregar espacio en blanco al emitir el árbol de resultados; este valor debe ser "yes" o "no". Netscape 6 no admite esta propiedad.
media-type cadena Opcional. Define el tipo MIME de salida (el tipo de medio de los datos). El valor predeterminado es "text/xml". Netscape 6 no admite esta propiedad.

propiedad method

Identifica el método utilizado para emitir el árbol de resultados. Si no hay prefijo, identifica el método especificado en este documento, debe ser "xml", "html", "text" o uno de los nombres no NCName). Si hay prefijo, se expande e identifica el método de salida.

La elección del valor predeterminado de la propiedad method se muestra a continuación. Si alguna de las siguientes condiciones es verdadera, el método de salida predeterminado es "html":

El nodo raíz del árbol de resultados contiene subniveles de elementos.

El nodo raíz del árbol de resultados contiene subniveles de elementos. La extensión del nombre del primer elemento subnivel (es decir, el elemento del documento) contiene la parte local "html" (cualquier combinación de mayúsculas y minúsculas) y un URI de espacio de nombres en blanco.

Cualquier nodo de texto antes del primer subnivel del elemento del nodo raíz del árbol de resultados solo contiene caracteres de espacio en blanco.

De lo contrario, el método de salida predeterminado es "xml". Si no hay el elemento <xsl:output> o si el elemento <xsl:output> no especifica el valor de la propiedad method, se debe usar el método de salida predeterminado.

Ejemplo

Ejemplo 1

En este ejemplo, el resultado es un documento XML, versión 1.0. El modo de codificación de caracteres se establece como "ISO-8859-1", y el resultado se realiza con sangría para mejorar la legibilidad:

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" version="1.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>

Ejemplo 2

En este ejemplo, el resultado es un documento HTML, versión 4.0. El modo de codificación de caracteres se establece como "ISO-8859-1", y el resultado se realiza con sangría para mejorar la legibilidad:

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" version="4.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>

Elementos XSLT