Mudanças

Ir para navegação Ir para pesquisar

Predefinição:Navbox com colunas/doc

19 236 bytes adicionados, 08h08min de 18 de dezembro de 2019
Criação da Documentação da Predefinição Navbox com colunas.
<noinclude>{{Subpágina de documentação}}</noinclude>
<includeonly>
{{nomobile}}
</includeonly>
{{Navbox suite}}
Uma caixa de navegação que apresenta o conteúdo em colunas. Inicialmente destinado a proporcionar um meio relativamente simples de alinhar ligações prefixadas por ícones da bandeira, por exemplo, em predefinições que oferecem links para artigos do país.

== Sintaxe ==
Parâmetros obrigatórios e ''colwidth'' incluído.

<pre style="overflow:auto;">
{{Navbox com colunas
|name = {{subst:PAGENAME}}
|title =
|colwidth = <!--(para definir um padrão largura para cada coluna, de preferência em uma unidade proporcional *)-->

|col1 =
|col2 =
}}
</pre>

<small>* Usando unidades proporcionais significa que a predefinição deverá ainda ser apresentada corretamente em toda a linha de navegador font-sizes. Se ''colwidth'' não especificado, é utilizado um padrão 10em.</small>

== Parâmetros ==
Parâmetros marcados com uma cruz '''<sup>†</sup>''' são parâmetros comuns com as predefinições-irmãs {{t1|Navbox}} e {{t1|Navbox with collapsible groups}}. Descrição completa desses parâmetros está disponível em {{t1|Navbox}}.

=== Parâmetros de definição ===
:;name<sup>†</sup>
::Nome da predefinição. É o nome que será usado no v-d-e. '''Obrigatório'''.

:;state<sup>†</sup>
::Valores possíveis são <code>collapsed</code>, <code>uncollapsed</code>, <code>plain</code>, <code>off</code>, e o padrão é <code>autocollapse</code>. Em {{t1|Navbox}} tem mais informações sobre esses valores.

:;''navbar''<sup>†</sup>
::Valores possíveis são <code>plain</code>, <code>off</code>, e o padrão é vazio. Veja {{t1|Navbox}} para melhores informações.

:;''border''<sup>†</sup>
::Valores possíveis são <code>child</code>, <code>none</code>, e o padrão é vazio. Coloque <code>child</code> se quiser usar essa navbox dentro de outra navbox; com essa opção, a navbox-filha fica sem borda e fits snuggly inside of its parent navbox. A navbox pode ser uma list area de {{t1|Navbox}}, uma coluna de outra {{t1|Navbox com colunas}}, ou uma seção de {{t1|Navbox com grupos desmontáveis}}. Veja {{t1|Navbox}} para melhores informações.

===Parâmetros básicos===
:;'''''title'''''<sup>†</sup>
::Título da predefinição, centralizado na barra de título na parte superior da predefinição.

:;''above''<sup>†</sup>
::Texto ou outros elementos que aparecem ACIMA das colunas.

:;''image''<sup>†</sup>
::Imagem na direita de todas as colunas.

:;''imageleft''<sup>†</sup>
::Imagem na esquerda de todas as colunas.

:;''below''<sup>†</sup>
::Texto ou outros elementos que aparecem ABAIXO das colunas.

===Parâmetros de estilo===
:;''bodystyle''<sup>†</sup>
::CSS aplicado para toda a predefinição (i.e. including space not used by columns)

:;''titlestyle''<sup>†</sup>
::[[Wikipedia:CSS|CSS]] aplicado para a barra de título; normalmente <code>background:''color''</code>. (background defaults to [[Wikipedia:NavFrame|NavHead]] default). A cor dos wikilinks tem que ser mudada manualmente usando as tags span. Por exemplo, use <code><nowiki>title = [[Scouting|<span style="color:ivory;">Scouting</span>]]</nowiki></code> para mudar a cor do link para marfim. Os botões [show]/[hide] e os links vde link usão a cor definida no parâmetro titlestyle. Um exemplo para definir o titlestyle:
:::<code>titlestyle = background:darkgreen;color:ivory;</code>

:;''abovestyle''<sup>†</sup>
:;''belowstyle''<sup>†</sup>
::CSS usada no parâmetros ''above'' e ''below'', respectivamente.

:;''basestyle''<sup>†</sup>
::CSS aplicada nos parâmetros ''title'', ''above'', ''below'', e ''group<sub>n</sub>'', todos ao mesmo tempo.

:;''imagestyle''<sup>†</sup>
::CSS usada no parâmetro ''image''. Não afecta os parâmetros image<sub>n</sub>.

:;''imageleftstyle''<sup>†</sup>
::CSS usada no parâmetro ''imageleft''. Não afecta os parâmetros image<sub>n</sub>.

:;''colstyle''
::CSS aplicada para todas as colunas; quando usado, normalmente é <code>background:''color''</code> per ''titlestyle'' above.

:;''oddcolstyle''
:;''evencolstyle''
::CSS style/s to apply to all odd/even-numbered columns, respectively.

:;''col<sub>n</sub>style''
::CSS aplicado apenas para a n<sup>ésima</sup> coluna.

:;''colheaderstyle''
::CSS aplicado para todos os cabeçalhos de coluna.

:;''col<sub>n</sub>headerstyle''
::CSS aplicado apenas para o n<sup>ésimo</sup> cabeçalho de coluna.

:;''col<sub>n</sub>footerstyle''
::CSS aplicado apenas para o n<sup>ésimo</sup> rodapé de coluna.

===Parâmetros de coluna===
:;''colwidth''
::Largura, preferencialmente com unidade proporcional, como '[[Em (typography)|em]]', ou porcentagem, usado para cada coluna que não tiver especificado ''col<sub>N</sub>width'' abaixo. Padrão é 10em. Exemplos:
:::<code>colwidth = 15em</code>
:::<code>colwidth = 25%</code>

:;''fullwidth''
::If set to anything, then the total width of the columns are scaled linearly to make the sum of the widths 100%. A rather advanced parameter, this usually need not be used and should be left blank. If a colheader or colfooter is used, then fullwidth is used automatically. Example:
:::<code>fullwidth = true</code>

:;''padding''
::Padding before first column, preferably in a proportional unit. Defaults to 5em. Padding is disabled by setting it to 0 (or 0em, or 0%).

:;''col<sub>n</sub>width''
::Largura da n<sup>ésima</sup> coluna (sobrescreve o parâmetro ''colwidth'' acima).

:;'''''col<sub>n</sub>'''''
::O conteúdo da n<sup>ésima</sup> coluna. Se qualquer coluna for usada, <code>col1</code> é necessária. No máximo 20 colunas, caso precise mais, precisa implementar o código.

:;''col<sub>n</sub>header''
::O cabeçalho da n<sup>ésima</sup> coluna,que aparece em cima dela. Exemplos abaixo.

:;''col<sub>n</sub>footer''
::O rodapé da n<sup>ésima</sup> coluna,que aparece abaixo dela. Exemplos abaixo.

:;''col<sub>n</sub>headercolspan''
::A number specifying how many columns the n<sup>th</sup> column header should span. It defaults to 1. If it is greater than one, then do not specify column headers that it covers. For example, if <code>col1headercolspan = 3</code>, then leave <code>col2header</code> and <code>col3header</code> blank.

:;''col<sub>n</sub>footercolspan''
::A number specifying how many columns the n<sup>th</sup> column footer should span. It defaults to 1. If it is greater than one, then do not specify column footers that it covers. For example, if <code>col1footercolspan = 3</code>, then leave <code>col2footer</code> and <code>col3footer</code> blank.

===Additional groups/lists===

AINDA NÃO IMPLEMENTADO

You may wish to add a few extra groups and/or lists below the columns. The following parameters are given to provide such functionality. See {{t1|Navbox}} for a more complete description of how they work, and for more examples.

:;''group<sub>n</sub>''<sup>†</sup>
::Allows up to 6 additional groups to go along with the lists below the columns.

:;''list<sub>n</sub>''<sup>†</sup>
::Allows up to 6 additional lists below the columns.

:;''groupstyle<sup>†</sup>''
::The general CSS style/s for the groups.

:;''group<sub>n</sub>''style<sup>†</sup>
::CSS style/s for the n<sup>th</sup> group parameter.

:;''liststyle''<sup>†</sup>
::The general CSS style/s for the lists.

:;''list<sub>n</sub>style''<sup>†</sup>
::CSS style/s for the n<sup>th</sup> list parameter.

:;''listpadding''<sup>†</sup>
::Amount of padding to have in each list cell.

:; ''oddstyle''
:; ''evenstyle''
::Applies to odd/even list numbers. Overrules styles defined by ''liststyle''. The default behavior is to add striped colors (white and gray) to odd/even rows, respectively, in order to improve readability. These should not be changed except in extraordinary circumstances.

:; ''evenodd'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
::See {{t1|Navbox}} for description.

== Exemplos ==

===Exemplo básico===
{{ExemploCódigo|{{Navbox with columns
|name = Navbox de exemplo
|title = Exemplo básico
|state = uncollapsed

|above = ''Aqui aparece o <nowiki>{{{above}}}</nowiki>''

|col1 = Aqui é a primeira coluna
|col2 = Aqui é a segunda coluna
|col3 = Aqui é a terceira coluna
|col4 = Aqui é a quarta coluna

|below = ''Aqui aparece o <nowiki>{{{below}}}</nowiki>''
}}
}}


===Exemplo com larguras percentuais===
<!-- agora o código -->
{{Navbox
|name=código
|title=Código
|titlestyle=background:white;
|liststyle = text-align: left;
|nogroups=true
|navbar=plain
|list1=
<pre>
{{Navbox with columns
| name = Exemplo com larguras percentuais
| title = Exemplo com larguras [[porcentagem|percentuais]]
| state = uncollapsed
| colwidth = 33%
| colstyle = text-align: center
| above = Todas tem 33% e são centralizadas devido ao <code>colstyle</code>
| col1 = Coluna 1
| col2 = Coluna 2
| col3 = Coluna 3
}}
</pre>
}}
{{Navbox with columns
| name = Exemplo com larguras percentuais
| title = Exemplo com larguras [[porcentagem|percentuais]]
| state = uncollapsed
| colwidth = 33%
| colstyle = text-align: center
| above = Todas tem 33% e são centralizadas devido ao <code>colstyle</code>
| col1 = Coluna 1
| col2 = Coluna 2
| col3 = Coluna 3
}}
===Exemplo com col<sub>n</sub>header e col<sub>n</sub>footer===
<!-- agora o código -->
{{Navbox
|name=código
|title=Código
|titlestyle=background:white;
|liststyle = text-align: left;
|nogroups=true
|navbar=plain
|list1=
<pre>
{{Navbox with columns
|name = Exemplo com colnheader e colnfooter
|state = uncollapsed
|title = Exemplo com col<sub>n</sub>header e col<sub>n</sub>footer
|colwidth = 25%
|above = Todas as colunas com 25%
|below = Todas as colunas com 25%

|col1header = col1header
|col2header = col2header
|col3header = col3header
|col4header = col4header

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4

|col1footer = col1footer
|col2footer = col2footer
|col3footer = col3footer
|col4footer = col4footer

}}
</pre>
}}
{{Navbox with columns
|name = Exemplo com colnheader e colnfooter
|state = uncollapsed
|title = Exemplo com col<sub>n</sub>header e col<sub>n</sub>footer
|colwidth = 25%
|above = Todas as colunas com 25%
|below = Todas as colunas com 25%

|col1header = col1header
|col2header = col2header
|col3header = col3header
|col4header = col4header

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4

|col1footer = col1footer
|col2footer = col2footer
|col3footer = col3footer
|col4footer = col4footer

}}

=== Exemplo com col<sub>n</sub>header usando col<sub>n</sub>headercolspan ===
O exemplo mostra com cabeçalho, mas pode ser usado no rodapé.

<!-- agora o código -->
{{Navbox
|name=código
|title=Código
|titlestyle=background:white;
|liststyle = text-align: left;
|nogroups=true
|navbar=plain
|list1=
<pre>
{{Navbox with columns
|name = Exemplo
|state = uncollapsed
|title = Exemplo com col<sub>n</sub>header usando col<sub>n</sub>headercolspan

|col1header = col1header
|col2header = col2header (colspan=2)
|col4header = col4header
|col5header = col5header (colspan=3)

|col2headercolspan = 2
|col5headercolspan = 3

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5
|col6 = col6
|col7 = col7
}}
</pre>
}}
{{Navbox with columns
|name = Exemplo
|state = uncollapsed
|title = Exemplo com col<sub>n</sub>header usando col<sub>n</sub>headercolspan

|col1header = col1header
|col2header = col2header (colspan=2)
|col4header = col4header
|col5header = col5header (colspan=3)

|col2headercolspan = 2
|col5headercolspan = 3

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5
|col6 = col6
|col7 = col7
}}

===Exemplo com mais campos===
The columns default to an off-white background and left text alignment. This example shows how you can use up to six additional groups/lists after the columns.
<!-- agora o código -->
{{Navbox
|name=código
|title=Código
|titlestyle=background:white;
|liststyle = text-align: left;
|nogroups=true
|navbar=plain
|list1=
<pre>
{{Navbox with columns
|name = Exemplo com mais campos
|state = uncollapsed
|title = Exemplo ilustrando mais campos
|image =
|imageleft =
|evencolstyle = text-align: center; background: #F5FFF5;
|oddcolstyle = text-align: right; background: #FFFFE6;
|abovestyle = background: #E6E6FF;
|belowstyle = background: #FFE6EA;
|titlestyle = background: #FFF;

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5

|col1header = col1header
|col2header = col2header
|col3header = col3header
|col4header = col4header
|col5header = col5header

|col1footer = col1footer
|col2footer = col2footer
|col3footer = col3footer
|col4footer = col4footer
|col5footer = col5footer

|group1 = group1
|group2 = group2
|group3 = group3
|group4 = group4
|group5 = group5
|group6 = group6

|list1 = list1
|list2 = list2
|list3 = list3
|list4 = list4
|list5 = list5
|list6 = list6

|above = O <nowiki>{{{above}}}</nowiki> fica acima das colunas
|below = O <nowiki>{{{below}}}</nowiki> fica abaixo das colunas
}}
</pre>
}}
{{Navbox with columns
|name = Exemplo com mais campos
|state = uncollapsed
|title = Exemplo ilustrando mais campos
|evencolstyle = text-align: center; background: #F5FFF5;
|oddcolstyle = text-align: right; background: #FFFFE6;
|abovestyle = background: #E6E6FF;
|belowstyle = background: #FFE6EA;
|titlestyle = background: #FFF;

|image =
|imageleft =

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5

|col1header = col1header
|col2header = col2header
|col3header = col3header
|col4header = col4header
|col5header = col5header

|col1footer = col1footer
|col2footer = col2footer
|col3footer = col3footer
|col4footer = col4footer
|col5footer = col5footer

|group1 = group1
|group2 = group2
|group3 = group3
|group4 = group4
|group5 = group5
|group6 = group6

|list1 = list1
|list2 = list2
|list3 = list3
|list4 = list4
|list5 = list5
|list6 = list6

|above = O <nowiki>{{{above}}}</nowiki> fica acima das colunas
|below = O <nowiki>{{{below}}}</nowiki> fica abaixo das colunas
}}

=== Exemplo com 20 colunas ===
<!-- agora o código -->
{{Navbox
|name=código
|title=Código
|titlestyle=background:white;
|liststyle = text-align: left;
|nogroups=true
|navbar=plain
|list1=
<pre style="overflow:scroll;">
{{Navbox with columns
|name = Navbox com 20 colunas
|title = Navbox com 20 colunas
|state = uncollapsed

|colstyle= text-align:center;border:solid 0.5px

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5
|col6 = col6
|col7 = col7
|col8 = col8
|col9 = col9
|col10 = col10
|col11 = col11
|col12 = col12
|col13 = col13
|col14 = col14
|col15 = col15
|col16 = col16
|col17 = col17
|col18 = col18
|col19 = col19
|col20 = col20
}}
</pre>
}}
{{Navbox with columns
|name = Navbox com 20 colunas
|title = Navbox com 20 colunas
|state = uncollapsed

|colstyle= text-align:center;border:solid 0.5px

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5
|col6 = col6
|col7 = col7
|col8 = col8
|col9 = col9
|col10 = col10
|col11 = col11
|col12 = col12
|col13 = col13
|col14 = col14
|col15 = col15
|col16 = col16
|col17 = col17
|col18 = col18
|col19 = col19
|col20 = col20
}}

==Usando child navboxes==
Todas as predefinições navbox, a saber: {{t1|Navbox}}, {{t1|Navbox with columns}}, e {{t1|Navbox with collapsible groups}}, podem ser aninhadas uma dentro da outra, usando o parâmetro <code>border</code> (que é comum às três). Para predefinições complexas, pode ser necessário o aninhamento para atingir o visual desejado.

===Aninhando Navbox with columns nela mesmo===
Este exemplo mostra como uma pode aninhar várias Predefinições {{t1|Navbox with columns}} para obter a aparência certa. Edite esta seção para ver o código. Há uma principal {{t1|Navbox with columns}} e duas adicionais Predefinições {{t1|Navbox with columns}}, com a opção definida "child" (ver código).

{{Navbox with columns
|name = Navbox with columns/doc
|state = uncollapsed
|title = Subgrupos com aninhamento
|colstyle = text-align:center;background:silver;

|col1width = 33%
|col2width = 17%
|col3width = 33%
|col4width = 17%

|col1header = Col1Header
|col2header = Col2Header
|col3header = Col3Header
|col4header = Col4Header

|col1 = {{Navbox with columns|child
|colwidth = 50%
|colstyle = text-align:center;background:silver;
|navbar = plain
|title = Col1

|col1header = Col1.1Header
|col2header = Col1.2Header

|col1 = Col1.1
|col2 = Col1.2
}}

|col2 = Col2

|col3 = {{Navbox with columns|child
|colwidth = 33%
|colstyle = text-align:center;background:silver;
|navbar = plain
|title = Col3

|col1header = Col3.1Header
|col2header = Col3.2Header
|col3header = Col3.3Header

|col1 = Col3.1
|col2 = Col3.2
|col3 = Col3.3
}}

|col4 = Col4
}}

===Aninhando outras formas de Navbox ===
Esse exemplo mostra {{t1|Navbox}}, {{t1|Navbox with collapsible groups}} e {{t1|Navbox with columns}} trabalhando juntas. Edite esta seção para ver o código. Note que cada uma das navboxes-filha possui a opção definida "child" (ver código).

{{Navbox with collapsible groups
|name = Navbox with collapsible groups
|title = {{t1|Navbox}}, {{t1|Navbox with columns}}, e {{t1|Navbox with collapsible groups}} juntas
|selected = {{{1|}}}

|group1 = Primeiro grupo da {{t1|Navbox with collapsible groups}}
|list1 = Primeiro list da {{t1|Navbox with collapsible groups}}

|list2 = {{Navbox|child
|navbar = plain
|title = Exemplo de Navbox-filha
|titlestyle = background#
|groupstyle = background:lavender;

|group1 = Grupo 1
|list1 = Grupo 1.1 {{·}} Grupo 1.2 {{·}} Grupo 1.3

|group2 = Grupo 2
|list2 = Grupo 2.1 {{·}} Grupo 2.2 {{·}} Grupo 2.3

|group3 = Grupo 3
|list3 = Grupo 3.1 {{·}} Grupo 3.2 {{·}} Grupo 3.3

|group4 = Grupo 4
|list4 = Grupo 4.1 {{·}} Grupo 4.2 {{·}} Grupo 4.3

|group5 = Grupo 5
|list5 = Grupo 5.1 {{·}} Grupo 5.2 {{·}} Grupo 5.3

|group6 = Grupo 6
|list6 = Grupo 6.1 {{·}} Grupo 6.2 {{·}} Grupo 6.3

}}

|group3 = Terceiro grupo da {{t1|Navbox with collapsible groups}}
|list3 = Terceiro list da {{t1|Navbox with collapsible groups}}

|list4 = {{Navbox with columns|child
|navbar = plain
|title = {{t1|Navbox with columns}} dentro da {{t1|Navbox with collapsible groups}}
|colstyle = text-align:center;

|col1width = 33%
|col2width = 17%
|col3width = 33%
|col4width = 17%

|col1header = Col1Header
|col2header = Col2Header
|col3header = Col3Header
|col4header = Col4Header

|col1 = {{Navbox with columns|child
|navbar = plain
|colwidth = 50%
|colstyle = text-align:center;

|col1header = Col1.1Header
|col2header = Col1.2Header

|col1 = Col1.1
|col2 = Col1.2
}}

|col2 = Col2

|col3 = {{Navbox with columns|child
|navbar = plain
|colwidth = 33%
|colstyle = text-align:center;

|col1header = Col3.1Header
|col2header = Col3.2Header
|col3header = Col3.3Header

|col1 = Col3.1
|col2 = Col3.2
|col3 = Col3.3
}}

|col4 = Col4
}}

}}

== Ver também ==
* {{t1|Navbox}} &ndash; Permite grupos/listas ao invés de colunas
* {{t1|Navbox with collapsible groups}} &ndash; Outra variação:Navbox com navboxes dentro.

{{Predefinição:Modelo de navegação}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|Testes||
[[Categoria:!Predefinições para caixas de navegação]]
}}</includeonly>

Menu de navegação