Elemento <xsl:output> do XSLT
Definição e uso
O elemento <xsl:output> define o formato do documento de saída.
Observação:<xsl:output> é um elemento de nível superior (top-level element), deve ser 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. Definir o formato de saída. O padrão é XML. O Netscape 6 suporta apenas "html" e "xml". |
| version | string | Opcional. Definir o número da versão W3C do formato de saída. (Usado apenas quando method="html" ou method="xml"). |
| encoding | string | Opcional. Define o valor da propriedade de codificação no output. |
| omit-xml-declaration |
|
Opcional. "yes" especifica que deve ser omitida a declaração XML no output (<?xml...?>). "no" especifica que deve ser incluída a declaração XML no output. O padrão é "no". |
| standalone |
|
Opcional. Especifica se o processador XSLT deve output uma declaração de documento independente; o 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ço, cujo conteúdo de texto deve ser output como parte CDATA. |
| indent |
|
Opcional. Define se deve ser adicionado espaço em branco ao output da árvore de resultado; o valor deve ser yes ou no. O Netscape 6 não suporta essa propriedade. |
| media-type | string | Opcional. Define o tipo MIME de 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 resultado. Se não houver prefixo, identifica o método especificado neste documento, deve ser "xml", "html", "text" ou um nome qualificado que não é NCName. Se houver prefixo, expande e identifica o método de saída.
A escolha do valor padrão da propriedade method é conforme mostrado a seguir. Se qualquer uma das seguintes condições for verdadeira, o método de saída padrão é "html":
O nó raiz da árvore do resultado contém subnós de elementos.
O nó raiz do resultado da árvore contém subnós de elementos. A extensão do nó raiz do primeiro elemento subnó (ou seja, o elemento do documento) 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 do resultado da árvore 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 ser usado o método de saída padrão.
Exemplo
Exemplo 1
Neste exemplo, o resultado é um documento XML, versão 1.0. O modo de codificação de caracteres é configurado como "ISO-8859-1", e o resultado será indentado 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", 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>
