Pt:Templates: Parte III
From PRADO Wiki
"Templates" - Parte III
Tags de Propriedades Dinâmicas
Tags de Propriedades Dinâmicas são muito similares às tags de conteúdo dinâmico, exceto que elas são aplicadas às propriedades do componente. O propósito destas tags é permitir mais versatilidade às configurações de propriedades do componente. Note que, não é requerido a utilização de tags de propriedades dinãmicas porque o que pode ser feito utilizando-as também pode ser feito no seu código PHP. Contudo, sua utilização traz muito mais conveniência para realizar as mesmas tarefas. A utilização básica de propriedades dinâmicas é mostrada a seguir:
<com:ComponentType PropertyName=DynamicPropertyTag ...> body content </com:ComponentType>
onde você pode incluir "DynamicPropertyTag" com aspas simples ou duplas para melhor leitura.
Assim como tags de conteúdo dinâmico, nós temos tags de expressão, tags de ligação de dados. tags de parâmetros, tags de recursos e tags de localização. (Note que não existe tag de sentenças aqui)
Tags de Expressão
Uma tag de expressão representa uma expressão PHP que é avaliada (eval) quando o controle está no estágio "PreRender".
O resultado da avaliação da expressão é associado à propriedade correspondente do componente. O formato da tag de expressão é mostrado a seguir:
<%= PhpExpression %>
Na expressão, "$this" refere-se ao proprietário do controle de template. O exemplo a seguir especifica um controle "TLabel" que a propriedade "Text" é inicializada com o título da página corrente quando o "TLabel" é construído:
<com:TLabel Text=<%= $this->Page->Title %> />
Tags de ligação de dados
As tags de ligação de dados são similares às tags de expressão, exceto que elas apenas podem ser utilizadas com propriedades de controles e as expressões são avaliadas somente quando uma chamada "databind()" é invocada no controle representado pela tag de componente. Na expressão, "$this" refere-se ao proprietário do controle de template. As tags de ligação de dados não se aplicam à todos componentes. Elas apenas podem ser utilizadas para controles.
O formato da tag de ligação de dados é mostrado a seguir:
<%# PhpExpression %>
Tags de parâmetros
Tags de parâmetros são utilizadas para associar valores de parâmetros da aplicação às propriedades do componente correspondente. O formato das tags de parâmetros é mostrado a seguir:
<%$ ParameterName %>
Note que, parâmetros de aplicação são definidos normalmente nas configurações da aplicação ou nas configurações do diretório da página. Os parâmetros são avaliados (eval) quando o template é instanciado.
Tags de Recurso
As tags de recurso são utilizadas para publicar arquivos privados e associar as URL's correspondentes às propriedades do componente. Por exemplo, se você tem um arquivo de imagem que não é acessível pela web e você precisa fazê-lo visível à usuários-finais, você pode usar tags de recursos para publicar este arquivo e mostrar a URL aos usuários-finais e eles poderão localizar as imagens publicadas. As tags de recurso são avaliadas quando o template é instanciado.
O formato das tags de recurso é mostrado a seguir:
<%~ 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)".
