Marcação Condicional

Usando a diretiva (:if:)

A diretiva (:if:) A diretiva if permite que partes de uma página sejam incluidas ou excluidas da renderização. As formas genéricas da diretiva (:if:) são:

Onde "cond" é uma condição à ser testada, e "param" é um parâmetro ou outro argumento da condição.

Note que (:if:) sem parâmetros e (:ifend:) sõ identicos. Note também que (:if cond:) fecha automaticamente uma condição prévia. Para aninhamento em múltiplos níveis, veja Condições aninhadas.

Condições embutidas

As condições embutidas incluem:

Os condicionais nome e grupo funcionarão mesmo para uma página incluída, como o "nome" e "grupo" condicionais sempre verificar a página exibida atualmente, em oposição a página que a marcação aparece dentro.

Nota : Although there is no built-in conditional markup to test ?action=, you can use (:if equal {$Action} AÇÃO:) to test what the current action being requested is. Nota: não há marcação condicional embutida para testar qual é a "?action=" atual. Embora seja possível usar (:if equal {$Action} AÇÃO:) para testar qual a ação atual está sendo solicitada.

Condicionais negativadas

Condicionais negativadas também funcionam:

Aninhando condicionais

Note que (:if cond:) automaticamente fecha uma condional prévia. Assim, os dois exemplos a seguir tem o mesmo significado:

• (:if cond1:) cond1 é verdadeira (:if cond2:) cond2 é verdadeira (:ifend:)
• (:if cond1:) cond1 é verdadeira (:ifend:)(:if cond2:) cond2 é verdadeira (:ifend:)

Condicionais podem ser aninhadas desde a versão 2.2.beta 66. Para aninhar condionais você precisa numerar os IFs, and ELSE/IFEND correspondentes:

(:if cond1:)
  cond1 é verdadeira
  (:if2 cond2:)
     cond1 e cond2 são verdadeiras
  (:else2:)
     cond1  é verdadeira, cond2 não é
  (:if2end:)
(:else:)
  cond1 é falsa, cond2 teste foi ignorado
(:ifend:)

espaços foram adicionados para uma melhor leitura.

Usando coringas para cobrir espaços

O caractere * pode ser usado como um curinga para representar qualquer personagem, zero, um ou mais vezes. O caractere ? pode ser usado como um curinga para representar qualquer caractere exatamente uma vez. Os caracteres curinga ( * e ? ) podem ser usados com as condicionais de nome e grupo, assim:

Usando PageTextVariables, PageVariables e MarkupExpressions

Variáveis de Texto da Página -> Page text variables (PTVs), variáveis de página -> page variables (PVs) e expressões de marcação-> markup expressions podem ser usadas em conditionais. Estes serão atribuidos/avaliados antes das condicionais.

Combinando condicionais

Condicionais (como previamente definido) podem ser combinadas para formar expressões condicionais mais complexas usando uma das três formas equivalentes:

(:if expr EXPRESSÃO :)
(:if [ EXPRESSÃO ] :)
(:if ( EXPRESSÃO ) :)

As condições são combinadas em expressões com operadores booleanos e parênteses.Na tabela ao lado, A e B são condições regulares ou sub-expressões entre colchetes de condições regulares:

Exemplo

(:if [ name SomePage and group SomeGroup ]:)    equivalent to (:if name SomeGroup.SomePage:)

Notas Importantes:

• Espaços são necessários no início e fim de operadores e parênteses.
• Nenhum aviso é dado para erros de sintaxe or unbalanced brackets.
• Use parênteses para expressões aninhadas.

Assim, o que se segue é uma maneira válida de se construir uma expressão que mostra o seguinte conteúdo somente quando o usuário é o administrador, ou está conectado e o tempo é mais tarde que data indicada:

Aninhamento com colchetes falharão silenciosamente:

Um uso comum destes testes complexos para expressões como:

que fornecem um link de logout(saida) só quando o usuário tem permissões parar admin, attr, ou edit.

administradores (avançado)

Criando novas condicionais

Veja +.

Veja também referências especiais para o uso de {*$Variáveis}.