A marca Include insere o código do modelo de apresentação referenciado no item do modelo de apresentação atual. Pode-se fazer referência ao segundo modelo de apresentação apenas por um caminho (templatepath).
Assim como uma inclusão no lado do servidor, a marca Include é usada com freqüência para exibir cabeçalhos, rodapés e outros tipos de conteúdo reutilizável dentro de uma página. O uso da marca Include garante que o conteúdo reutilizado apareça com uniformidade nas páginas e simplifica alterações: você só pode modificar o arquivo de modelo incluído, em vez de cada página do modelo que o usa.
Os modelos de apresentação incluídos se comportam como se recortados e colados no modelo de apresentação. Quando o modelo é executado, você pode acessar o item que está sendo publicado a partir de um modelo incluído, como se fosse o modelo principal para esse item.
Uma forma de usar cabeçalhos e rodapés é colocar todas as informações de formatação e layout no cabeçalho e no rodapé, e o modelo principal simplesmente lida com o preenchimento em uma célula de uma tabela. Por exemplo, se você extraiu as seções comentadas em três modelos de apresentação, poderia usar diferentes tipos de itens para o modelo de item principal, como neste exemplo:
<!-- Início do modelo com cabeçalho incluído:
-->
<html>
<head><title><pcs:value expr="item.title ∨ item.name"></pc:value></title></head>
<body>
<table border="1" height="100%">
<tr>
<td
colspan="2">Preencher com conteúdo de faixa superior</td>
</tr>
<tr>
<td
width="10%">Preencher com navegação esquerda</td>
<td
width="90%" align="left" valign="top">
<!-- Fim do modelo de cabeçalho -->
<!-- Início do modelo de item principal
-->
<pcs:include templatepath="ArticleHeader"><h1>Missing
ArticleHeader!</h1></pcs:include>
<h1><pcs:value expr="headline">HEADLINE</pcs:value></h1>
<p><pcs:value expr="body">BODY</pcs:value>
<pcs:include templatepath="ArticleFooter"><h1>Rodapé
de artigo ausente!</h1></pcs:include>
<!-- Fim do modelo de item principal -->
<!-- Início do modelo de rodapé incluído
-->
</td>
</tr>
<tr><td colspan="2">Rodapé
de página aqui</td></tr>
</table>
</body>
</html>
<!-- Fim do modelo de rodapé incluído -->
Se deseja exibir uma mensagem caso o modelo não seja encontrado, digite-a na caixa Texto se INCLUIR falhar. (Esse texto será exibido entre as marcas de abertura e fechamento <pcs> na caixa Marca PCS .)
|
Atributo |
Descrição |
| Sintaxe | <pcs:include templatepath="path">Seu conteúdo aqui.</pcs:include> |
|
Exemplo |
<pcs:include templatepath="/includes/footer">Copyright 2004</pcs:include> |
Se o modelo especificado não puder ser acessado, a inclusão falha e o conteúdo do elemento é avaliado. Neste exemplo, "Copyright 2003" seria exibido.