xsl:fallback Element
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
O < xsl:fallback > elemento foi projetado para situações identificador onde o analisador não é possível identificador um elemento XSL que pode ser parte de uma nova versão ou é um não reconhecido caso contrário extensão. Ele funciona por chamado modelo de conteúdo que pode fornecer um substituir razoável ao comportamento do novo elemento ao encontrou.
Syntax
<xsl:fallback>
</xsl:fallback>
Atributos
Nenhum.
Elemento informações
Número de ocorrências |
Ilimitado |
Elementos pai |
Qualquer elemento onde o de conteúdo é um modelo. |
Elementos filho |
Qualquer elemento que pode ocorrer em um modelo. |
Remarks
Quando um documento XSL é carregado pela primeira vez, o preparser XSLT realiza validação em todos os elementos XSL. Se a versão passado na < xsl: stylesheet > elemento é maior do que com suporte pelo analisador, sempre que um elemento desconhecido for encontrado, o irá analisador executar o < xsl:fallback > filhos desse elemento (ou simplesmente não executar qualquer ação se o retorno não tiver nenhuma de conteúdo). Se o elemento for com suporte, o retorno modelos nunca são instanciado. Da mesma forma, se a versão fornecida na folha de estilo é o mesmo com suporte o navegador e, em seguida, um erro será chamado.
Fallbacks fazem parte de ENC-mecanismo processamento que XSLT usa para manipulação atualizações. Criando alternativo maneiras de manipulação um comando se um elemento não é com suporte, ENC-processamento garante que a codificar usado é relativamente robusta e minúsculas para diferenças na conformidade analisador.
In addition to versionamento manipulação diferenças, o retorno função também pode ser usada para elementos identificador definidos por extensões espaço de nome. Porque adicionando funcionalidade para a especificação de base é geralmente muito difícil, Nome espaço extensões permitem que os desenvolvedores definir funcionalidades além especificado pela especificação de XSLT. Se o espaço nome não for com suporte (nenhuma definição de espaço de nome for fornecida), ou se uma função espaço Nome ou elemento não está definido, em seguida, o mecanismo de retorno pode ser usado para fornecer alternativo funcionalidade.
Para garantir que a extensão é interpretado dentro de operação XSLT, você precisa definir a Prefixos extensão - elemento- atributo in a < xsl: stylesheet > elemento para que ele contém o nome do prefixo para interpretar. Além disso, declare espaço de nome para esse prefixo.
Example
O seguinte documento XML tem o "fallback.xsl" estilo folha anexado. Folha de estilo fallback.xsl fornece alternativo processamento para o documento.
<?xml version="1.0"?>
<?xml-stylesheet href="fallback.xsl" type="text/xsl"?>
<records>
<record>
<name>Rachel Valdez</name>
<address>222 Cherry</address>
<phone>425-555-0100</phone>
</record>
<record>
<name>James Van Eaton</name>
<address>777 Elm</address>
<phone>425-555-0101</phone>
</record>
</records>
Fallback.xsl
As tentativas fallback.xsl estilo folha ao processo de documento XML com um hipotético < xsl: Import-tabela > elemento. Porque esse elemento não é com suporte na atual versão do analisador, o documento como alternativa é processado com o script dentro de retorno elemento.
<xsl:stylesheet version="1.1" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<HTML>
<HEAD><TITLE>Output Table</TITLE></HEAD>
<BODY>
<xsl:import-table href="blah.html" name="sample">
<xsl:fallback>
<p>This version of the parser does not support the creation of a table with the 'xsl:import-table' element, so the following table has been generated using the 'fallback' element.</p>
<table border='2'>
<xsl:for-each select='records/record'>
<tr>
<td><xsl:value-of select='name'/></td>
<td><xsl:value-of select='address'/></td>
<td><xsl:value-of select='phone'/></td>
</tr>
</xsl:for-each>
</table>
</xsl:fallback>
</xsl:import-table>
</BODY>
</HTML>
</xsl:template>
</xsl:stylesheet>
Saída
Esta versão do analisador não suporte a criação de uma tabela com o ' xsl: Import-tabela ' elemento, portanto, a seguinte tabela foi gerada usando o 'retorno' elemento.
|
|
|
|
|
|
See Also
Reference
XSLT Elements
element-available Function
function-available Function
system-property Function