Predefinição:Se vazio/doc

Esta é uma subpágina de documentação para a Predefinição:Se vazio.
Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original.

Esta predefinição é usada em 4 600+ páginas. (Ver Wikihelp:Predefinições em alto risco)
Para evitar sobrecargas desnecessárias ao servidor e outros transtornos, quaisquer mudanças devem ser previamente testadas, seja na predefinição de testes ou em Predefinição:Se vazio/doc/Testes (ou ainda em sua página de testes). Por favor, sempre considere expor eventuais mudanças na página de discussão, antes de implementá-las.

Redirecionamentos

{{If empty}}
{{Ifempty}}

Esta predefinição usa Lua:

Módulo:Se vazio

Descrição

Esta é a predefinição {{Se vazio}}. Anteriormente, estava limitada a no máximo nove parâmetros. Esta limitação atualmente não existe mais.

A predefinição é usada geralmente dentro de outras predefinições. Ela recebe qualquer número de parâmetros e retorna o primeiro parâmetro que não foi vazio. Se nenhum foi encontrado, nada é retornado.

Uso

Seu uso tipicamente é feito como:

{{Se vazio |{{{logo|}}} |{{{imagem|}}} |{{{figura|}}} |padrão.svg}}

Ele retornará o primeiro dos parâmetros logo, imagem e figura que foi definido e não é vazio, se não, retornará padrão.svg .

Exemplos

Código	Resultado	Descrição
`{{Se vazio}}`		Retorna uma string vazia
`{{Se vazio\|um}}`	um	Retorna o primeiro parâmetro definido não vazio.
`{{Se vazio\|um\|dois}}`	um
`{{Se vazio\|\|dois}}`	dois	O primeiro parâmetro está vazio/indefinido, então é pulado.