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