Módulo:Navbox
Aspeto
Este módulo está na categoria sujeitos a proteção de página. Ele é um módulo de alta visibilidade em uso por um grande número de páginas, ou é transcluído muito frequentemente. Por causa do vandalismo ou erros que podem afectar muitas páginas, e mesmo edições triviais podem causar cargas substanciais nos servidores, ele está protegido de editar. |
Este módulo é usado em aproximadamente 410 000 páginas. (Ver Wikipedia:Predefinições em alto risco) Para evitar sobrecargas desnecessárias ao servidor e outros transtornos, quaisquer mudanças devem ser previamente testadas, seja na subpágina de testes deste módulo, na subpágina de testes de módulos (ou ainda em sua subpágina de testes). Por favor, sempre considere expor eventuais mudanças na página de discussão, antes de implementá-las. |
Descrição
Este Módulo implementa a predefinição {{Navbox}}. Por favor consulte a predefinição para mais instruções.
Uso
Outra documentação:
--
-- This module implements {{Navbox}}
--
local p = {}
local navbar = require('Módulo:Navbar')._navbar
local getArgs -- lazily initialized
local args
local border
local listnums
local ODD_EVEN_MARKER = '\127_ODDEVEN_\127'
local RESTART_MARKER = '\127_ODDEVEN0_\127'
local REGEX_MARKER = '\127_ODDEVEN(%d?)_\127'
local function striped(wikitext)
-- Return wikitext with markers replaced for odd/even striping.
-- Child (subgroup) navboxes are flagged with a category that is removed
-- by parent navboxes. The result is that the category shows all pages
-- where a child navbox is not contained in a parent navbox.
local orphanCat = '[[Categoria:!Navecaixas órfãs]]'
local argsOrphan = args.orphan or args['órfã']
if border == 'subgroup' and argsOrphan ~= 'yes' and argsOrphan ~= 'sim' or border == 'subgrupo' and argsOrphan ~= 'yes' and argsOrphan ~= 'sim' then
-- No change; striping occurs in outermost navbox.
return wikitext .. orphanCat
end
local first, second = 'odd', 'even'
if args.evenodd or args['pares-ímpares'] then
if args.evenodd == 'swap' or args.evenodd == 'trocar' or args['pares-ímpares'] == 'swap' or args['pares-ímpares'] == 'trocar' then
first, second = second, first
else
first = args.evenodd or args['pares-ímpares']
second = first
end
end
local changer
if first == second then
changer = first
else
local index = 0
changer = function (code)
if code == '0' then
-- Current occurrence is for a group before a nested table.
-- Set it to first as a valid although pointless class.
-- The next occurrence will be the first row after a title
-- in a subgroup and will also be first.
index = 0
return first
end
index = index + 1
return index % 2 == 1 and first or second
end
end
local regex = orphanCat:gsub('([%[%]])', '%%%1')
return (wikitext:gsub(regex, ''):gsub(REGEX_MARKER, changer)) -- () omits gsub count
end
local function processItem(item, nowrapitems)
if item:sub(1, 2) == '{|' then
-- Applying nowrap to lines in a table does not make sense.
-- Add newlines to compensate for trim of x in |parm=x in a template.
return '\n' .. item ..'\n'
end
if nowrapitems == 'yes' or nowrapitems == 'sim' then
local lines = {}
for line in (item .. '\n'):gmatch('([^\n]*)\n') do
local prefix, content = line:match('^([*:;#]+)%s*(.*)')
if prefix and not content:match('^<span class="nowrap">') then
line = prefix .. '<span class="nowrap">' .. content .. '</span>'
end
table.insert(lines, line)
end
item = table.concat(lines, '\n')
end
if item:match('^[*:;#]') then
return '\n' .. item ..'\n'
end
return item
end
local function renderNavBar(titleCell)
local argsName = args.name or args.nome
if args.navbar ~= 'off' and args.navbar ~= 'desligada' and args.navbar ~= 'desligado' and args.navbar ~= 'desligar' and args.navbar ~= 'plain' and args.navbar ~= 'simples' and not (not argsName and mw.getCurrentFrame():getParent():getTitle():gsub('/Testes$', '') == 'Predefinição:Navbox') then
titleCell:wikitext(navbar{
argsName,
mini = 1,
fontstyle = (args.basestyle or args['estilo-base'] or '') .. ';' .. (args.titlestyle or args['estilo-título'] or '') .. ';background:none transparent;border:none;-moz-box-shadow:none;-webkit-box-shadow:none;box-shadow:none; padding:0;'
})
end
end
--
-- Title row
--
local function renderTitleRow(tbl)
if not args.title and not args['título'] then return end
local titleRow = tbl:tag('tr')
if args.titlegroup or args['grupo-título'] then
titleRow
:tag('th')
:attr('scope', 'row')
:addClass('navbox-group')
:addClass(args.titlegroupclass or args['classe-grupo-título'])
:cssText(args.basestyle or args['estilo-base'])
:cssText(args.groupstyle or args['estilo-grupo'])
:cssText(args.titlegroupstyle or args['estilo-grupo-título'])
:wikitext(args.titlegroup or args['grupo-título'])
end
local titleCell = titleRow:tag('th'):attr('scope', 'col')
if args.titlegroup or args['grupo-título'] then
titleCell
:css('border-left', '2px solid #fdfdfd')
:css('width', '100%')
end
local titleColspan = 2
if args.imageleft or args['imagem-esquerda'] then titleColspan = titleColspan + 1 end
if args.image or args.imagem then titleColspan = titleColspan + 1 end
if args.titlegroup or args['grupo-título'] then titleColspan = titleColspan - 1 end
titleCell
:cssText(args.basestyle or args['estilo-base'])
:cssText(args.titlestyle or args['estilo-título'])
:addClass('navbox-title')
:attr('colspan', titleColspan)
renderNavBar(titleCell)
titleCell
:tag('div')
-- id for aria-labelledby attribute
:attr('id', mw.uri.anchorEncode(args.title or args['título']))
:addClass(args.titleclass or args['classe-título'])
:css('font-size', '114%')
:css('margin', '0 4em')
:wikitext(processItem(args.title or args['título']))
end
--
-- Above/Below rows
--
local function getAboveBelowColspan()
local ret = 2
if args.imageleft or args['imagem-esquerda'] then ret = ret + 1 end
if args.image or args.imagem then ret = ret + 1 end
return ret
end
local function renderAboveRow(tbl)
if not args.above and not args.acima then return end
tbl:tag('tr')
:tag('td')
:addClass('navbox-abovebelow')
:addClass(args.aboveclass or args['classe-acima'])
:cssText(args.basestyle or args['estilo-base'])
:cssText(args.abovestyle or args['estilo-acima'])
:attr('colspan', getAboveBelowColspan())
:tag('div')
-- id for aria-labelledby attribute, if no title
:attr('id', args.title and nil or args['título'] and nil or mw.uri.anchorEncode(args.above or args.acima))
:wikitext(processItem(args.above or args.acima, args.nowrapitems or args['nowrap-itens']))
end
local function renderBelowRow(tbl)
if not args.below and not args.abaixo then return end
tbl:tag('tr')
:tag('td')
:addClass('navbox-abovebelow')
:addClass(args.belowclass or args['classe-abaixo'])
:cssText(args.basestyle or args['estilo-base'])
:cssText(args.belowstyle or args['estilo-abaixo'])
:attr('colspan', getAboveBelowColspan())
:tag('div')
:wikitext(processItem(args.below or args.abaixo, args.nowrapitems or args['nowrap-itens']))
end
--
-- List rows
--
local function renderListRow(tbl, index, listnum)
local row = tbl:tag('tr')
if index == 1 and args.imageleft or index == 1 and args['imagem-esquerda'] then
row
:tag('td')
:addClass('navbox-image')
:addClass(args.imageclass or args['classe-imagem'])
:css('width', '1px') -- Minimize width
:css('padding', '0px 2px 0px 0px')
:cssText(args.imageleftstyle or args['estilo-imagem-esquerda'])
:attr('rowspan', #listnums)
:tag('div')
:wikitext(processItem(args.imageleft or args['imagem-esquerda']))
end
if args['group' .. listnum] or args['grupo' .. listnum] then
local groupCell = row:tag('th')
-- id for aria-labelledby attribute, if lone group with no title or above
if listnum == 1 and not (args.title or args['título'] or args.above or args.acima or args.group2 or args.grupo2) then
groupCell
:attr('id', mw.uri.anchorEncode(args.group1 or args.grupo1))
end
groupCell
:attr('scope', 'row')
:addClass('navbox-group')
:addClass(args.groupclass or args['classe-grupo'])
:cssText(args.basestyle or args['estilo-base'])
:css('width', args.groupwidth or args['largura-grupo'] or '1%') -- If groupwidth not specified, minimize width
groupCell
:cssText(args.groupstyle or args['estilo-grupo'])
:cssText(args['group' .. listnum .. 'style'] or args['estilo-grupo' .. listnum])
:wikitext(args['group' .. listnum] or args['grupo' .. listnum])
end
local listCell = row:tag('td')
if args['group' .. listnum] or args['grupo' .. listnum] then
listCell
:css('text-align', 'left')
:css('border-left-width', '2px')
:css('border-left-style', 'solid')
else
listCell:attr('colspan', 2)
end
if not args.groupwidth and not args['largura-grupo'] then
listCell:css('width', '100%')
end
local rowstyle -- usually nil so cssText(rowstyle) usually adds nothing
if index % 2 == 1 then
rowstyle = args.oddstyle or args['estilo-ímpares']
else
rowstyle = args.evenstyle or args['estilo-pares']
end
local listText = args['list' .. listnum] or args['lista' .. listnum]
local oddEven = ODD_EVEN_MARKER
if listText:sub(1, 12) == '</div><table' then
-- Assume list text is for a subgroup navbox so no automatic striping for this row.
oddEven = listText:find('<th[^>]*"navbox%-title"') and RESTART_MARKER or 'odd'
end
listCell
:css('padding', '0px')
:cssText(args.liststyle or args['estilo-lista'])
:cssText(rowstyle)
:cssText(args['list' .. listnum .. 'style'] or args['estilo-lista' .. listnum])
:addClass('navbox-list')
:addClass('navbox-' .. oddEven)
:addClass(args.listclass or args['classe-lista'])
:addClass(args['list' .. listnum .. 'class'] or args['classe-lista' .. listnum])
:tag('div')
:css('padding', (index == 1 and args.list1padding) or (index == 1 and args['padding-lista1']) or args.listpadding or args['padding-lista'] or '0em 0.25em')
:wikitext(processItem(listText, args.nowrapitems or args['nowrap-itens']))
if index == 1 and args.image or index == 1 and args.imagem then
row
:tag('td')
:addClass('navbox-image')
:addClass(args.imageclass or args['classe-imagem'])
:css('width', '1px') -- Minimize width
:css('padding', '0px 0px 0px 2px')
:cssText(args.imagestyle or args['estilo-imagem'])
:attr('rowspan', #listnums)
:tag('div')
:wikitext(processItem(args.image or args.imagem))
end
end
--
-- Tracking categories
--
local function needsHorizontalLists()
if border == 'subgroup' or border == 'subgrupo' or args.tracking == 'no' or args.tracking == 'não' or args['monitoramento'] == 'no' or args['monitoramento'] == 'não' then
return false
end
local listClasses = {
['plainlist'] = true, ['hlist'] = true, ['hlist hnum'] = true,
['hlist hwrap'] = true, ['hlist vcard'] = true, ['vcard hlist'] = true,
['hlist vevent'] = true,
}
return not (listClasses[args.listclass] or listClasses[args['classe-lista']] or listClasses[args.bodyclass] or listClasses[args['classe-corpo']] or listClasses[args.class] or listClasses[args.classe])
end
local function hasBackgroundColors()
for _, key in ipairs({'titlestyle', 'estilo-título', 'groupstyle', 'estilo-grupo', 'basestyle', 'estilo-base', 'abovestyle', 'estilo-acima', 'belowstyle', 'estilo-abaixo'}) do
if tostring(args[key]):find('background', 1, true) then
return true
end
end
end
local function hasBorders()
for _, key in ipairs({'groupstyle', 'estilo-grupo', 'basestyle', 'estilo-base', 'abovestyle', 'estilo-acima', 'belowstyle', 'estilo-abaixo'}) do
if tostring(args[key]):find('border', 1, true) then
return true
end
end
end
local function isIllegible()
local styleratio = require('Módulo:Color contrast')._styleratio
for key, style in pairs(args) do
if tostring(key):match("style$") or tostring(key):match("^estilo") then
if styleratio{mw.text.unstripNoWiki(style)} < 4.5 then
return true
end
end
end
return false
end
local function getTrackingCategories()
local cats = {}
if needsHorizontalLists() then table.insert(cats, '!Navecaixas sem listas horizontais') end
if hasBackgroundColors() then table.insert(cats, '!Navecaixas usando cores de fundo') end
if isIllegible() then table.insert(cats, '!Navecaixas potencialmente ilegíveis') end
if hasBorders() then table.insert(cats, '!Navecaixas usando bordas') end
return cats
end
local function renderTrackingCategories(builder)
local title = mw.title.getCurrentTitle()
if title.namespace ~= 10 then return end -- not in template space
local subpage = title.subpageText
if subpage == 'doc' or subpage == 'Testes' or subpage == 'Exemplos para testes' then return end
for _, cat in ipairs(getTrackingCategories()) do
builder:wikitext('[[Categoria:' .. cat .. ']]')
end
end
--
-- Main navbox tables
--
local function renderMainTable()
local argsTitle = args.title or args['título']
local argsState = args.state or args.estado
local tbl = mw.html.create('table')
:addClass('nowraplinks')
:addClass(args.bodyclass or args['classe-corpo'] or args['class'] or args['classe'])
if argsTitle and (argsState ~= 'plain' and argsState ~= 'simples' and argsState ~= 'off' and argsState ~= 'desligada' and argsState ~= 'desligado' and argsState ~= 'desligar') then
tbl
:addClass('collapsible')
:addClass(argsState or 'autocollapse')
end
tbl:css('border-spacing', 0)
if border == 'subgroup' or border == 'subgrupo' or border == 'none' or border == 'nenhuma' then
tbl
:addClass('navbox-subgroup')
:cssText(args.bodystyle or args['estilo-corpo'])
:cssText(args.style or args.estilo)
else -- regular navbox - bodystyle and style will be applied to the wrapper table
tbl
:addClass('navbox-inner')
:css('background', 'transparent')
:css('color', 'inherit')
end
tbl:cssText(args.innerstyle or args['estilo-interno'])
renderTitleRow(tbl)
renderAboveRow(tbl)
for i, listnum in ipairs(listnums) do
renderListRow(tbl, i, listnum)
end
renderBelowRow(tbl)
return tbl
end
function p._navbox(navboxArgs)
args = navboxArgs
listnums = {}
for k, _ in pairs(args) do
if type(k) == 'string' then
local listnum = k:match('^list(%d+)$') or k:match('^lista(%d+)$')
if listnum then table.insert(listnums, tonumber(listnum)) end
end
end
table.sort(listnums)
local argsGroup1 = args.group1 or args.grupo1
local argsGroup2 = args.group2 or args.grupo2
border = mw.text.trim(args.border or args.borda or args[1] or '')
if border == 'child' or border == 'filho' or border == 'filha' then
border = 'subgroup'
end
-- render the main body of the navbox
local tbl = renderMainTable()
-- render the appropriate wrapper around the navbox, depending on the border param
local res = mw.html.create()
if border == 'none' or border == 'nenhuma' then
local nav = res:tag('div')
:attr('role', 'navigation')
:node(tbl)
-- aria-labelledby title, otherwise above, otherwise lone group
if args.title or args['título'] or args.above or args.acima or (argsGroup1 and not argsGroup2) then
nav:attr('aria-labelledby', mw.uri.anchorEncode(args.title or args['título'] or args.above or args.acima or args.group1 or args.grupo1))
else
nav:attr('aria-label', 'Navbox')
end
elseif border == 'subgroup' or border == 'subgrupo' then
-- We assume that this navbox is being rendered in a list cell of a parent navbox, and is
-- therefore inside a div with padding:0em 0.25em. We start with a </div> to avoid the
-- padding being applied, and at the end add a <div> to balance out the parent's </div>
res
:wikitext('</div>')
:node(tbl)
:wikitext('<div>')
else
local nav = res:tag('div')
:attr('role', 'navigation')
:addClass('navbox')
:addClass(args.navboxclass or args['classe-navbox'])
:cssText(args.bodystyle or args['estilo-corpo'])
:cssText(args.style or args.estilo)
:css('padding', '3px')
:node(tbl)
-- aria-labelledby title, otherwise above, otherwise lone group
if args.title or args['título'] or args.above or args.acima or (argsGroup1 and not argsGroup2) then
nav:attr('aria-labelledby', mw.uri.anchorEncode(args.title or args['título'] or args.above or args.acima or args.group1 or args.grupo1))
else
nav:attr('aria-label', 'Navbox')
end
end
if args.nocat then
if args.nocat:lower() == 'false' or args.nocat:lower() == 'falso' or args.nocat:lower() == 'falsa' then
renderTrackingCategories(res)
end
elseif args.semcat then
if args.semcat:lower() == 'false' or args.semcat:lower() == 'falso' or args.semcat:lower() == 'falsa' then
renderTrackingCategories(res)
end
end
return striped(tostring(res))
end
function p.navbox(frame)
if not getArgs then
getArgs = require('Módulo:Arguments').getArgs
end
args = getArgs(frame, {wrappers = {'Predefinição:Navbox', 'Predefinição:Navbox/lua', 'Predefinição:Navbox subgroup'}})
if frame.args.border then
-- This allows Template:Navbox_subgroup to use {{#invoke:Navbox|navbox|border=...}}.
args.border = frame.args.border or frame.args.borda
end
-- Read the arguments in the order they'll be output in, to make references number in the right order.
local _
_ = args.title or args['título']
_ = args.above or args.acima
for i = 1, 20 do
_ = args["group" .. tostring(i)] or args["grupo" .. tostring(i)]
_ = args["list" .. tostring(i)] or args["lista" .. tostring(i)]
end
_ = args.below or args.abaixo
return p._navbox(args)
end
return p