Help:Funções sintáticas em predefinições

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Help:Parser functions in templates and the translation is 31% complete.

Outdated translations are marked like this.
Other languages:
العربية • ‎català • ‎Deutsch • ‎Zazaki • ‎English • ‎español • ‎suomi • ‎français • ‎italiano • ‎日本語 • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎Türkçe • ‎українська
PD Nota: Ao editar esta página, você concorda em publicar a sua contribuição no âmbito da licença CC0. Veja as páginas de ajuda do domínio público para mais informações.
PD

Ao aplicar as ParserFunctions nos parâmetros das predefinições, a barra vertical ("|") pode ser utilizada para fornecer a string vazia como valor padrão, a fim de indicar a forma de lidar com as coisas, se um parâmetro é ou não passado.

Used in an #if parser function, the unexpanded text from the undefined parameter will evaluate as true, which may be an unexpected result.

Testing parameters with and without default values
Condição de parâmetros {{{1}}}, {{{param}}} {{{1|}}}, {{{param|}}} {{#if:<parameter>|True|False}}
Description Example, unnamed and named {{{1}}}, {{{param}}} {{{1|}}}, {{{param|}}}
não definido:
parâmetro não utilizado,
importante para parâmetros com nome
{{template}} {{{1}}} True False
definido, mas nulo/vazio {{template|}}, {{template|1=}}, {{template|param=}} False False
definido
e
NÃO nulo nem vazio
{{template|value}}, {{template|1=value}}, {{template|param=value}} value value True True
  • {{{1}}}
Exemplo A
{{#if: {{{1}}} | Parâmetro 1 não está definido, ou é definido e não nulo/não vazio. | Parâmetro 1 é nulo. Ele contém só seqüência(s) de caracteres vazia(s) ou quebra(s) de espaço, etc}}
Resultado
Parâmetro 1 não está definido, ou é definido e não nulo/não vazio.
  • {{{1|}}}
Exemplo B
{{#if: {{{1|}}} | Parâmetro 1 está definido e é não nulo/não vazio. | Parâmetro 1 não está definido, ou é definido mas nulo. Ele contém apenas seqüência(s) de caracteres vazia(s) ou quebra(s) de espaço, etc}}
Resultado
Parâmetro 1 não está definido, ou é definido mas nulo. Ele contém só seqüência(s) de caracteres vazia(s) ou quebra(s) de espaço, etc

O segundo uso ({{{1|}}}, exemplo B) com padrão vazio presente é muitas vezes a forma desejada para lidar com situações em que existe um parâmetro, mas é composto apenas de espaços vazios.

Testing and passing undefined parameters[edit]

To distinguish a possibly empty parameter from an unspecified, one, compare it to itself using {{#ifeq:}} and different defaults. What the defaults are does not matter as long as they are different, so they are typically chosen to be short. The following all work equivalently:

{{#ifeq:{{{v|+}}}|{{{v|-}}}| v was defined (and may be empty) | v was not defined }}
{{#ifeq:{{{v|}}}|{{{v|-}}}| v was defined (and may be empty) | v was not defined }}
{{#ifeq:{{{v|}}}|{{{v}}}| v was defined (and may be empty) | v was not defined }}

Em casos raros, uma predefinição se comporta de maneira diferente quando um parâmetro não é especificado em relação a quando é especificado, mas vazio. Quando esta predefinição é usada por uma predefinição de envoltório (que usa o mesmo conjunto de parâmetros com nome), uma forma de assegurar que parâmetros indefinidos permaneçam indefinidos é a seguinte (a técnica também funciona com parâmetros numerados):

{{wrapped_template|
normal_parameter={{{normal_parameter|}}}|
sensitive_parameter{{#if:{{{sensitive_parameter|}}}||NULL}}={{{sensitive_parameter}}}
}}

Note que o wrapped_template recebe um normal_parameter especificado, mas vazio em dois casos: quando normal_parameter é especificado e vazio, e quando normal_parameter não é especificado (porque o valor padrão vazio é então especificado pela predefinição envoltório).

Por outro lado, o wrapped_template recebe um sensitive_parameter especificado apenas quando é de fato determinado, porque o #if altera o nome do parâmetro do wrapped_template para «sensitive_parameterNULL» quando o sensitive_parameter é indefinido.

The suffixed parameter name must be meaningless to the wrapped_template for this to work properly.

Ver também[edit]