Elemento <xsl:output> do XSLT

Definição e uso

O elemento <xsl:output> define o formato do documento de saída.

Comentário:<xsl:output> é um elemento de nível superior (top-level element), deve ser um nó filho de <xsl:stylesheet> ou <xsl:transform>.

Sintaxe

<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 Descrição
method
  • xml
  • html
  • text
  • name
Opcional. Define o formato de saída. O padrão é XML. O Netscape 6 suporta apenas "html" e "xml".
version string Opcional. Define a versão do W3C do formato de saída. (Apenas quando method="html" ou method="xml").
encoding string Opcional. Define o valor da propriedade de codificação na saída.
omit-xml-declaration
  • yes
  • no

Opcional.

"yes" determina que a declaração XML deve ser omitida na saída (<?xml...?>).

"no" determina que a declaração XML deve ser incluída na saída. O padrão é "no".

standalone
    • yes
    • no
Opcional. Determina se o processador XSLT deve gerar uma declaração de documento independente; este valor deve ser "yes" ou "no". O padrão é "no". O Netscape 6 não suporta essa propriedade.
doctype-public string Opcional. Especifica o identificador público a ser usado no DTD. É o valor da propriedade PUBLIC da declaração DOCTYPE no output.
doctype-system string Opcional. Especifica o identificador de sistema a ser usado no DTD. É o valor da propriedade SYSTEM da declaração DOCTYPE no output.
cdata-section-elements namelist Opcional. Uma lista de elementos separados por espaços, cujo conteúdo de texto deve ser output como parte CDATA.
indent
  • yes
  • no
Opcional. Especifica se deve ser adicionado espaço em branco na saída da árvore de resultados; o valor deve ser yes ou no. O Netscape 6 não suporta essa propriedade.
media-type string Opcional. Define o tipo MIME da saída (o tipo de mídia dos dados). O padrão é "text/xml". O Netscape 6 não suporta essa propriedade.

Propriedade method

Identifica o método geral usado para output da árvore de resultados. Se não houver prefixo, identifica o método especificado neste documento, deve ser "xml", "html", "text" ou um nome NCName não restrito. Se houver prefixo, expande e identifica o método de saída.

A escolha do valor padrão da propriedade method é conforme所示. Se qualquer uma das seguintes condições for verdadeira, o método de saída padrão é "html":

O nó raiz da árvore de resultados contém subnó de elemento.

O nó raiz da árvore de resultados contém subnó de elemento. A extensão do nó raiz da árvore de resultados contém a parte local "html" (qualquer combinação de maiúsculas e minúsculas) e URI de espaço vazio.

Qualquer nó de texto antes do primeiro subnó de elemento do nó raiz da árvore de resultados contém apenas caracteres em branco.

Caso contrário, o método de saída padrão é "xml". Se não houver o elemento <xsl:output> ou se o elemento <xsl:output> não especificar o valor da propriedade method, deve usar o método de saída padrão.

Exemplo

Exemplo 1

Neste exemplo, a saída é um documento XML, versão 1.0. O modo de codificação de caracteres é configurado como "ISO-8859-1", e a saída será indentada para melhorar a legibilidade:

<?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>

Exemplo 2

Neste exemplo, a saída é um documento HTML, versão 4.0. O modo de codificação de caracteres é configurado como "ISO-8859-1", e a saída será indentada para melhorar a legibilidade:

<?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>