Exibir código-fonte para Predefinição:Hlist/doc

{{Subpágina de documentação}}
{{Lua|Módulo:Lista}}
{{Utiliza TemplateStyles|Predefinição:Hlist/styles.css}}
Esta predefinição cria <!--[[:en:Wikipedia:Manual of Style/Accessibility#Horizontal lists]]-->listas horizontais. Cada item da lista pode ser estilizado individualmente com [[Cascading Style Sheets|''CSS'']].
__TOC__
{{-}}
==Uso==
'''Uso básico'''

{{Pre|<nowiki>{{</nowiki>Hlist<nowiki>|</nowiki>''primeiro item''<nowiki>|</nowiki>''segundo item''<nowiki>|</nowiki>''terceiro item''<nowiki>|</nowiki>...<nowiki>}}</nowiki>}}

'''Todos os parâmetros'''

{{Pre|
<nowiki>{{</nowiki>Hlist
<nowiki>|</nowiki>''primeiro item''<nowiki>|</nowiki>''segundo item''<nowiki>|</nowiki>''terceiro item''<nowiki>|</nowiki>...
<nowiki>|classe        = </nowiki>''classe para a marcação div''
<nowiki>|estilo        = </nowiki>''estilo para a marcação div''
<nowiki>|lista_estilo  = </nowiki>''estilo para a marcação ul''
<nowiki>|item_estilo   = </nowiki>''estilo para todas as marcações li''
<nowiki>|item1_estilo  = </nowiki>''estilo para a primeira a marcação li''
<nowiki>|item2_estilo  = </nowiki>''estilo para segunda a marcação li''
<nowiki>|</nowiki>...
<nowiki>|indentar      = </nowiki>''o número de tabulações para indentar''
<nowiki>}}</nowiki>
}}

'''Exemplo'''

{{Tnull|Hlist|''Jazz''|''rock''|''pop''|''rap''}}

produz:

{{Hlist|''Jazz''|''rock''|''pop''|''rap''}}

==Parâmetros==
* Parâmetros posicionais ({{Parâmetro|1}}, {{Parâmetro|2}}, {{Parâmetro|3}}...): estes são os itens da lista. Se nenhum item da lista estiver presente, o módulo não produzirá saída alguma.
* {{Parâmetro|class}} ou {{Parâmetro|classe}}: uma classe personalizada para as marcações {{Tag|div}} ao redor da lista. Defina como <code>inline</code> ao usar {{Tlf|Hlist}} dentro de texto.
* {{Parâmetro|style}} ou {{Parâmetro|estilo}}: um estilo de ''CSS'' personalizado para as marcações {{Tag|div}} ao redor da lista, por exemplo <code>font-size: 90%;</code>.
* {{Parâmetro|list_style}} ou {{Parâmetro|lista_estilo}}: um estilo de ''CSS'' personalizado para as marcações {{Tag|ul}} na lista. O formato é o mesmo dos parâmetros {{Parâmetro|style}} ou {{Parâmetro|estilo}}.
* {{Parâmetro|item_style}} ou {{Parâmetro|item_estilo}}: um estilo de ''CSS''  personalizado para todos os itens da lista (as marcações {{Tag|li}}). O formato é o mesmo dos parâmetros {{Parâmetro|style}} ou {{Parâmetro|estilo}}.
*:Evite usar o estilo <code>white-space:nowrap</code> no parâmetro {{Parâmetro|item_style}} (ou {{Parâmetro|item_estilo}}), porque ele terá o efeito indesejado de evitar quebras de linha em qualquer lugar da lista, em vez de apenas dentro do item da lista; a solução alternativa é mover esse estilo no parâmetro {{Parâmetro|list_style}} (ou {{Parâmetro|lista_estilo}} e, em seguida, inserir {{Ligação para predefinição|Wbr}} no início de cada valor de item, para inserir uma oportunidade invisível de quebra de palavra (e não no final do valor do item, pois a quebra de palavra ocorreria logo antes do separador de marcadores com espaçamento à direita).
* {{Parâmetro|item1_style}} ou {{Parâmetro|item1_estilo}}, {{Parâmetro|item2_style}} ou {{Parâmetro|item2_estilo}}, {{Parâmetro|item3_style}} ou {{Parâmetro|item3_estilo}}...: estilos de ''CSS'' personalizados para cada um dos itens da lista. O formato é o mesmo dos parâmetros {{Parâmetro|style}} ou {{Parâmetro|estilo}}.
* {{Parâmetro|indent}} ou {{Parâmetro|indentar}}: o número de tabulações para indentar a lista. O valor padrão é 0.

==Exemplos==
{{Markup
| <nowiki>{{Hlist|entrada1|entrada2|entrada3|entrada4
|entrada5|entrada6|entrada7|entrada8|entrada9}}</nowiki>
| {{Hlist|entrada1|entrada2|entrada3|entrada4
|entrada5|entrada6|entrada7|entrada8|entrada9}}

| <nowiki>✘ Planetas gigantes ({{Hlist|[[Júpiter (planeta)|J]]|[[Saturno (planeta)|S]]|[[Urano (planeta)|U]]|[[Netuno (planeta)|N]]}}).</nowiki>
| ✘ Planetas gigantes ({{Hlist|[[Júpiter (planeta)|J]]|[[Saturno (planeta)|S]]|[[Urano (planeta)|U]]|[[Netuno (planeta)|N]]}}). ''(marcação incorreta)''

| <nowiki>✔ Planetas gigantes ({{Hlist|classe=inline|[[Júpiter (planeta)|J]]|[[Saturno (planeta)|S]]|[[Urano (planeta)|U]]|[[Netuno (planeta)|N]]}}).</nowiki>
| ✔ Planetas gigantes ({{Hlist|classe=inline|[[Júpiter (planeta)|J]]|[[Saturno (planeta)|S]]|[[Urano (planeta)|U]]|[[Netuno (planeta)|N]]}}). ''(marcação correta)''

| <nowiki>{{Hlist|Vencedor|Vice-campeão|Terceiro lugar|indentar=2}}</nowiki>
| {{Hlist|Vencedor|Vice-campeão|Terceiro lugar|indentar=2}}

| <nowiki>{{Hlist|Vencedor|Vice-campeão|Terceiro lugar|item_style=color:blue;}}</nowiki>
| {{Hlist|Vencedor|Vice-campeão|Terceiro lugar|item_estilo=color:blue;}}

| <nowiki>{{Hlist|Vencedor|Vice-campeão|Terceiro lugar|item1_estilo=background-color:yellow;color:black;|item2_estilo=background-color:silver;color:black;}}</nowiki>
| {{Hlist|Vencedor|Vice-campeão|Terceiro lugar|item1_estilo=background-color:yellow;color:black;|item2_estilo=background-color:silver;color:black;}}
}}

==Evitando erros da Linter==
{{Tlf|Hlist}} produzirá  [[Special:LintErrors/misc-tidy-replacement-issues|erros]] da <!--[[:en:Wikipedia:Linter]]-->Linter se colocado dentro de uma predefinição que usa marcações {{Tag|span}} , como {{Ligação para predefinição|Small}}, {{Ligação para predefinição|Large}}, etc. Para evitar isso, use as substituições da tabela abaixo:

{| <!---->class="wikitable
! {{Não3|}} {{Cross}} Marcação incorreta !! {{Sim3|}} {{Tick}} Marcação correta
|-
| <code><nowiki>{{Small|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:85%}}</nowiki></code>
|-
| <code><nowiki>{{Redimensionar|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:90%}}</nowiki></code>
|-
| <code><nowiki>{{Midsize|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:92%}}</nowiki></code>
|-
| <code><nowiki>{{Large|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:120%}}</nowiki></code>
|-
| <code><nowiki>{{Grande|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:120%}}</nowiki></code>
|-
| <code><nowiki>{{Larger|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:120%}}</nowiki></code>
|-
| <code><nowiki>{{Huge|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:180%}}</nowiki></code>
|-
| <code><nowiki>{{Redimensionar|x%|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:x%}}</nowiki></code>
|-
| <code><nowiki>{{Font|size=x%|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=font-size:x%}}</nowiki></code>
|-
| <code><nowiki>{{Nowrap|{{Hlist|...}}}}</nowiki></code> || <code><nowiki>{{Hlist|...|estilo=white-space: nowrap}}</nowiki></code>
|}

<includeonly>{{Testes outro||
[[Categoria:!Predefinições de formatação de listas]]
}}</includeonly><noinclude>
[[en:Template:Hlist/doc]]
</noinclude>