Pt:Templates: Parte II
From PRADO Wiki
"Templates": Parte II
Tags de conteúdo dinâmico
Tags de conteúdo dinâmico são introduzidas como atalho para alguma tag de componente normalmente utilizada. Estas tags são utilizadas principalmente para gerar algum conteúdo através da avaliação (eval) de algumas expressões ou sentenças PHP. Eles incluem tags de expressão, tags de sentença, tags de ligação de dados (databind), tags de parâmetros, tags de recursos (assets) e tags de localização.
Tags de expressão
Uma tag de expressão representa uma expressão PHP que será avaliada (eval) quando o controle template está no estágio "PreRender". O resultado da avaliação da expressão é inserido no lugar onde a tag foi colocada no template. O contexto
( $this ) da expressão é o proprietário do controle do template.
O formato de uma tag de expressão é como segue:
<%= PhpExpression %>
Por exemplo, a tag de expressão a seguir irá exibir o título da página corrente em seu lugar:
<%= $this->Title %>
Tags de Sentença
Tags de sentença são similares às tags de expressão, exceto que as tags de sentença contém sentenças PHP maiores que expressões. A saída das sentenças PHP ( usando, por exemplo, "echo" ou "print" ) são exibidas no lugar onde a tag foi colocada no template. Veja o formato das tags de sentença a seguir:
<%%
PHP Statements
%>
O exemplo a seguir exibe o tempo corrente na Holanda no seu lugar.
<%%
setlocale(LC_ALL, 'nl_NL');
echo strftime("%A %e %B %Y",time());
%>
Tags de ligação de Dados
Tags de ligaçãod de Dados são similares às tags de expressão, exceto que estas expressões são avaliadas (eval) somente quando a chamada "databind()" é invocada nos controles representados nas tags de ligação de dados. O contexto, ($this) da expressão da ligação de dados é o proprietário do controle do template. O formato da tag de ligação de dados é como segue:
<%# PhpExpression %>
Tags de Parâmetros
Tags de parâmetros são usados para inserir parâmetros da aplicação no lugar onde elas aparecem no template. O formato desta tag é como segue:
<%$ ParameterName %>
Note que, parâmetros da aplicação são normalmentre definidos na configuração da aplicação ou na configuração do diretório da página. Os parâmetros são avaliados (eval) quando o template é instanciado.
Tags de Recursos
As Tags de recursos são usadas para publicar arquivos privados e exibir a URL correspondente. Por exemplo, se você possue um arquivo de imagem que não é acessível pela web e você precisa fazê-lo visível, você pode usar as tags de recurso para publicar este arquivo e exibir a URL para usuários-finais. Com isto, eles poderãp buscar a imagem publicada.
O formato da tag de recurso é como segue:
<%~ LocalFileName %>
onde "LocalFileName" refere-se ao path do arquivo que é relativo ao diretório que contém o arquivo do template corrente. O path do arquivo pode ser um simples arquivo ou um diretório. Se for o último, todo conteúdo do diretório será acessível aos usuários-finais.
TENHA MUITO CUIDADO quendo você utilizar tags de recursos, pois isto pode expor à usuários-finais arquivos que você provavelmente não quer que eles vejam.
Tags de Localização
Tags de localização representam textos com localização. Elas são no seguinte formato:
<%[string]%>
onde "string" será traduzida para diferentes línguas de acordo com a preferência de linguagem do usuário-final. Tags de localização são de fato atalhos para a chamada da função "Prado::localize(string)".
