3 167
edições
Mudanças
Criação da Documentação da Predefinição Navbar.
{{subpágina de documentação}}
<!-- Categorias no final desta página e links para outros idiomas no Wikidata -->
{{#ifeq:{{BASEPAGENAME}}|Navbar|{{alto-risco| 225000 }}}}
{{lua|Módulo:Navbar}}
==Uso==
===Geral===
Quando um dos seguintes exemplos é posto dentro de uma dada [[Wikipédia:Predefinições de navegação|predefinição]], ela adiciona a navbar funcionalidade de navegação:
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|mini=s}}</nowiki></code>
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|simples=s}}</nowiki></code>
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|fontstyle=color: green; font-style: italic;}}</nowiki></code>
A <code><nowiki>{{subst:PAGENAME}}</nowiki></code> será substituída pelo nome da predefinição quando analisada sintaticamente pelos servidores. Por exemplo, <code><nowiki>{{navbar|Navbar/doc}}</nowiki></code> dá:<br />{{navbar|Navbar/doc}}
===Font-size===
Font-size (tamanho da fonte) é 88% quando usado numa navbar e 100% quando aninhado numa navbox.
Na navbar, o weight (peso) é "normal"; quando aninhado numa navbox, possui o mesmo que o do cenário externo. O middot é negrito. O parâmetro {{parâmetro|fontstyle}} pode ser usado para ajustar o tamanho da fonte quando necessário (ex. para reduzir tamanho da fonte ainda mais quando a predefinição é usada dentro de um elemento em bloco com um tamanho de fonte grande).
== Exemplos ==
===Parâmetros requeridos===
*<code><nowiki>{{Navbar|Nome da predefinição}}</nowiki></code> – o nome da predefinição é necessário.
===Parâmetros opcionais===
{| class="wikitable"
! Opções !! Parâmetros !! Produz... !! Predefinição de "atalho"
|-
| Básico || <code><nowiki>{{navbar|Nome da predefinição}}</nowiki></code> || {{navbar|Navbar/doc}} ||
|-
| Texto diferente || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''texto'''<nowiki>=Esta predefinição:}}</nowiki></code> || {{navbar|Navbar/doc|text=Esta predefinição:}} ||
|-
| Sem texto "Esta caixa:" || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''simples'''<nowiki>=s}}</nowiki></code> || {{Navbar|Navbar/doc|simples=s}} || {{tlg|view}}
|-
| Versão curta || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''mini'''<nowiki>=s}}</nowiki></code> || Lorem {{navbar|Navbar/doc|mini=s}} || {{tlg|v}}
|-
| Exemplos com estilização de fonte ([[Span e div|span]]) || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''fontstyle'''<nowiki>=color: green; font-style: italic;}}</nowiki></code> || {{navbar|Navbar/doc|fontstyle=color: green; font-style: italic;}} ||
|-
| Exemplos com estilização de predefinição completa ([[Span e div|div]]) || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''style'''<nowiki>=float:right; background: Beige; padding: 5px; border: 1px solid;}}</nowiki></code> || {{navbar|Navbar/doc|style=float:right; background: Beige; padding: 5px; border: 1px solid;}} ||
|}
===Predefinições de atalho ===
Os parâmetros <code>mini=s</code> e <code>simples=s</code> podem ser evitados ao utilizar as predefinições {{tlx|v}} ou {{tlx|view}}, respetivamente, em vez disso.
{{tl|view}} e {{tl|v}} também suportam alterar os links mostrados, por exemplo somente ver e editar, ou somente ver e discutir:
{| class="wikitable"
|-
! Código
! Resultado
|-
|{{demo|br=<td>|<nowiki>{{view|predefinição=view/doc|editar}}</nowiki>}}
|-
|{{demo|br=<td>|<nowiki>{{v|predefinição=v/doc|d}}</nowiki>}}
|}
==Notas==
Navbar é contida dentro dum {{tag|div}} para que acomode uma lista sem números horizontal. Isto significa que não pode ser posta dentro dum {{tag|span}} ou outro elemento em linha porque a extensão [[HTML Tidy]] irá 'ajeitar' situações onde encontra elementos em bloco dentro de elementos em linha.
== Pré-empacotados ==
;{{tlg|Navbar-header}}: Posiciona {{navbar|Navbar/doc|mini=1}} no canto direito da linha, frequentemente usado num cabeçalho de navbox não-desmontável.
;{{tlg|Navbar-navframe}}: Para uso em conjunção com [[Wikipédia:NavFrame#NavFrame divs|divs NavFrame ]], posiciona {{navbar|Navbar/doc|mini=1}} no lado oposto da função [ocultar]/[exibir].
;{{tlg|Navbar-collapsible}}: Para uso em conjunção com [[Wikipedia:NavFrame#Collapsible tables|tabelas desmontáveis]], flutua {{navbar|Navbar/doc|mini=1}} no lado oposto da função [ocultar]/[exibir].
== Ver também ==
* {{tlg|Vigiar}}
== TemplateData ==
<templatedata>
{
"description": "Quando posta dentro duma dada predefinição, adiciona a navbar funcionalidade de navegação",
"params": {
"": {
"label": "Nome da predefinição",
"description": "O nome da predefinição, para que links funcionem corretamente",
"type": "string",
"default": "",
"required": true
},
"texto": {
"label": "Texto diferente",
"description": "Permite texto personalizado para substituir o padrão 'esta caixa'",
"type": "string",
"default": "Esta caixa",
"required": false
},
"simples": {
"label": "Sem texto 'Esta caixa:'",
"description": "Remove 'Esta caixa'",
"type": "number",
"default": "0",
"required": false
},
"mini": {
"label": "Versão curta",
"description": "Encurta texto para V D E",
"type": "number",
"default": "0",
"required": false
},
"parênteses retos": {
"label": "Com parênteses",
"description": "adiciona parênteses antes e depois dos links",
"type": "number",
"default": "0",
"required": false
},
"fontstyle": {
"label": "Cor de fonte",
"description": "Permite-lhe alterar a cor da fonte (no formato color:green)",
"type": "string",
"default": "",
"required": false
},
"style": {
"label": "Para flutuar para o lado",
"description": "Permite à predefinição flutuar para o lado (formato=float:right)",
"type": "string",
"default": "float:left",
"required": false
}
}
}
</templatedata><includeonly>
<!-- Categorias aqui e links para outros idiomas no Wikidata -->
[[Categoria:!Predefinições de ligações internas]]
</includeonly>
<!-- Categorias no final desta página e links para outros idiomas no Wikidata -->
{{#ifeq:{{BASEPAGENAME}}|Navbar|{{alto-risco| 225000 }}}}
{{lua|Módulo:Navbar}}
==Uso==
===Geral===
Quando um dos seguintes exemplos é posto dentro de uma dada [[Wikipédia:Predefinições de navegação|predefinição]], ela adiciona a navbar funcionalidade de navegação:
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|mini=s}}</nowiki></code>
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|simples=s}}</nowiki></code>
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|fontstyle=color: green; font-style: italic;}}</nowiki></code>
A <code><nowiki>{{subst:PAGENAME}}</nowiki></code> será substituída pelo nome da predefinição quando analisada sintaticamente pelos servidores. Por exemplo, <code><nowiki>{{navbar|Navbar/doc}}</nowiki></code> dá:<br />{{navbar|Navbar/doc}}
===Font-size===
Font-size (tamanho da fonte) é 88% quando usado numa navbar e 100% quando aninhado numa navbox.
Na navbar, o weight (peso) é "normal"; quando aninhado numa navbox, possui o mesmo que o do cenário externo. O middot é negrito. O parâmetro {{parâmetro|fontstyle}} pode ser usado para ajustar o tamanho da fonte quando necessário (ex. para reduzir tamanho da fonte ainda mais quando a predefinição é usada dentro de um elemento em bloco com um tamanho de fonte grande).
== Exemplos ==
===Parâmetros requeridos===
*<code><nowiki>{{Navbar|Nome da predefinição}}</nowiki></code> – o nome da predefinição é necessário.
===Parâmetros opcionais===
{| class="wikitable"
! Opções !! Parâmetros !! Produz... !! Predefinição de "atalho"
|-
| Básico || <code><nowiki>{{navbar|Nome da predefinição}}</nowiki></code> || {{navbar|Navbar/doc}} ||
|-
| Texto diferente || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''texto'''<nowiki>=Esta predefinição:}}</nowiki></code> || {{navbar|Navbar/doc|text=Esta predefinição:}} ||
|-
| Sem texto "Esta caixa:" || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''simples'''<nowiki>=s}}</nowiki></code> || {{Navbar|Navbar/doc|simples=s}} || {{tlg|view}}
|-
| Versão curta || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''mini'''<nowiki>=s}}</nowiki></code> || Lorem {{navbar|Navbar/doc|mini=s}} || {{tlg|v}}
|-
| Exemplos com estilização de fonte ([[Span e div|span]]) || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''fontstyle'''<nowiki>=color: green; font-style: italic;}}</nowiki></code> || {{navbar|Navbar/doc|fontstyle=color: green; font-style: italic;}} ||
|-
| Exemplos com estilização de predefinição completa ([[Span e div|div]]) || <code><nowiki>{{navbar|Nome da predefinição|</nowiki>'''style'''<nowiki>=float:right; background: Beige; padding: 5px; border: 1px solid;}}</nowiki></code> || {{navbar|Navbar/doc|style=float:right; background: Beige; padding: 5px; border: 1px solid;}} ||
|}
===Predefinições de atalho ===
Os parâmetros <code>mini=s</code> e <code>simples=s</code> podem ser evitados ao utilizar as predefinições {{tlx|v}} ou {{tlx|view}}, respetivamente, em vez disso.
{{tl|view}} e {{tl|v}} também suportam alterar os links mostrados, por exemplo somente ver e editar, ou somente ver e discutir:
{| class="wikitable"
|-
! Código
! Resultado
|-
|{{demo|br=<td>|<nowiki>{{view|predefinição=view/doc|editar}}</nowiki>}}
|-
|{{demo|br=<td>|<nowiki>{{v|predefinição=v/doc|d}}</nowiki>}}
|}
==Notas==
Navbar é contida dentro dum {{tag|div}} para que acomode uma lista sem números horizontal. Isto significa que não pode ser posta dentro dum {{tag|span}} ou outro elemento em linha porque a extensão [[HTML Tidy]] irá 'ajeitar' situações onde encontra elementos em bloco dentro de elementos em linha.
== Pré-empacotados ==
;{{tlg|Navbar-header}}: Posiciona {{navbar|Navbar/doc|mini=1}} no canto direito da linha, frequentemente usado num cabeçalho de navbox não-desmontável.
;{{tlg|Navbar-navframe}}: Para uso em conjunção com [[Wikipédia:NavFrame#NavFrame divs|divs NavFrame ]], posiciona {{navbar|Navbar/doc|mini=1}} no lado oposto da função [ocultar]/[exibir].
;{{tlg|Navbar-collapsible}}: Para uso em conjunção com [[Wikipedia:NavFrame#Collapsible tables|tabelas desmontáveis]], flutua {{navbar|Navbar/doc|mini=1}} no lado oposto da função [ocultar]/[exibir].
== Ver também ==
* {{tlg|Vigiar}}
== TemplateData ==
<templatedata>
{
"description": "Quando posta dentro duma dada predefinição, adiciona a navbar funcionalidade de navegação",
"params": {
"": {
"label": "Nome da predefinição",
"description": "O nome da predefinição, para que links funcionem corretamente",
"type": "string",
"default": "",
"required": true
},
"texto": {
"label": "Texto diferente",
"description": "Permite texto personalizado para substituir o padrão 'esta caixa'",
"type": "string",
"default": "Esta caixa",
"required": false
},
"simples": {
"label": "Sem texto 'Esta caixa:'",
"description": "Remove 'Esta caixa'",
"type": "number",
"default": "0",
"required": false
},
"mini": {
"label": "Versão curta",
"description": "Encurta texto para V D E",
"type": "number",
"default": "0",
"required": false
},
"parênteses retos": {
"label": "Com parênteses",
"description": "adiciona parênteses antes e depois dos links",
"type": "number",
"default": "0",
"required": false
},
"fontstyle": {
"label": "Cor de fonte",
"description": "Permite-lhe alterar a cor da fonte (no formato color:green)",
"type": "string",
"default": "",
"required": false
},
"style": {
"label": "Para flutuar para o lado",
"description": "Permite à predefinição flutuar para o lado (formato=float:right)",
"type": "string",
"default": "float:left",
"required": false
}
}
}
</templatedata><includeonly>
<!-- Categorias aqui e links para outros idiomas no Wikidata -->
[[Categoria:!Predefinições de ligações internas]]
</includeonly>