Predefinição:Ficha/doc
Esta é uma subpágina de documentação para a Predefinição:Ficha. 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. |
{{{acima}}} | |
---|---|
{{{subcabeçalho}}} | |
{{{subcabeçalho2}}} ...... | |
{{{imagem}}} {{{legenda}}} | |
{{{imagem2}}} {{{legenda2}}} ...... | |
{{{cabeçalho1}}} Predefinição:Nobold | |
{{{rótulo1}}} | {{{dados1}}} |
( ou ) | |
{{{dados1}}} | |
{{{cabeçalho2}}} | |
{{{rótulo2}}} | {{{dados2}}} |
( ou ) | |
{{{dados2}}} | |
( etc ) | |
{{{abaixo}}} | |
A predefinição em a intenção de ser uma metapredefinição: uma predefinição usada para construir outras predefinições. Nota: No geral, não é para ser usada diretamente num artigo, mas pode ser usada uma vez ou outra caso necessário.
Índice
Uso
Para [[Predefinição:Ficha algumtópico]]
ou [[Predefinição:Info/algumtópico]]
, o código aparece dessa forma, simplificado:
{{Ficha | nome = {{{name|{{{nome|{{PAGENAME}}}}}}}} | imagem = {{{image|{{{imagem|}}}}}} | legenda1 = {{{caption|{{{legenda|}}}}}} | rótulo1 = Nomes anteriores | dados1 = {{{former_names|{{{nomes_anteriores|}}}}}} | cabeçalho2 = Informação geral | rótulo3 = Status | dados3 = {{{status|}}} ... <!-- etc. --> }}
Parâmetros de controlo opcionais
- nome
- Se este parâmetro estiver presente, serão adicionados links "ver/discutir/editar" ao fim da infocaixa, que apontam para a página nomeada. Pode usar o valor {{subst:PAGENAME}}; no entanto, isto é raramente o que quer, porque enviará utilizadoras(es) ao dar click nestes links numa infocaixa num artigo ao código da predefinição, em vez dos dados da infocaixa que provavelmente querem.
- filha
- Veja a secção Incorporação para detalhes. Se estiver definida com "sim", esta infocaixa filha deve possuir título mas não o parâmetro nome. O parâmetro é vazio por padrão, defina-o como "sim" para ativá-lo.
- subcaixa
- Veja a secção Subcaixas para detalhes. Se estiver definida como "sim", esta subcaixa deve possuir nome mas não o parâmetro nome. O parâmetro é vazio por padrão, defina-o como "sim" para ativá-lo. Não tem efeito caso o parâmetro filha também estiver definido como "sim".
- descat
- Se estiver definido como "sim", a página atual não será autocategorizada numa categoria de manutenção quando a infocaixa gerada tiver alguns problemas ou nenhuma secção de dados visível. Deixe-o vazio por padrão ou defina-o como "sim" para ativá-lo.
Parâmetros de conteúdo
Título
Há duas maneiras diferentes para pôr um título numa infocaixa. Uma contém o título dentro da borda da infocaixa na célula mais acima da tabela, a outra põe-no como uma legenda no topo da tabela. Pode usar as duas maneiras juntas se quiser, ou apenas uma ou a outra, ou até nenhuma (embora não seja recomendado):
- título
- Texto para pôr na legenda sobre o topo da tabela (ou como cabeçalho de secção antes do conteúdo inteiro desta tabela, caso seja uma infocaixa filha). Por razões de acessibilidade, esta é a alternativa mais recomendada.
- acima
- Texto para pôr dentro da célula mais acima da tabela.
- subcabeçalho(n)
- campos de título adicionais abaixo de {{{título}}} e {{{acima}}}, mas antes de imagens.
Exemplos:
Subcabeçalho da infocaixa | |
{{Ficha | nome = {{subst:PAGENAME}} | título = Texto na legenda sobre a infocaixa in caption over infobox | subcabeçalho = Subcabeçalho da infocaixa | cabeçalho = (o resto da infocaixa vai aqui) }}
Texto na célula mais acima da infocaixa | |
---|---|
Subcaixa da infocaixa | |
Segunda subcaixa da infocaixa | |
{{Ficha | nome = {{subst:PAGENAME}} | acima = Texto na célula mais acima da infocaixa | subcabeçalho = Subcaixa da infocaixa | subcabeçalho2 = Segunda subcaixa da infocaixa | cabeçalho = (o resto da infocaixa vai aqui) }}
Imagens de ilustração
- imagem(n)
- imagens para exibir no topo da predefiição. Use sintaxe de imagem completa, por exemplo [[Ficheiro:example.png|200px|alt=Texto alt de exemplo]]. Imagem é centralizada por padrão. Veja WP:ALT para mais sobre texto alt.
- legenda(n)
- Texto para pôr embaixo das imagens.
Dados principais
- cabeçalho(n)
- Texto para usar como o cabeçalho em fileira n.
- rótulo(n)
- Texto para usar como um rótulo em fileira n.
- dados(n)
- Texto para exibir como dado em fileira n.
Nota: para qualquer valor dado para (n), nem todas as combinações de parâmetros são permitidas. A presença de um |cabeçalho(n)=
causará o |dados(n)=
correspondente (e |linha-classe(n)=
|rótulo(n)=
, veja abaixo) ser ignorado; a ausência de um |dados(n)=
causará o |rótulo(n)=
correspondente ser ignorado. Combinações válidas para uma única fileira são:
|classe(n)=
|cabeçalho(n)=
|linha-classe(n)=
|classe(n)=
|dados(n)=
|linha-classe(n)=
|rótulo(n)=
|classe(n)=
|dados(n)=
Veja a renderização de cabeçalho4, rótulo e dados4 na secção Exemplos abaixo.
Tornar campos de dados opcionais
Uma fileira com um rótulo mas nenhum dado não é exibida. Isto permite que a criação fácil de fileiras de conteúdo de infocaixa opcionais. Para fazer uma fileira opcional use um parâmetro que tem um string vazio como padrão, como o seguinte:
| rótulo5 = População | dados5 = {{{população|}}}
Desta maneira, se um artigo não definir o parâmetro população em sua infocaixa, a fileira não será exibida.
Para campos mais complexos com conteúdos pré-formatados que ainda estariam presentes mesmo se o parâmetro não estivesse definido, pode juntá-los todos num declaração "#if" para fazer toda a coisa desaparecer quando o parâmetro não for usado. Por exemplo, a declaração "#if" no próximo exemplo diz "#if (#se):o parâmetro massa foi suprido |então exibi-lo, seguido por 'kg'":
| rótulo6 = Massa | dados6 = {{ #if: {{{massa|}}} | {{{massa}}} kg }}
Para mais sobre #if, veja aqui.
Esconder cabeçalhos quando todos os dados forem ocultados
Pode também tornar cabeçalhos opcionais de uma maneira similar. Considere este exemplo:
Cabeçalho indesejável | |
---|---|
Cabeçalho estático | |
Item estático | Valor estático |
{{Ficha | título = Exemplo de um cabeçalho indesejável | cabeçalho1 = Cabeçalho indesejável | rótulo2 = Item 1 | dados2 = | rótulo3 = Item 2 | dados3 = | rótulo4 = Item 3 | dados4 = | cabeçalho5 = Cabeçalho estático | rótulo6 = Item estático | dados6 = Valor estático }}
Se quiser que o primeiro cabeçalho apareça somente se um ou mais compos de dados que caem sobre ele, pode ser usado o seguinte padrão como exemplo de como o fazer:
Cabeçalho estático | |
---|---|
Item estático | Valor estático |
{{Ficha | título = Exemplo de um cabeçalho opcional | cabeçalho1 = {{ #if: {{{item1|}}}{{{item2|}}}{{{item3|}}} | Cabeçalho opcional }} | rótulo2 = Item 1 | dados2 = {{{item1|}}} | rótulo3 = Item 2 | dados3 = {{{item2|}}} | rótulo4 = Item 3 | dados4 = {{{item3|}}} | cabeçalho5 = Cabeçalho estático | rótulo6 = Item estático | dados6 = Valor estático }}
cabeçalho1 será mostrado caso qualquer item1, item2 ou item3 for definido. Se nenhum dos três parâmetros for definido, o cabeçalho não será mostrado e nenhuma fileira vazia aparece antes do próximo conteúdo estático. O truque para isto é que o "#if" retorna falso somente se não haja nada na secção condicional, então a declaração irá falhar somente se todos os três, item1, item2 e item3, forem indefinidos.
Note que tal truque possa ser às vezes muito complexo para testar caso haja muitos itens de dados cujo valor depende de testes complexos (ou quando uma fileira de dados for gerada por uma invocação desta predefinição como uma subcaixa).
Rodapé
- abaixo
- Texto para pôr na célula de baixo. A célula de baixo tem a intenção de ser usada para notas de rodapé, "ver também" e outra informação relacionada.
Parâmetros de apresentação
Títulos em itálico
Títulos de artigos com infocaixas podem tornar-se itálicos ao passar o parâmetro título itálico
.
- Ligue títulos em itálicos ao passar
|título itálico={{{título itálico|}}}
da infocaixa. - Desligar por padrão (particularmente porque somente letras do alfabeto latino podem ser renderizados seguramente neste estilo e itálico pode ser necessário para distinguir a língua estrangeira da língua portuguesa local somente com as letras do alfabeto latino, mas seria difícil de ler com outros alfabetos) mas permitir algumas instâncias para utilizar estilo em itálico ao passar
|título itálico={{{título itálico|não}}}
- Não permitir títulos em itálico ao não passar sequer o parâmetro.
Estilização com CSS
- corpo-estilo
- Aplica-se à tabela de infocaixa como um todo
- título-estilo
- Aplica-se somente à legenda de título. Adicionar uma cor de fundo não é aconselhável, já que o texto é renderizado "fora" da infocaixa.
- acima-estilo
- Aplica-se somente à célula "acima" no topo. O estilo padrão tem font-size:125%; visto que esta célula é comummente usada para um título. Caso queira usar a célula acima para texto de tamanho regular, inclua "font-size:100%;" no acima-estilo.
- imagem-estilo
- Aplica-se à célula em que a imagem está. Isto inclui o texto da legenda de imagem, mas deve definir propriedades de texto com legenda-estilo em vez de imagem-estilo para caso a legenda seja movida para fora da célula no futuro.
- legenda-estilo
- Aplica-se ao texto da legenda de imagem.
- linha-estilo(n)
- O parâmetro é inserido ao atributo
style
para a fileira especificado. - cabeçalho-estilo
- Aplica-se a todas as células de cabeçalho
- rótulo-estilo
- Aplica-se a todas as células de rótulo
- dados-estilo
- Aplica-se a todas as células de dados
- abaixo-estilo
- Aplica-se somente à célula abaixo
Classes de HTML e microformatos
- corpo-classe
- Este parâmetro é inserido ao atributo
class
para a infocaixa como um todo. - título-classe
- Este parâmetro é inserido ao atributo
class
para a legenda título da infocaixa. - acima-classe
- Este parâmetro é inserido ao atributo
class
para a célula acima da infocaixa. - subcabeçalho-linha-classe(n)
- Este parâmetro é inserido ao atributo
class
para a fileira completa da tabela em que subcabeçalho está. - subcabeçalho-classe(n)
- Este parâmetro inserido ao atributo
class
para o subcabeçalho da infocaixa. - imagem-linha-classe(n)
- Estes parâmetros são inseridos ao atributo
class
para a fileira completa da tabela em que sua respetiva imagem esteja. - imagem-classe
- Este parâmetro é inserido ao atributo
class
para a imagem. - linha-classe(n)
- Este parâmetro é inserido ao atributo
class
para a fileira especificada, inclusive as células rótulo e dados. - classe(n)
- Este parâmetro é inserido ao atributo
class
para a célula dados da fileira especificada. Se não há nenhuma célula dados, não há nenhum efeito. - abaixo-classe
- Este parâmetro é inserido ao atributo
class
para a célula abaixo da infocaixa.
Esta predefinição suporta a adição de informação de microformato. Isto é feito ao adicionar atributos "class" a várias células de dados, a indicar que tipo de informação contém. Múltiplos nomes de classes podem ser especificados, separados por espaços, alguns deles usados como seletoras para estilização personalizada de acordo com uma política de projeto ou com a skin selecionada nas preferências de usuários, outros usados para microformatos.
Para sinalizar uma infocaixa como informação que contém hCard, por exemplo, adicione o seguinte parâmetro:
| corpo-classe = vcard
E para cada fileira que contém uma célula de dados que faz parte do vcard, adicione um parâmetro de classe correspondente:
| classe1 = fn | classe2 = org | classe3 = tel
...e assim por diante. Pode-se dar classes para "acima" e "título", já que estes são comummente usados para exibir o nome do assunto da infocaixa.
Veja microformato para mais informação sobre microformatos em geral.
Exemplos
Perceba como a fileira não aparece na infocaixa exibida quando um rótulo é definido sem uma célula dados acompanhante, e como eles todos são exibidos quando um cabeçalho é definido na mesma linha que uma célula dados. Também perceba que subcabeçalhos são possuem um estilo negrito por padrão como os cabeçalhos usados para dividir a secção de dados principais, porque esta função é para a célula acima :
{{Ficha |nome = {{subst:PAGENAME}} |corpo-estilo = |título-estilo = |acima-estilo = background:#cfc; |subcabeçalho-estilo = |título = Ficha de teste |acima = Texto acima |subcabeçalho = Subcabeçalho acima de imagem |subcabeçalho2 = Segundo subcabeçalho |imagem-estilo = |legenda-estilo = |imagem = [[Ficheiro:Example-serious.jpg|200px|alt=Texto alt de exemplo]] |legenda = Legenda exibida abaixo de Ficheiro:Example-serious.jpg |cabeçalho-estilo = background:#ccf; |rótulo-estilo = background:#ddf; |dados-estilo = |cabeçalho1 = Cabeçalho definido sozinho | rótulo1 = | dados1 = |cabeçalho2 = | rótulo2 = Rótulo definido sozinho que não é exibido (necessita de dados ou é suprimido) | dados2 = |cabeçalho3 = | rótulo3 = | dados3 = Dado definido sozinho |cabeçalho4 = Todos os três definidos (cabeçalho, rótulo, dados, todos com o mesmo número) | rótulo4 = não é exibido (mesmo número que um cabeçalho) | dados4 = não é exibido (mesmo número que um cabeçalho) |cabeçalho5 = | rótulo5 = Rótulo e dados definidos (rótulo) | dados5 = Rótulo e dados definidos (dados) |abaixo-estilo = background:#ddf; |abaixo = Texto abaixo }}
Para este exemplo, os parâmetros corpo-estilo e rótulo-estilo são usados para ajustar a largura da infobox e definir uma largura padrão para a coluna de rótulos:
Rótulo 1 | Dado 1 |
---|---|
Rótulo 2 | Dado 2 |
Rótulo 3 | Dado 3 |
Cabeçalho 4 | |
Rótulo 5 | Dado 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
Texto abaixo | |
{{Ficha |nome = {{subst:PAGENAME}} |corpo-estilo = width:20em |título-estilo = |título = Ficha de testes |cabeçalho-estilo = |rótulo-estilo = width:33% |dados-estilo = |cabeçalho1 = | rótulo1 = Rótulo 1 | dados1 = Dado 1 |cabeçalho2 = | rótulo2 = Rótulo 2 | dados2 = Dado 2 |cabeçalho3 = | rótulo3 = Rótulo 3 | dados3 = Dado 3 |cabeçalho4 = Cabeçalho 4 | rótulo4 = | dados4 = |cabeçalho5 = | rótulo5 = Rótulo 5 | dados5 = Dado 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |abaixo-estilo = |abaixo = Texto abaixo }}
Incorporação
Uma predefinição de infocaixa pode ser incorporada a outra ao usar o parâmetro |filha=
. Esta função pode ser usada para criar uma infocaixa moduar ou para criar secções lógicas melhor definidas.
Primeira subsecção | |
Rótulo 1.1 | Dado 1.1 |
---|---|
Segunda subsecção | |
Rótulo 2.1 | Dado 2.1 |
Texto abaixo |
{{Ficha |título = Título de nível máximo | dados1 = {{Ficha | descat = sim | filha = sim |título = Primeira subsecção | rótulo1 = Rótulo 1.1 | dados1 = Dado 1.1 }} | dados2 = {{Ficha | descat = sim | filha = sim |título = Segunda subsecção | rótulo1 = Rótulo 2.1 | dados1 = Dado 2.1 }} | abaixo-estilo = | abaixo = Texto abaixo }}
Note, nos exemplos acima, a infocaixa filha é posta num campo dados
, não num campo cabeçalho
. Perceba que subcabeçalhos não estão em negrito caso negrito não seja explicitamente especificado. Para obter negrito em cabeçalhos, coloque a infocaixa filha num campo cabeçalho (mas não num campo rótulo porque não seria exibida!), use ou
Primeira subsecção | |
---|---|
Segunda subsecção | |
Rótulo 2.1 | Dado 2.1 |
Texto abaixo |
{{Ficha |título = Título de nível máximo | cabeçalho1 = {{Ficha | descat = sim | filha = sim |título = Primeira subsecção | rótulo1 = Rótulo 1.1 | dado1 = Dados 1.1 }} | cabeçalho2 = {{Ficha | descat = sim | filha = sim |título = Segunda subsecção | rótulo1 = Rótulo 2.1 | dados1 = Dado 2.1 }} | abaixo-estilo = | abaixo = Texto abaixo }}
ou,
Primeira subsecção | |
---|---|
Rótulo 1.1 | Dado 1.1 |
Segunda subsecção | |
Rótulo 2.1 | Dado 2.1 |
Texto abaixo |
{{Ficha | título = Título de nível máximo | cabeçalho1 = Primeira subsecção {{Ficha | descat = sim | filha = sim | rótulo1 = Rótulo 1.1 | dados1 = Dado 1.1 }} | cabeçalho2 = Segunda subsecção {{Ficha | descat = sim | filha = sim | rótulo1 = Rótulo 2.1 | dados1 = Dado 2.1 }} | abaixo-estilo = | abaixo = Texto abaixo }}
Note que omitir o parâmetro |título=
, e não incluir qualquer texto que precede a infocaixa incorporada, pode resultar em fileiras de tabela em branco falsos e criar vãos ma apresentação visual.
Subcaixas
Um método alternativo para incorporar é usar |subcaixa=Predefinição:Var
, que remove a borda externa da infocaixa, mas preserva a estrutura interior. Uma função desta abordagem é que as caixas mãe e filha não necessitam de ter a mesma estrutura e os campos rótulo e dados não são alinhados entre as caixas mãe e filha porque não estão na mesma tabela mãe.
Principal 1 | |||||||
---|---|---|---|---|---|---|---|
Principal 2 | |||||||
| |||||||
| |||||||
Rótulo 5 | Dado 5 | ||||||
Principal 6 |
{{Ficha |cabeçalho-estilo = background-color:#eee; |rótulo-estilo = background-color:#eee; |cabeçalho1 = Principal 1 |cabeçalho2 = Principal 2 | dados3 = {{Ficha | subcaixa = sim |cabeçalho-estilo = background-color:#ccc; |rótulo-estilo = background-color:#ddd; |cabeçalho1 = Sub 3-1 |cabeçalho2 = Sub 3-2 | rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3 }} | dados4 = {{Ficha | subcaixa = sim | rótulo-estilo = background-color:#ccc; | rótulo1 = Rótulo 4-1 | dados1 = Dado 4-1 }} | rótulo5 = Rótulo 5 | dados5 = Dado 5 |cabeçalho6 = Principal 6 }}
Técnicas de incorporação similares podem ser usadas dentro de parâmetros de conteúdo de algumas outras predefinições que geram tabelas (como {{Predefinição:!((:Predefinição:Sidebar|SidebarPredefinição:))!}}) :
{{Sidebar | navbar = off | headingstyle = background-color:#eee; | heading1 = Cabeçalho 1 | heading2 = Cabeçalho 2 | content3 = {{Ficha | subcaixa = sim | cabeçalho-estilo = background-color:#ccc; | rótulo-estilo = background-color:#ddd; | cabeçalho1 = Sub 3-1 | cabeçalho2 = Sub 3-2 | rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3 }} | content4 = {{Ficha | subcaixa = sim | rótulo-estilo = background-color:#ccc; | rótulo1 = Label 4-1 | dado1 = Dado 4-1 }} | heading5 = Cabeçalho 5 }}
Note que o padding padrão da célula de dado da mãe que contém cada subcaixa ainda está visível, então as subcaixas são um bocadinho mais estreitas que a caixa mãe e há um espaçamento vertical mais alto entre células padrão da caixa mãe do que entre células de subcaixas distintas.
Controlar quebra de linha em listas sem bullets incorporadas
Predefinição {{nbsp}}
pode ser usada com {{wbr}}
e {{nowrap}}
para controlar quebra de linha em listas sem bullets incorporadas em infocaixas (ex. lista de elenco), para prevenir entradas longas e envoltas de ser confundidas com múltiplas entradas.
Sintaxe em branco completa
(Nota: não há limite de número de fileiras possíveis, mas somente 20 são exibidas abaixo. Apenas aumente a numeração o quanto necessário. Os parâmetros "class" de microformatos também são omitidos, visto que não são comummente usados.)
{{Ficha | nome = {{subst:PAGENAME}} | filha = {{{filha|}}} | subcaixa = {{{subcaixa|}}} | título itálico = {{{título itálico|não}}} | corpo-estilo = | título-estilo = | acima-estilo = | subcabeçalho-estilo = | título = | acima = | subcabeçalho = | imagem-estilo = | legenda-estilo = | imagem = | legenda = | imagem2 = | legenda2 = | cabeçalho-estilo = | rótulo-estilo = | dados-estilo = | cabeçalho1 = | rótulo1 = | dados1 = | cabeçalho2 = | rótulo2 = | dados2 = | cabeçalho3 = | rótulo3 = | dados3 = | cabeçalho4 = | rótulo4 = | dados4 = | cabeçalho5 = | rótulo5 = | dados5 = | cabeçalho6 = | rótulo6 = | dados6 = | cabeçalho7 = | rótulo7 = | dados7 = | cabeçalho8 = | rótulo8 = | dados8 = | cabeçalho9 = | rótulo9 = | dados9 = | cabeçalho10 = | rótulo10 = | dados10 = | cabeçalho11 = | rótulo11 = | dados11 = | cabeçalho12 = | rótulo12 = | dados12 = | cabeçalho13 = | rótulo13 = | dados13 = | cabeçalho14 = | rótulo14 = | dados14 = | cabeçalho15 = | rótulo15 = | dados15 = | cabeçalho16 = | rótulo16 = | dados16 = | cabeçalho17 = | rótulo17 = | dados17 = | cabeçalho18 = | rótulo18 = | dados18 = | cabeçalho19 = | rótulo19 = | dados19 = | cabeçalho20 = | rótulo20 = | dados20 = | abaixo-estilo = | abaixo = }}