Selecione Arquivo > Novo.
Última atualização em
20/12/2021
Saiba como executar transformações XSL do servidor no Dreamweaver. Crie páginas XSLT e converta páginas HTML para XSLT.
A interface de usuário foi simplificada no Dreamweaver 2017. Logo, talvez você não consiga encontrar algumas das opções descritas neste artigo no Dreamweaver 2017 e em versões posteriores. Para obter mais informações, consulte este artigo (em inglês).
Fluxo de trabalho para executar transformações XSL do lado do servidor
Você pode executar transformações XSL do lado do servidor.Leia sobre transformações XSL do lado do servidor e do lado do cliente e sobre o uso de XML e XSL com páginas da Web antes de criar páginas que exibem dados XML.
seu servidor deve ser configurado corretamente para executar transformações do servidor. Para obter mais informações, entre em contato com o administrador do servidor.
O fluxo de trabalho geral para executar transformações XSL do lado do servidor é o seguinte (cada etapa é descrita em outros tópicos):
1. Configurar um site do Dreamweaver.
2. Escolha uma tecnologia de servidor e configure um servidor de aplicativos.
3.Testar o servidor de aplicativos.
Por exemplo, crie uma página que exija processamento e certifique-se de que o servidor de aplicativo processe a página.
4.Crie um fragmento ou página XSLT, ou converta uma página HTML em uma página XSLT.
No local do Dreamweaver, crie um fragmento XSLT ou uma página XSLT completa.
Converta uma página HTML existente em uma página XSLT inteira.
5.Anexe uma fonte de dados XML à página.
6.Exiba dados XML vinculando os dados ao fragmento XSLT ou à página XSLT completa.
7.Se apropriado, adicione um objeto XSLT de Região de repetição à tabela ou linha de tabela que contém os espaços reservados de dados XML.
8.Insira referências.
Para inserir uma referência ao fragmento XSLT na página dinâmica, use o comportamento de servidor Transformação XSL.
Para inserir uma referência à página XSLT completa na página dinâmica, exclua todo o código HTML de uma página dinâmica e use o comportamento de servidor Transformação XSL.
9.Publique a página e o fragmento.
Publique a página dinâmica e o fragmento XSLT (ou página XSLT completa) no servidor de aplicativo. Se você estiver usando um arquivo XML local, também precisará publicá-lo.
10. Exiba a página dinâmica em um navegador.
Ao fazer isso, o servidor de aplicativo transforma os dados XML, os insere na página dinâmica e os exibe no navegador.
Criar uma página XSLT
Você pode criar páginas XSLT que permitem exibir dados XML em páginas da Web. Você pode criar uma página XSLT completa—uma página XSLT que contém uma tag <body> e uma tag <head>—ou pode criar um fragmento XSLT. Ao criar um fragmento XSLT, você cria um arquivo independente que não contém tag body ou head—um pedaço simples de código que é inserido posteriormente em uma página dinâmica.
se estiver começando a partir de uma página XSLT existente, você precisa anexar uma fonte de dados XML ao fragmento.
Na categoria Página em branco da caixa de diálogo Novo documento,
selecione uma das seguintes opções na coluna Tipo de página:
Selecione XSLT (Página inteira) para criar uma página XSLT inteira.
Selecione XSLT (fragmento) para criar um fragmento XSLT.
Clique em Criar e siga um dos procedimentos na caixa de diálogo Localizar
origem XML:
- Selecione Anexar arquivo local, clique no botão Procurar, navegue até um arquivo XML local no seu computador e clique em OK.
- Selecione Anexar arquivo remoto, insira o URL de um arquivo XML na Internet (como o endereço de um feed RSS, por exemplo) e clique em OK.
clique no botão Cancelar para gerar uma nova página XSLT sem uma fonte de dados XML anexada.
O painel Ligações é preenchido com o esquema da fonte de dados XML
A tabela a seguir fornece uma explicação dos diversos elementos do esquema que podem aparecer:
Elemento |
Representa |
Detalhes |
|---|---|---|
<> |
Elemento XML obrigatório não repetitivo |
Um elemento que aparece exatamente uma vez no nó pai |
<>+ |
Elemento XML repetitivo |
Um elemento que aparece uma ou mais vezes no nó pai |
<>+ |
Elemento XML opcional |
Um elemento que aparece nenhuma ou mais vezes no nó pai |
Nó do elemento em negrito |
Elemento de contexto atual |
Normalmente, o elemento repetitivo quando o ponto de inserção está dentro de uma região repetitiva |
@ |
Atributo XML |
|
Salve a nova página (Arquivo > Salvar) com a
extensão .xsl ou .xslt (.xsl é o padrão).
Converter páginas HTML em páginas XSLT
Você também pode converter páginas HTML existentes em páginas XSLT. Por exemplo, se você tiver uma página estática pré-projetada à qual deseja adicionar dados XML, pode converter a página em uma página XSLT, em vez de criar uma página XSLT e reprojetar a página do zero.
Abra a página HTML que deseja converter.
Selecione Arquivo > Converter > XSLT
1.0.
Uma cópia da página é aberta na janela Documento. A nova página é uma folha de estilos XSL, salva com a extensão .xsl.
Anexar fontes de dados XML
Se você estiver começando com uma página XSLT existente, ou se não anexar uma fonte de dados XML ao criar uma nova página XSLT com o Dreamweaver, deve anexar uma fonte de dados XML usando o painel Vínculos.
No painel Vínculos (Janela > Vínculos),
clique no link XML.
você também pode clicar no link Origem, no canto superior direito do painel Ligações, para adicionar uma fonte de dados XML.
Siga um destes procedimentos:
Selecione Anexar um arquivo local, clique no botão Procurar, navegue até um arquivo XML local no computador e clique em OK.
Selecione Anexar um arquivo remoto e insira a URL de um arquivo XML na Internet (como um proveniente de um RSS feed).
Clique em OK para fechar a caixa de diálogo Localizar origem XML.
O painel Vínculos é preenchido com o esquema da fonte de dados XML.
Exibir dados XML em páginas XSLT
Depois de criar uma página XSLT e anexar uma fonte de dados XML, você pode vincular dados à página. Para fazer isso, você adiciona um espaço reservado de dados XML à página e usa o Construtor de expressões XPath ou o Inspetor de propriedades para formatar os dados selecionados que serão exibidos na página.
Abra uma página XSLT com uma fonte de dados XML anexada.
(Opcional) Selecione Inserir > Tabela para adicionar uma
tabela à página. A tabela ajuda a organizar os dados XML.
Nota
Na maioria dos casos, você usa o objeto XSLT Região repetitiva para exibir elementos XML repetitivos em uma página. Neste caso, você pode criar uma tabela de linha única com uma ou mais colunas, ou uma tabela de duas linhas se desejar incluir um cabeçalho de tabela.
No painel Vínculos, selecione um elemento XML e arraste-o
para o local na página onde deseja inserir dados.
Um espaço reservado de dados XML aparece na página. O espaço reservado fica realçado e entre chaves. Ele usa a sintaxe XPath (linguagem de caminho XML) para descrever a estrutura hierárquica do esquema XML. Por exemplo, se você arrastar o elemento filho title para a página, e esse elemento tiver os elementos pai rss, channel e item, a sintaxe do espaço reservado de conteúdo dinâmico será {rss/channel/item/title}.
Clique duas vezes no espaço reservado de dados XML na página para abrir o Construtor de expressões XPath. O Construtor de expressões XPath permite formatar dados selecionados ou selecionar outros itens do esquema XML.
(Opcional) Aplique estilos aos dados XML selecionando
um espaço reservado de dados XML e aplicando estilos a ele como qualquer outro
conteúdo usando o Inspetor de propriedades ou o painel
Estilos CSS. Como alternativa, você pode usar folhas de estilo de tempo de design para aplicar
estilos a fragmentos XSLT. Cada um desses métodos tem seu próprio conjunto de
benefícios e limitações.
Visualize seu trabalho em um navegador (Arquivo > Visualizar
em navegador).
quando você visualiza seu trabalho usando a opção Visualizar no navegador, o Dreamweaver executa uma transformação XSL interna sem usar um servidor de aplicativo.
Exibir elementos XML repetitivos
O objeto XSLT Região de repetição permite exibir elementos repetidos de uma fonte de dados XML em uma página da Web. Por exemplo, se você estiver exibindo títulos e descrições de artigos de um feed de notícias, e esse feed de notícias contém entre 10 e 20 artigos, cada título e descrição no arquivo XML provavelmente seria um elemento filho de um elemento repetido.
Qualquer região na exibição de Design contendo um espaço reservado de dados XML pode ser alterada para uma região repetida.No entanto, as regiões mais comuns são tabelas, linhas de tabela ou uma série de linhas de tabela.
Na visualização de Design, selecione uma região que contém
um espaço reservado ou espaços reservados de dados XML.
A seleção pode ser qualquer coisa, incluindo uma tabela, uma linha de tabela ou até mesmo um parágrafo de texto.
para selecionar uma região na página com precisão, você pode usar o seletor de tags no canto inferior esquerdo da janela Documento. Por exemplo, se a região for uma tabela, clique dentro da tabela na página e, em seguida, clique na tag no seletor de tags.
Siga um destes procedimentos:
Selecione Inserir > Objetos XSLT > Região de repetição.
Na categoria XSLT do painel Inserir, clique no botão Região de repetição.
No Construtor de expressões XPath, selecione o elemento
repetido, indicado por um pequeno sinal de adição.
Clique em OK.
Na janela Documento, um contorno cinza fino com abas aparece ao redor da região repetida.Quando você visualiza seu trabalho em um navegador (Arquivo > Visualizar em navegador), o contorno cinza desaparece e a seleção se expande para exibir os elementos repetidos especificados no arquivo XML.
Quando você adiciona o objeto XSLT de região de repetição à página, o placeholder de dados XML na janela Documento é truncado.Isso ocorre porque o Dreamweaver trunca o XPath para o espaço reservado de dados XML para que seja relativo ao caminho do elemento repetido.
Definir propriedades da região repetitiva (XSL)
No inspetor de propriedades, você pode selecionar um nó XML diferente para criar a região de repetição.
Na caixa Selecionar, insira um novo nó e
pressione o ícone de raio e selecione o nó da árvore de esquema XML
que aparece.
Editar um objeto XSLT de região repetitiva
Depois de adicionar um objeto XSLT de região de repetição a uma região, você pode editá-lo usando o inspetor de propriedades.
Selecione o objeto clicando na guia cinza que
cerca a região repetida.
No inspetor de propriedades (Janela > Propriedades), clique no ícone dinâmico ao lado do campo de texto "Selecionar".
No Construtor de expressões XPath, faça suas alterações e
clique em OK.
Inserir fragmentos XSLT em páginas dinâmicas
Depois de criar um fragmento XSLT, você pode inseri-lo em uma página da Web dinâmica usando o comportamento de servidor Transformação XSL. Quando você adiciona o comportamento de servidor à sua página e visualiza a página em um navegador, um servidor de aplicativo realiza uma transformação que exibe os dados XML do fragmento XSLT selecionado. O Dreamweaver oferece suporte a transformações XSL para páginas ColdFusion, ASP ou PHP.
se desejar inserir o conteúdo de uma página XSLT inteira em uma página dinâmica, o procedimento será exatamente o mesmo. Antes de usar o comportamento Transformação XSL do servidor para inserir a página XSLT inteira, exclua todo o código HTML da página dinâmica.
Abra uma página ColdFusion, ASP ou PHP existente.
Na visualização Design, posicione o ponto de inserção no local
onde deseja inserir o fragmento XSLT.
ao inserir fragmentos XSLT, você sempre deve clicar no botão Mostrar visualizações de código e de design depois de colocar o ponto de inserção na página para garantir que o ponto seja colocado no local correto. Caso o local não seja correto, clique em algum outro lugar da Visualização de código para colocar o ponto de inserção onde deseja.
No painel Comportamentos do servidor (Janela > Comportamentos
do servidor), clique no botão Mais (+) e selecione Transformação XSL.
Na caixa de diálogo Transformação XSL, clique no botão Procurar
e navegue até um fragmento XSLT ou uma página XSLT inteira.
Dreamweaver preenche o próximo campo de texto com o caminho do arquivo ou URL do arquivo XML anexado ao fragmento especificado.Para alterá-lo, clique no botão Procurar e navegue até outro arquivo.
(Opcional) Clique no botão de adição (+) para adicionar um parâmetro XSLT.
Clique em OK para inserir uma referência ao fragmento XSLT na
página. O fragmento não pode ser editado. Você pode clicar duas vezes no
fragmento para abrir o arquivo de origem do fragmento e editá-lo.
Uma pasta includes/MM_XSLTransform/ também é criada na pasta raiz do local, que contém um arquivo de biblioteca de tempo de execução. O servidor de aplicativo usa as funções definidas neste arquivo para executar a transformação.
Faça upload da página dinâmica para o servidor (Site > Enviar) e clique em Sim para incluir arquivos dependentes.O arquivo que contém
o fragmento XSLT, o arquivo XML que contém os dados e o arquivo
de biblioteca de tempo de execução gerado devem estar no servidor para que a página seja
exibida corretamente. (Se você selecionou um arquivo XML remoto como fonte de dados,
este arquivo deve residir em outro local na Internet.)
Excluir fragmentos XSLT de páginas dinâmicas
Você pode remover um fragmento XSLT de uma página excluindo o comportamento do servidor Transformação XSL usado para inserir o fragmento. A exclusão do comportamento do servidor exclui apenas o fragmento XSLT—não exclui os arquivos XML, XSLT ou de biblioteca de tempo de execução associados.
No painel Comportamentos do servidor (Janela >
Comportamentos do servidor), selecione o comportamento do servidor Transformação XSL
que deseja excluir.
Clique no botão de subtração (-).
nesta versão, você sempre deve remover os comportamentos de servidor. A exclusão manual do código gerado remove apenas parcialmente o comportamento de servidor, mesmo que o comportamento desapareça do painel Comportamentos de servidor.
Editar comportamentos do servidor Transformação XSL
Após adicionar um fragmento XSLT a uma página da Web dinâmica, você pode editar o comportamento do servidor Transformação XSL a qualquer momento.
No painel Comportamentos do servidor (Janela >
Comportamentos do servidor), clique duas vezes no comportamento do servidor Transformação XSL
que deseja editar.
Faça as alterações e clique em OK.
Criar um link dinâmico
Você pode criar um link dinâmico na página XSLT que vincula a uma URL específica quando o usuário clica em uma palavra ou grupo de palavras especificado dos dados XML. Para obter instruções completas, consulte a errata do Dreamweaver em www.adobe.com/go/dw_documentation.
Aplicar estilos em fragmentos XSLT
Quando você cria uma página XSLT inteira (ou seja, uma página XSLT que contém tags <body> e <head>), você pode exibir dados XML na página e depois formatar os dados como qualquer outro conteúdo usando o inspetor de Propriedades ou o painel Estilos CSS. Quando você cria um fragmento XSLT para inserção em uma página dinâmica (por exemplo, um fragmento para inserção em uma página ASP, PHP ou Cold Fusion), a renderização de estilos no fragmento e na página dinâmica se torna mais complicada. Embora você trabalhe em um fragmento XSLT separadamente da página dinâmica, é importante lembrar que o fragmento é destinado ao uso dentro da página dinâmica e que a saída do fragmento XSLT, por fim, reside em algum lugar dentro das tags <body> da página dinâmica. Considerando esse fluxo de trabalho, é importante garantir que você não inclua elementos <head> (como definições de estilo ou links para folhas de estilo externas) em fragmentos XSLT. Isso fará com que o servidor de aplicativo coloque esses elementos no <body> da página dinâmica, gerando assim marcação inválida.
Por exemplo, você pode querer criar um fragmento XSLT para inserção em uma página dinâmica e formatar o fragmento usando a mesma folha de estilo externa da página dinâmica. Se você anexar a mesma folha de estilo ao fragmento, a página HTML resultante conterá um link duplicado para a folha de estilo (um na seção <head> da página dinâmica e outro na seção <body> da página, onde aparece o conteúdo do fragmento XSLT). Em vez dessa abordagem, você deve usar folhas de estilo de tempo de design para referenciar a folha de estilo externa.
Ao formatar o conteúdo de fragmentos XSLT, use o seguinte fluxo de trabalho:
Primeiro, anexe uma folha de estilo externa à página dinâmica. Esta é a melhor maneira de aplicar estilos no conteúdo de qualquer página da Web.
Em seguida, anexe a mesma folha de estilo externa ao fragmento XSLT como uma folha de estilo em tempo de design. Como o nome indica, as folhas de estilos em tempo de design funcionam somente na Visualização de design do Dreamweaver.
Depois de realizar as duas etapas anteriores, você pode criar novos estilos no seu fragmento XSLT usando a mesma folha de estilo anexada à sua página dinâmica. A saída HTML será mais limpa (porque a referência à folha de estilos é válida somente no Dreamweaver) e o fragmento ainda exibirá os estilos apropriados na Visualização de design. Além disso, todos os estilos serão aplicados tanto no fragmento quanto na página dinâmica quando a página dinâmica for visualizada no modo Design ou em um navegador.
se você visualizar o fragmento XSLT em um navegador, os estilos não serão exibidos pelo navegador. Em vez disso, você deve visualizar a página dinâmica no navegador para ver o fragmento XSLT no contexto da página dinâmica.
Usar parâmetros com transformações XSL
Você pode definir parâmetros para sua transformação XSL ao adicionar o comportamento de servidor XSL Transformation a uma página da Web. Um parâmetro controla como os dados XML são processados e exibidos. Por exemplo, você pode usar um parâmetro para identificar e listar um artigo específico de um feed de notícias. Quando a página carrega em um navegador, apenas o artigo que você especificou com o parâmetro aparece.
Adicionar um parâmetro XSLT a uma transformação XSL
Abra a caixa de diálogo Transformação XSL.
Você pode fazer isso clicando duas vezes em um comportamento de servidor XSL Transformation
no painel Comportamentos de servidor (Janela > Comportamentos
de servidor) ou adicionando um novo comportamento de servidor XSL Transformation.
Na caixa de diálogo Transformação XSL, clique no botão Mais
(+) ao lado de Parâmetros XSLT.
Na caixa de diálogo Adicionar Parâmetros, digite um nome para o
parâmetro na caixa Nome. O nome pode conter apenas
caracteres alfanuméricos. Os espaços não são permitidos.
Siga um destes procedimentos:
Se quiser usar um valor estático, digite-o na caixa Valor.
Se quiser usar um valor dinâmico, clique no ícone dinâmico ao lado da caixa Valor, complete a caixa de diálogo Dados Dinâmicos e clique em OK. Para mais informações, clique no botão Ajuda na caixa de diálogo Dados Dinâmicos.
Na caixa Valor padrão, insira o valor que você deseja que o parâmetro use se a página não receber valor de tempo de execução e clique em OK.
Editar um parâmetro XSLT
Abra a caixa de diálogo Transformação XSL.
Você pode fazer isso clicando duas vezes em um comportamento de servidor
Transformação XSL no painel Comportamentos do Servidor (Janela > Comportamentos do
Servidor) ou adicionando um novo comportamento de servidor Transformação XSL.
Selecione um parâmetro na lista de parâmetro XSLT.
Clique no botão Editar.
Faça as alterações e clique em OK.
Excluir um parâmetro XSLT
Abra a caixa de diálogo Transformação XSL.
Você pode fazer isso clicando duas vezes em um comportamento de servidor
Transformação XSL no painel Comportamentos do Servidor (Janela > Comportamentos do
Servidor) ou adicionando um novo comportamento de servidor Transformação XSL.
Selecione um parâmetro na lista de parâmetro XSLT.
Clique no botão de subtração (-).
Criar e editar regiões XSLT condicionais
Você pode criar regiões condicionais simples ou múltiplas regiões condicionais em uma página XSLT. Você pode selecionar um elemento na visualização Design e aplicar uma região condicional à seleção, ou pode inserir uma região condicional onde quer que esteja o ponto de inserção no documento.
Por exemplo, se você quiser exibir a palavra "Indisponível" ao lado do preço de um item quando o item estiver indisponível, digite o texto "Indisponível" na página, selecione-o e aplique uma região condicional ao texto selecionado.Dreamweaver envolve a seleção com tags <xsl:if>, e só exibe a palavra "Indisponível" na página quando os dados combinam com as condições da expressão condicional.
Aplicar uma região XSLT condicional
Você pode escrever uma expressão condicional simples para inserir na página XSLT.Se o conteúdo estiver selecionado ao abrir a caixa de diálogo Região condicional, o conteúdo será envolvido em um bloco <xsl:if>.Se o conteúdo não estiver selecionado, o bloco <xsl:if> é adicionado no ponto de inserção na página.É uma boa ideia usar a caixa de diálogo para começar e depois personalizar a expressão na visualização de Código.
O elemento <xsl:if> é semelhante à instrução if em outras linguagens.O elemento oferece uma forma de testar uma condição e tomar uma decisão com base no resultado.O elemento <xsl:if> permite testar uma expressão para um único valor verdadeiro ou falso.
Selecione Inserir > Objetos XSLT > Região condicional ou clique no ícone Região condicional na categoria XSLT do painel Inserir.
Na caixa de diálogo Região condicional, insira a expressão condicional
a ser usada na região.
No exemplo a seguir, você quer testar para ver se o valor do atributo @available do nó de contexto é true.
Clique em OK.
O seguinte código é inserido na página XSLT:
<xsl:if test="@available='true'">
O conteúdo é inserido aqui
</xsl:if>
os valores de sequência de caracteres devem ser definidos como true entre aspas. Dreamweaver codifica as aspas para você (') para que sejam inseridas como XHTML válido.
Além de testar nós para valores, você pode usar qualquer uma das funções XSLT compatíveis em qualquer instrução condicional.A condição é testada no nó atual do arquivo XML. No exemplo a seguir, você quer testar o último nó no conjunto de resultados:
Para mais informações e exemplos sobre como escrever expressões condicionais, consulte a seção <xsl:if> no painel de Referência (Ajuda > Referência).
Aplicar várias regiões condicionais XSLT
Você pode escrever uma expressão condicional simples para inserir na página XSLT.Se o conteúdo estiver selecionado ao abrir a caixa de diálogo Região condicional, o conteúdo é envolvido em um bloco <xsl:choose>.Se você não selecionar conteúdo, o bloco <xsl:choose> é adicionado no ponto de inserção na página.É uma boa ideia usar a caixa de diálogo para começar e depois personalizar a expressão na visualização de Código.
O elemento <xsl:choose> é semelhante à instrução case em outras linguagens.O elemento oferece uma forma de testar uma condição e tomar uma decisão com base no resultado.O elemento <xsl:choose> permite testar várias condições.
Selecione Inserir > Objetos XSLT > Região condicional múltipla ou clique no ícone Região condicional múltipla na categoria XSLT do painel Inserir.
Na caixa de diálogo Região condicional múltipla, insira
a primeira condição.
No exemplo a seguir, você quer testar para ver se o subelemento price do nó de contexto é menor que cinco.
Clique em OK.
No exemplo, o código a seguir é inserido na página XSLT:
<xsl:choose>
<xsl:when test="price<5">
O conteúdo é inserido aqui
</xsl:when>
<xsl:otherwise>
O conteúdo é inserido aqui
</xsl:otherwise>
</xsl:choose>
Para inserir outra condição, posicione o ponto de inserção
na visualização Código entre as tags <xsl:when>
ou antes da tag <xsl:otherwise> e
insira uma região condicional (Inserir > Objetos XSLT >
Região condicional).
Depois de especificar a condição e clicar em OK, outra tag <xsl:when> é inserida no bloco <xsl:choose>.
Para mais informações e exemplos sobre como escrever expressões condicionais, consulte as seções <xsl:choose> no painel Referência (Ajuda > Referência).
Definir propriedades da região condicional (If)
O objetivo do inspetor de propriedades Definir região condicional é alterar a condição usada em uma região condicional na página XSL. A região condicional testa a condição e executa uma ação com base no resultado.
Na caixa de teste, insira uma nova condição e pressione Enter.
Definir propriedades condicionais (When)
O objetivo do inspetor de propriedades Definir região condicional é alterar a condição usada em uma região condicional múltipla na página XSL. A região condicional múltipla testa a condição e executa uma ação com base no resultado.
Na caixa Teste, insira uma nova condição e pressione Enter.
Inserir comentários XSL
Você pode adicionar tags de comentário XSL a um documento ou pode envolver uma seleção em tags de comentário XSL.
Adicionar tags de comentário XSL a um documento
Siga um destes procedimentos:
Na visualização Design, selecione Inserir > Objetos XSLT > Comentário XSL, digite o conteúdo do comentário (ou deixe a caixa em branco) e clique em OK.
Na visualização Código, selecione Inserir > Objetos XSLT > Comentário XSL.
Nota
Você também pode clicar no ícone Comentário XSL na categoria XSLT do painel Inserir.
Envolver uma seleção em tags de comentário XSL
Mude para a visualização Código (Visualizar >
Código).
Selecione o código que deseja comentar.
Na barra de ferramentas Codificação, clique no botão Aplicar comentário
e selecione Aplicar comentário <xsl:comment></xsl:comment>.
Use o Construtor de expressões XPath para adicionar expressões para dados XML
XPath (XML Path Language) é uma sintaxe não XML para endereçar partes de um documento XML.É usado principalmente como uma linguagem de consulta para dados XML, assim como a linguagem SQL é usada para consultar bancos de dados.Para mais informações sobre XPath, consulte a especificação da linguagem XPath no site do W3C em www.w3.org/TR/xpath.
O Construtor de expressões XPath é um recurso do Dreamweaver que permite criar expressões XPath simples para identificar nós específicos de dados e para regiões repetidas.A vantagem de usar este método em vez de arrastar valores da árvore de esquemas XML é que você pode formatar o valor exibido.O contexto atual é identificado com base na posição do ponto de inserção no arquivo XSL quando a caixa de diálogo Construtor de expressões XPath é aberta. O contexto atual está em negrito na árvore de esquema XML. Conforme você faz seleções nesta caixa de diálogo, as instruções XPath corretas, relativas ao contexto atual, são geradas.Isso simplifica o processo de escrever expressões XPath corretas para iniciantes e usuários avançados.
esse recurso foi projetado para ajudar a criar expressões XPath simples para identificar um nó específico ou para regiões repetitivas. O recurso não permite editar as expressões manualmente. Se for necessário criar expressões complexas, use o Construtor de expressões XPath para começar e personalizar expressões na Visualização de código ou com o Inspetor de propriedades.
Criar uma expressão XPath para identificar um nó específico
Clique duas vezes no espaço reservado de dados XML
na página para abrir o Construtor de expressões XPath.
Na caixa de diálogo Construtor de expressões XPath (Texto dinâmico),
selecione qualquer nó na árvore de esquemas XML.
A expressão XPath correta é escrita na caixa Expressão para identificar o nó.
Nota
Se você selecionar um nó diferente na árvore de esquemas XML, a expressão muda para refletir sua escolha.
No exemplo a seguir, você deseja exibir o subelemento price do nó item:
Esta seleção inseriria o seguinte código na página XSLT:
<xsl:value-of select="price"/>
(Opcional) Selecione uma opção de formatação no menu
pop-up Formato.
Formatar uma seleção é útil quando o valor do nó retorna um número.Dreamweaver fornece uma lista predefinida de funções de formatação.Para uma lista completa das funções de formatação disponíveis e exemplos, consulte o painel Referência.
No exemplo a seguir, você deseja formatar o subelemento price como uma moeda com duas casas decimais:
Essas opções inseririam o seguinte código na página XSLT:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
Clique em OK.
Para exibir o valor de cada nó no arquivo XML, aplique
uma região repetida ao elemento que contém o texto dinâmico (por
exemplo, uma linha de tabela HTML ou um parágrafo).
Para mais informações e exemplos sobre seleção de nós para retornar um valor, consulte a seção <xsl:value-of/> no painel Referência.
Selecionar um nó para repetir
Você pode selecionar um nó para repetir e, opcionalmente, filtrar os resultados.Na caixa de diálogo Construtor de Expressões XPath, o conteúdo selecionado será colocado dentro de um bloco <xsl:for-each>.Se você não selecionou conteúdo, o bloco <xsl:for-each> será inserido no ponto de inserção do cursor.
Clique duas vezes no espaço reservado de dados XML na página
para abrir o Construtor de Expressões XPath.
Na caixa de diálogo Construtor de Expressões XPath (Região de Repetição), selecione
o item a repetir na árvore do esquema XML.
A expressão XPath correta é escrita na caixa Expressão para identificar o nó.
Nota
Itens de repetição são identificados com um símbolo de Mais (+) na árvore do esquema XML.
No exemplo a seguir, você quer repetir cada nó item dentro do arquivo XML.
Quando você clica em OK, o seguinte código é inserido na página XSLT:
<xsl:for-each select="provider/store/items/item">
O conteúdo é inserido aqui
</xsl:for-each>
Em alguns casos, você pode querer trabalhar com um subconjunto dos nós de repetição—por exemplo, você pode querer apenas itens onde um atributo tenha um Valor específico.Neste caso, você precisa criar um filtro.
Filtrar os dados a serem repetidos
Use um filtro para identificar nós de repetição que tenham valores de atributo específicos.
Na árvore de esquema XML, selecione um nó a ser repetido.
Clique no botão de expansão Criar filtro.
Clique no botão de adição (+) para criar um filtro vazio.
Insira os critérios de filtragem nos seguintes campos:
Filtrar por
Especifica o nó de repetição que contém os dados que você quer filtrar.O menu pop-up fornece uma lista de nós ancestrais relativos ao nó que você selecionou na árvore do esquema XML.
Onde
Especifica o atributo ou subelemento do nó Filtrar Por que será usado para limitar os resultados.Você pode selecionar um atributo ou subelemento do menu pop-up, ou pode inserir sua própria expressão XPath neste campo para identificar filhos que existem mais profundamente dentro da árvore do esquema.
Operador
Especifica o operador de comparação a usar na expressão do filtro.
Valor
Especifique o valor que deve ser verificado no nó Filtrar por. Insira o valor. Se parâmetros dinâmicos estão definidos para sua página XSLT, você pode selecionar um do menu pop-up.
Para especificar outro filtro, clique no botão Mais (+)
novamente.
Conforme você insere valores ou faz seleções nos menus pop-up, a expressão XPath na caixa Expressão muda.
No exemplo a seguir, você quer restringir o conjunto de resultados àqueles nós item onde o Valor do atributo @available é verdadeiro.
Quando você clica em OK, o seguinte código é inserido na página XSLT:<xsl:for-each select="provider/store/items/item[@available = 'true']"> O conteúdo vai aqui </xsl:for-each>
os valores de sequência de caracteres devem ser definidos como true entre aspas. Dreamweaver codifica as aspas para você (') para que sejam inseridas como XHTML válido.
Você pode criar filtros mais complexos que permitem especificar nós pai como parte dos critérios de filtro.No exemplo a seguir, você quer restringir o conjunto de resultados aos nós item onde o atributo @id do store é igual a 1 e o nó price do item é maior que 5.
Quando você clica em OK, o seguinte código é inserido na página XSLT:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Content goes here </xsl:for-each>
Para mais informações e exemplos de regiões de repetição, consulte a seção <xsl:for-each> no painel Referência.
Veja também
Criar belos sites no Dreamweaver
Crie, codifique e gerencie sites dinâmicos com uma ferramenta completa e eficiente.
