Jump to content

Module:Navbox: Difference between revisions

From Joepedia
Created page with "-- version 1.1.3 -- config table for RANGER. -- If you want to change the default config, DO NOT change it here, -- please do it via the `onLoadConfig` hook in Module:Navbox/Hooks. local config = { default_navbox_class = "navigation-not-searchable", -- Base value of the `class` parameter. default_title_class = nil, -- Base value of the `title_class` parameter. default_above_class = nil, -- Base value of the `above_class` parameter. default_below_class =..."
 
No edit summary
 
Line 1: Line 1:
-- version 1.1.3
--
-- This module implements {{Navbox}}
--


-- config table for RANGER.
local p = {}
-- If you want to change the default config, DO NOT change it here,
-- please do it via the `onLoadConfig` hook in [[Module:Navbox/Hooks]].
local config = {
default_navbox_class = "navigation-not-searchable",  -- Base value of the `class` parameter.
default_title_class = nil,    -- Base value of the `title_class` parameter.
default_above_class = nil,    -- Base value of the `above_class` parameter.
default_below_class = nil,    -- Base value of the `below_class` parameter.
default_section_class =nil,  -- Base value of the `section_class` parameter.
default_header_class = nil,  -- Base value of the `header_class` parameter.
default_group_class = nil,    -- Base value of the `group_class` parameter.
default_list_class = 'hlist', -- Base value of the `list_class` parameter.
default_header_state = nil, -- Base value of the `state` parameter.


editlink_hover_message_key = 'Navbox-edit-hover', -- The system message name for hover text of the edit icon.
local navbar = require('Module:Navbar')._navbar
local getArgs -- lazily initialized
auto_flatten_top_level = true, -- If true, when a section has only one list with no content and no corresponding group but has sublists, these sublists will be moved to top level.
-- This helps make the hierarchy of sections and content clearer.
-- An example:
-- {{navbox
-- ...
--  |header-1 = Items
--  | group-1.1 = Weapons
--  |  list-1.1 = Swords · Guns · Wands
--  | group-1.2 = Armors
--  |  list-1.2 = Head pieces · Capes
--  |header-2 = NPCs
--  | group-2.1 = Town NPCs
--   |  list-2.1 = Guide · Witch
-- ...
-- }}
-- will be equal to:
-- {{navbox
-- ...
--  |header-1 = Items
--  | group-2 = Weapons
--  |  list-2 = Swords · Guns · Wands
--  | group-3 = Armors
--  |  list-3 = Head pieces · Capes
--  |header-5 = NPCs
--  | group-6 = Town NPCs
--  |  list-6 = Guide · Witch
-- ...
-- }}
custom_render_handle = nil, -- usually for debugging purposes only. if set, it should be a function accept 2 parameters: `dataTree` and `args`, and return a string as module output.
}


---------------------------------------------------------------------
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'


-- Argument alias.
local function striped(wikitext)
local CANONICAL_NAMES = {
-- Return wikitext with markers replaced for odd/even striping.
['titlestyle'] = 'title_style',
-- Child (subgroup) navboxes are flagged with a category that is removed
['listclass'] = 'list_class',
-- by parent navboxes. The result is that the category shows all pages
['groupstyle'] = 'group_style',
-- where a child navbox is not contained in a parent navbox.
['collapsible'] = 'state',
local orphanCat = '[[Category:Navbox orphans]]'
['editlink'] = 'meta',
if border == 'subgroup' and args.orphan ~= 'yes' then
['editlinks'] = 'meta',
-- No change; striping occurs in outermost navbox.
['editicon'] = 'meta',
return wikitext .. orphanCat
['edit_link'] = 'meta',
end
['edit_links'] = 'meta',
local first, second = 'odd', 'even'
['edit_icon'] = 'meta',
if args.evenodd then
['navbar'] = 'meta',
if args.evenodd == 'swap' then
['evenodd'] = 'striped',
first, second = second, first
['class'] = 'navbox_class',
else
['css'] = 'navbox_style',
first = args.evenodd
['style'] = 'navbox_style',
second = first
['group'] = '1:group',
end
['list'] = '1:list',
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 STATES = {
local function processItem(item, nowrapitems)
['no'] = '',
if item:sub(1, 2) == '{|' then
['off'] = '',
-- Applying nowrap to lines in a table does not make sense.
['plain'] = '',
-- Add newlines to compensate for trim of x in |parm=x in a template.
['collapsed'] = 'mw-collapsible mw-collapsed',
return '\n' .. item ..'\n'
}
end
if nowrapitems == 'yes' 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 BOOL_FALSE = {
-- Separate function so that we can evaluate properly whether hlist should
['no'] = true,
-- be added by the module
['off'] = true,
local function has_navbar()
['false'] = true,
return args.navbar ~= 'off' and args.navbar ~= 'plain' and not
}
(not args.name and mw.getCurrentFrame():getParent():getTitle():gsub('/sandbox$', '') == 'Template:Navbox')
end


local STRIPED = {
local function renderNavBar(titleCell)
['odd'] = 'striped-odd',
['swap'] = 'striped-odd',
['y'] = 'striped-even',
['yes'] = 'striped-even',
['on'] = 'striped-even',
['even'] = 'striped-even',
['striped'] = 'striped-even',
}


local DEFAULT_ARGS = {
if has_navbar() then
['meta'] = true,
titleCell:wikitext(navbar{
}
args.name,
-- we depend on this being mini = 1 when the navbox module decides
-- to add hlist templatestyles. we also depend on navbar outputting
-- a copy of the hlist templatestyles.
mini = 1,
fontstyle = (args.basestyle or '') .. ';' .. (args.titlestyle or '') .. ';background:none transparent;border:none;box-shadow:none; padding:0;'
})
end


local NAVBOX_CHILD_INDICATOR = '!!C$H$I$L$D!!'
end
local NAVBOX_CHILD_INDICATOR_LENGTH = string.len( NAVBOX_CHILD_INDICATOR )


local CLASS_PREFIX = 'ranger-'
--
--  Title row
--
local function renderTitleRow(tbl)
if not args.title then return end


---------------------------------------------------------------------
local titleRow = tbl:tag('tr')


local p = {}
if args.titlegroup then
local h = {} -- non-public
titleRow
local hooks = mw.title.new('Module:Navbox/Hooks').exists and require('Module:Navbox/Hooks') or {}
:tag('th')
:attr('scope', 'row')
:addClass('navbox-group')
:addClass(args.titlegroupclass)
:cssText(args.basestyle)
:cssText(args.groupstyle)
:cssText(args.titlegroupstyle)
:wikitext(args.titlegroup)
end


---------------------------------------------------------------------
local titleCell = titleRow:tag('th'):attr('scope', 'col')


-- For templates: {{#invoke:navbox|main|...}}
if args.titlegroup then
function p.main(frame)
titleCell
local args = p.mergeArgs(frame)
:addClass('navbox-title1')
args = h.parseArgs(args)
end
return p.build(args)
 
end
local titleColspan = 2
if args.imageleft then titleColspan = titleColspan + 1 end
if args.image then titleColspan = titleColspan + 1 end
if args.titlegroup then titleColspan = titleColspan - 1 end


-- For modules: return require('module:navbox').build(args)
titleCell
-- By default this method will skip the arguments sanitizing phase
:cssText(args.basestyle)
-- (and onSanitizeArgsStart/onSanitizeArgsEnd hooks).
:cssText(args.titlestyle)
-- Set `doParseArgs` to true to do arguments sanitizing.
:addClass('navbox-title')
-- If `customConfig` table is provided, it will be merged into default config table.
:attr('colspan', titleColspan)
-- If `customHooks` table is provided, all default hook handles will be overrided, unprovided hooks will be empty.
function p.build(args, doParseArgs, customConfig, customHooks)
if customHooks then
hooks = customHooks
end
if customConfig then
for k,v in pairs(customConfig) do
config[k] = v
end
end
if doParseArgs then
args = h.parseArgs(args)
end


h.runHook('onLoadConfig', config, args)
renderNavBar(titleCell)
--merge default args
for k,v in pairs(DEFAULT_ARGS) do
if args[k] == nil then
args[k] = DEFAULT_ARGS[k]
end
end


h.runHook('onBuildTreeStart', args)
titleCell
local dataTree = h.buildDataTree(args)
:tag('div')
h.runHook('onBuildTreeEnd', dataTree, args)
-- id for aria-labelledby attribute
:attr('id', mw.uri.anchorEncode(args.title))
if type(config.custom_render_handle) == 'function' then
:addClass(args.titleclass)
return config.custom_render_handle(dataTree, args)
:css('font-size', '114%')
else
:css('margin', '0 4em')
return h.render(dataTree)
:wikitext(processItem(args.title))
end
end
end


-- merge args from frame and frame:getParent()
-- It may be used when creating custom wrapping navbox module.
--
--
-- For example, Module:PillNavbox
--   Above/Below rows
--
--
-- local RANGER = require('Module:Navbox')
 
-- local p = {}
local function getAboveBelowColspan()
-- function p.main(frame)
local ret = 2
--    return RANGER.build(RANGER.mergeArgs(frame), true, {
if args.imageleft then ret = ret + 1 end
--        default_navbox_class = 'pill', -- use "pill" style by default.
if args.image then ret = ret + 1 end
--    })
return ret
-- end
-- return p
--
function p.mergeArgs(frame)
local inputArgs = {}
for k, v in pairs(frame.args) do
v = mw.text.trim(tostring(v))
if v ~= '' then
inputArgs[k] = v
end
end
for k, v in pairs(frame:getParent().args) do
v = mw.text.trim(v)
if v ~= '' then
inputArgs[k] = v
end
end
return inputArgs
end
end


------------------------------------------------------------------------
local function renderAboveRow(tbl)
if not args.above then return end


function h.parseArgs(inputArgs)
tbl:tag('tr')
:tag('td')
h.runHook('onSanitizeArgsStart', inputArgs)
:addClass('navbox-abovebelow')
:addClass(args.aboveclass)
local args = {}
:cssText(args.basestyle)
:cssText(args.abovestyle)
for k, v in pairs(inputArgs) do
:attr('colspan', getAboveBelowColspan())
-- all args have already been trimmed
:tag('div')
if type(k) == 'string' then
-- id for aria-labelledby attribute, if no title
local key = h.normalizeKey(k)
:attr('id', args.title and nil or mw.uri.anchorEncode(args.above))
args[key] = h.normalizeValue(key, v)
:wikitext(processItem(args.above, args.nowrapitems))
else
args[k] = mw.text.trim(v) -- keep number-index arguments (for {{navbox|child|...}})
end
end
h.runHook('onSanitizeArgsEnd', args, inputArgs)
return args
end
end


-- Normalize the name string of arguments.
local function renderBelowRow(tbl)
-- the normalized form is (index:)?name, in which:
if not args.below then return end
-- index is number index such as 1, 1.3, 1.2.45,
-- name is in lowercase underscore-case, such as group, group_style
-- e.g: header_state, 1.3:list_style
-- the input argument name can be:
-- * camel-case: listStyle, ListStyle
-- * space separated: list style
-- * prefix+index+postfix?, and can be in camel-case or space/hyphen separated or mixed: list 1 style, list1, list1Style, list1_style
-- * index.name: 1.3.list
-- * index_name: 1.3_list (Space separated are treated as underscore separated, therefore 1.3 list are vaild too)
function h.normalizeKey(s)
-- camel-case to lowercase underscore-case
s = s:gsub('%l%f[%u]', '%0_') -- listStyle to list_style
s = (s:gsub(' ', '_')):lower() -- space to underscore
s = s:gsub('%l%f[%d]', '%0_') -- group1* to group_1*
s = s:gsub('%d%f[%l]', '%0_') -- *1style to *1_style
-- number format x_y_z to x.y.z
s = s:gsub('(%d)_%f[%d]', '%1%.')
-- move index to the beginning:
-- group_1.2_style to 1.2:group_style
-- group_1 to 1:group
s = s:gsub('^([%l_]+)_([%d%.]+)', '%2:%1')
-- support index.name and index_name:
-- 1.2.group / 1.2_group to 1.2:group
s = s:gsub('^([%d%.]+)[%._]%f[%l]', '%1:')
-- now the key should be in normalized form, if the origin key is vaild


-- standardize *_css to *_style
tbl:tag('tr')
s = s:gsub('_css$', '_style')
:tag('td')
-- standardize *collapsible to *state
:addClass('navbox-abovebelow')
s = s:gsub('collapsible$', 'state')
:addClass(args.belowclass)
:cssText(args.basestyle)
:cssText(args.belowstyle)
:attr('colspan', getAboveBelowColspan())
:tag('div')
:wikitext(processItem(args.below, args.nowrapitems))
end


--
-- standardize all aliases to the canonical name
--  List rows
return CANONICAL_NAMES[s] or s
--
end
local function renderListRow(tbl, index, listnum)
local row = tbl:tag('tr')


function h.normalizeValue(k, v)
if index == 1 and args.imageleft then
k = tostring(k)
row
if k:find('_style$') then
:tag('td')
v = (v .. ';'):gsub(';;', ';')
:addClass('navbox-image')
return v
:addClass(args.imageclass)
elseif k == 'striped' then
:css('width', '1px')               -- Minimize width
return STRIPED[v]
:css('padding', '0px 2px 0px 0px')
elseif v:sub(1, 2) == '{|' or v:match('^[*:;#]') then
:cssText(args.imageleftstyle)
-- Applying nowrap to lines in a table does not make sense.
:attr('rowspan', #listnums)
-- Add newlines to compensate for trim of x in |parm=x in a template.
:tag('div')
return '\n' .. v ..'\n'
:wikitext(processItem(args.imageleft))
elseif k == 'meta' then
return not BOOL_FALSE[v]
end
end
return v
end


-- we need a default value for all empty state_* arguments, so we can not do this in h.normalizeValue()
if args['group' .. listnum] then
function h.normalizeStateValue(v)
local groupCell = row:tag('th')
return STATES[v] or 'mw-collapsible'
end


-- parse arguments, convert them to structured data tree
-- id for aria-labelledby attribute, if lone group with no title or above
function h.buildDataTree(args)
if listnum == 1 and not (args.title or args.above or args.group2) then
local data = {
groupCell
state = h.normalizeStateValue(args.state),
:attr('id', mw.uri.anchorEncode(args.group1))
striped = args.striped,
class = h.mergeAttrs(args.navbox_class, config.default_navbox_class),
style = args.navbox_style,
}
if args.title or args.meta or data.state ~= '' then
data.title = {
content = args.title,
class = h.mergeAttrs(args.title_class, config.default_title_class),
style = args.title_style,
}
if args.meta then
data.metaLinks = {
template = args.name or mw.getCurrentFrame():getParent():getTitle()
}
end
end
groupCell
:attr('scope', 'row')
:addClass('navbox-group')
:addClass(args.groupclass)
:cssText(args.basestyle)
:css('width', args.groupwidth or '1%') -- If groupwidth not specified, minimize width
groupCell
:cssText(args.groupstyle)
:cssText(args['group' .. listnum .. 'style'])
:wikitext(args['group' .. listnum])
end
end
 
if args.above then
local listCell = row:tag('td')
data.above = {
 
content = args.above,
if args['group' .. listnum] then
class= h.mergeAttrs(args.above_class, config.default_above_class),
listCell
style = args.above_style,
:addClass('navbox-list1')
}
else
listCell:attr('colspan', 2)
end
end


if args.below then
if not args.groupwidth then
data.below = {
listCell:css('width', '100%')
content = args.below,
class= h.mergeAttrs(args.below_class, config.default_below_class),
style = args.below_style,
}
end
end
 
local tree = h.buildTree(args, {
local rowstyle  -- usually nil so cssText(rowstyle) usually adds nothing
listClass = h.mergeAttrs(args.list_class, config.default_list_class),
if index % 2 == 1 then
listStyle = args.list_style,
rowstyle = args.oddstyle
groupClass = h.mergeAttrs(args.group_class, config.default_group_class),
else
groupStyle = args.group_style,
rowstyle = args.evenstyle
headerClass = h.mergeAttrs(args.header_class, config.default_header_class),
headerStyle = args.header_style,
})
-- handle {{navbox|child|...}} syntax:
if args[1] == 'child' then
return NAVBOX_CHILD_INDICATOR..mw.text.jsonEncode(tree)
end
end
 
-- normal case
local listText = args['list' .. listnum]
local sectionClass = h.mergeAttrs(args.section_class, config.default_section_class)
local oddEven = ODD_EVEN_MARKER
local sectionStyle = args.section_style
if listText:sub(1, 12) == '</div><table' then
local headerState = args.header_state or config.default_header_state
-- Assume list text is for a subgroup navbox so no automatic striping for this row.
data.sections = {}
oddEven = listText:find('<th[^>]*"navbox%-title"') and RESTART_MARKER or 'odd'
local section
for k, v in h.orderedPairs(tree or {}) do
if v.header or not section then
--start a new section
section = {
class = h.mergeAttrs(args[k..':section_class'], sectionClass),
style = h.mergeAttrs(args[k..':section_style'], sectionStyle),
body = {},
}
-- Section header if needed.
-- If the value of a `|header_n=` is two or more consecutive "-" characters (e.g. --, -----),
-- it means start a new section without header, and the new section will be not collapsable.
if v.header and not string.match(v.header.content, '^%-%-+$') then
section.header =v.header
section.state = h.normalizeStateValue(args[k..':state'] or headerState)
end
v.header = nil
data.sections[#data.sections+1] = section
end
-- check for section above/below areas
if v.above then
section.above = v.above
v.above = nil
end
if v.below then
section.below = v.below
v.below = nil
end
if next(v) then -- v is not empty (with group/list/sub)
section.body[#section.body+1] = v
end
end
end
listCell
if config.auto_flatten_top_level then
:css('padding', '0px')
for _, sect in ipairs(data.sections) do
:cssText(args.liststyle)
if #sect.body == 1 then
:cssText(rowstyle)
local node = sect.body[1]
:cssText(args['list' .. listnum .. 'style'])
if not node.group and not node.list and node.sub then
:addClass('navbox-list')
sect.body = node.sub
:addClass('navbox-' .. oddEven)
end
:addClass(args.listclass)
end
:addClass(args['list' .. listnum .. 'class'])
end
:tag('div')
:css('padding', (index == 1 and args.list1padding) or args.listpadding or '0em 0.25em')
:wikitext(processItem(listText, args.nowrapitems))
 
if index == 1 and args.image then
row
:tag('td')
:addClass('navbox-image')
:addClass(args.imageclass)
:css('width', '1px')              -- Minimize width
:css('padding', '0px 0px 0px 2px')
:cssText(args.imagestyle)
:attr('rowspan', #listnums)
:tag('div')
:wikitext(processItem(args.image))
end
end
return data
end
end


function h.buildTree(args, defaults)
local tree = {}
local check = function(key, value)
local index, name = string.match(key, '^([%d%.]+):(.+)$')


if not index then return end -- no number index found
--
if name ~= 'list' and name ~= 'group' and name ~= 'header' and name ~= 'above' and name ~= 'below' then return end -- check only the names we are interested in
--  Tracking categories
if string.match(index, '^%.') or string.match(index, '%.$') or string.match(index, '%.%.') then return end -- invalid number index
--
 
local function needsHorizontalLists()
if border == 'subgroup' or args.tracking == 'no' 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.bodyclass])
end
 
-- there are a lot of list classes in the wild, so we have a function to find
-- them and add their TemplateStyles
local function addListStyles()
local frame = mw.getCurrentFrame()
-- TODO?: Should maybe take a table of classes for e.g. hnum, hwrap as above
-- I'm going to do the stupid thing first though
-- Also not sure hnum and hwrap are going to live in the same TemplateStyles
-- as hlist
local function _addListStyles(htmlclass, templatestyles)
local class_args = { -- rough order of probability of use
'bodyclass', 'listclass', 'aboveclass', 'belowclass', 'titleclass',
'navboxclass', 'groupclass', 'titlegroupclass', 'imageclass'
}
local patterns = {
'^' .. htmlclass .. '$',
'%s' .. htmlclass .. '$',
'^' .. htmlclass .. '%s',
'%s' .. htmlclass .. '%s'
}
-- find the node that matches the index in the tree
local found = false
local arr = mw.text.split(index, '.', true)
for _, arg in ipairs(class_args) do
n = tonumber(table.remove(arr))
for _, pattern in ipairs(patterns) do
local node = tree
if mw.ustring.find(args[arg] or '', pattern) then
for _, v in ipairs(arr) do
found = true
v = tonumber(v)
break
if not node[v] then  
end
node[v] = {['sub'] = {}}
elseif not node[v]['sub'] then
node[v]['sub'] = {}
end
end
node = node[v]['sub']
if found then break end
end
end
if not node[n] then node[n] = {} end
if found then
return frame:extensionTag{
if name == 'list' and string.sub(value, 1, NAVBOX_CHILD_INDICATOR_LENGTH) == NAVBOX_CHILD_INDICATOR then
name = 'templatestyles', args = { src = templatestyles }
-- it is from {{navbox|child| ... }}
}
node[n]['sub'] = mw.text.jsonDecode(string.sub(value, NAVBOX_CHILD_INDICATOR_LENGTH+1))
else
else
node[n][name] = {
return ''
content = value,
class= h.mergeAttrs(args[key..'_class'], defaults[name..'Class']),
style = h.mergeAttrs(args[key..'_style'], defaults[name..'Style'])
}
end
end
end
end
for k,v in pairs(args) do
check(k, v)
local hlist_styles = ''
-- navbar always has mini = 1, so here (on this wiki) we can assume that
-- we don't need to output hlist styles in navbox again.
if not has_navbar() then
hlist_styles = _addListStyles('hlist', 'Flatlist/styles.css')
end
end
return tree
local plainlist_styles = _addListStyles('plainlist', 'Plainlist/styles.css')
return hlist_styles .. plainlist_styles
end
end


function h.render(data)
local function hasBackgroundColors()
-- handle {{navbox|child|...}} syntax
for _, key in ipairs({'titlestyle', 'groupstyle', 'basestyle', 'abovestyle', 'belowstyle'}) do
if type(data) == 'string' then
if tostring(args[key]):find('background', 1, true) then
return data
return true
end
end
end
end


-----  normal case -----
local function hasBorders()
for _, key in ipairs({'groupstyle', 'basestyle', 'abovestyle', 'belowstyle'}) do
local out = mw.html.create()
if tostring(args[key]):find('border', 1, true) then
return true
-- build navbox container
local navbox = out:tag('div')
:attr('role', 'navigation'):attr('aria-label', 'Navbox')
:addClass(CLASS_PREFIX..'navbox')
:addClass(data.class)
:addClass(data.striped)
:addClass(data.state)
:cssText(data.style)
 
--title bar
if data.title then
local titlebar = navbox:tag('div'):addClass(CLASS_PREFIX..'title')
titlebar:tag('div'):addClass('mw-collapsible-toggle-placeholder')
if data.metaLinks then
titlebar:node(h.renderMetaLinks(data.metaLinks))
end
if data.title then
titlebar:addClass(data.title.class):tag('div')
:addClass(CLASS_PREFIX..'title-text')
:addClass(data.title.class)
:cssText(data.title.style)
:wikitext(data.title.content)
end
end
end
end
end
local function isIllegible()
-- require('Module:Color contrast') absent on mediawiki.org
return false
end
local function getTrackingCategories()
local cats = {}
if needsHorizontalLists() then table.insert(cats, 'Navigational boxes without horizontal lists') end
if hasBackgroundColors() then table.insert(cats, 'Navboxes using background colours') end
if isIllegible() then table.insert(cats, 'Potentially illegible navboxes') end
if hasBorders() then table.insert(cats, 'Navboxes using borders') end
return cats
end


--above
local function renderTrackingCategories(builder)
if data.above then
local title = mw.title.getCurrentTitle()
navbox:tag('div')
if title.namespace ~= 10 then return end -- not in template space
:addClass(CLASS_PREFIX..'above mw-collapsible-content')
local subpage = title.subpageText
:addClass(data.above.class)
if subpage == 'doc' or subpage == 'sandbox' or subpage == 'testcases' then return end
:cssText(data.above.style)
 
:wikitext(data.above.content)
for _, cat in ipairs(getTrackingCategories()) do
:attr('id', (not data.title) and mw.uri.anchorEncode(data.above.content) or nil) -- id for aria-labelledby attribute, if no title
builder:wikitext('[[Category:' .. cat .. ']]')
end
end
end
-- sections
 
for i,sect in ipairs(data.sections) do
--
--section box
--   Main navbox tables
local section = navbox:tag('div')
--
:addClass(CLASS_PREFIX..'section mw-collapsible-content')
local function renderMainTable()
:addClass(sect.class)
local tbl = mw.html.create('table')
:addClass(sect.state)
:addClass('nowraplinks')
:cssText(sect.style)
:addClass(args.bodyclass)
-- section header
 
if sect.header then
if args.title and (args.state ~= 'plain' and args.state ~= 'off') then
section:tag('div')
if args.state == 'collapsed' then args.state = 'mw-collapsed' end
:addClass(CLASS_PREFIX..'header')
tbl
:addClass(sect.header.class)
:addClass('mw-collapsible')
:cssText(sect.header.style)
:addClass(args.state or 'autocollapse')
:tag('div'):addClass('mw-collapsible-toggle-placeholder'):done()
:tag('div'):addClass(CLASS_PREFIX..'header-text'):wikitext(sect.header.content)
end
-- above:
if sect.above then
section:tag('div')
:addClass(CLASS_PREFIX..'above mw-collapsible-content')
:addClass(sect.above.class)
:cssText(sect.above.style)
:wikitext(sect.above.content)
end
-- body: groups&lists
local box = section:tag('div'):addClass(CLASS_PREFIX..'section-body mw-collapsible-content')
h.renderBody(sect.body, box, 0, true) -- reset even status each section
-- below:
if sect.below then
section:tag('div')
:addClass(CLASS_PREFIX..'below mw-collapsible-content')
:addClass(sect.below.class)
:cssText(sect.below.style)
:wikitext(sect.below.content)
end
end
end
-- Insert a blank section for completely empty navbox to ensure it behaves correctly when collapsed.
 
if #data.sections == 0 and not data.above and not data.below then  
tbl:css('border-spacing', 0)
navbox:tag('div'):addClass(CLASS_PREFIX..'section mw-collapsible-content')
if border == 'subgroup' or border == 'none' then
tbl
:addClass('navbox-subgroup')
:cssText(args.bodystyle)
:cssText(args.style)
else  -- regular navbox - bodystyle and style will be applied to the wrapper table
tbl
:addClass('navbox-inner')
:css('background', 'transparent')
:css('color', 'inherit')
end
end
tbl:cssText(args.innerstyle)


--below
renderTitleRow(tbl)
if data.below then
renderAboveRow(tbl)
navbox:tag('div')
for i, listnum in ipairs(listnums) do
:addClass(CLASS_PREFIX..'below mw-collapsible-content')
renderListRow(tbl, i, listnum)
:addClass(data.below.class)
:cssText(data.below.style)
:wikitext(data.below.content)
end
end
renderBelowRow(tbl)


return out
return tbl
end
end


function h.renderMetaLinks(info)
function p._navbox(navboxArgs)
local title = mw.title.new(mw.text.trim(info.template), 'Template')
args = navboxArgs
if not title then
listnums = {}
error('Invalid title ' .. info.template)
 
for k, _ in pairs(args) do
if type(k) == 'string' then
local listnum = k:match('^list(%d+)$')
if listnum then table.insert(listnums, tonumber(listnum)) end
end
end
table.sort(listnums)
 
border = mw.text.trim(args.border or args[1] or '')
if border == 'child' then
border = 'subgroup'
end
end
-- render the main body of the navbox
local tbl = renderMainTable()
local msg = mw.message.new(config.editlink_hover_message_key)
-- get templatestyles
local hoverText = msg:exists() and msg:plain() or 'View or edit this template'
local frame = mw.getCurrentFrame()
local base_templatestyles = frame:extensionTag{
name = 'templatestyles', args = { src = 'Module:Navbox/styles.css' }
}
local templatestyles = ''
if args.templatestyles and args.templatestyles ~= '' then
templatestyles = frame:extensionTag{
name = 'templatestyles', args = { src = args.templatestyles }
}
end
return mw.html.create('span'):addClass(CLASS_PREFIX..'meta')
local res = mw.html.create()
:tag('span'):addClass('nv nv-view')
-- 'navbox-styles' exists for two reasons:
:wikitext('[['..title.fullText..'|')
--  1. To wrap the styles to work around phab: T200206 more elegantly. Instead
:tag('span'):wikitext(hoverText):attr('title', hoverText):done()
--   of combinatorial rules, this ends up being linear number of CSS rules.
:wikitext(']]')
--  2. To allow MobileFrontend to rip the styles out with 'nomobile' such that
--    they are not dumped into the mobile view.
res:tag('div')
:addClass('navbox-styles')
:addClass('nomobile')
:wikitext(base_templatestyles .. templatestyles)
:done()
:done()
end
 
-- render the appropriate wrapper around the navbox, depending on the border param
function h.renderBody(info, box, level, even)
if border == 'none' then
local count = 0
local nav = res:tag('div')
for _,v in h.orderedPairs(info) do
:attr('role', 'navigation')
if v.group or v.list or v.sub then
:wikitext(addListStyles())
count = count + 1
:node(tbl)
-- row container
-- aria-labelledby title, otherwise above, otherwise lone group
local row = box:tag('div'):addClass(CLASS_PREFIX..'row')
if args.title or args.above or (args.group1 and not args.group2) then
-- group cell
nav:attr('aria-labelledby', mw.uri.anchorEncode(args.title or args.above or args.group1))
if v.group or (v.sub and level > 0 and not v.list) then
else
local groupCell = row:tag('div')
nav:attr('aria-label', 'Navbox')
:addClass(CLASS_PREFIX..'group level-'..level)
end
:addClass((level > 0) and CLASS_PREFIX..'subgroup' or nil)
elseif border == 'subgroup' then
local groupContentWrap = groupCell:tag('div'):addClass(CLASS_PREFIX..'wrap')
-- We assume that this navbox is being rendered in a list cell of a
if v.group then
-- parent navbox, and is therefore inside a div with padding:0em 0.25em.
groupCell:addClass(v.group.class):cssText(v.group.style)
-- We start with a </div> to avoid the padding being applied, and at the
groupContentWrap:wikitext(v.group.content)
-- end add a <div> to balance out the parent's </div>
else
res
groupCell:addClass('empty')
:wikitext('</div>')
row:addClass('empty-group-list')
:wikitext(addListStyles())
end
:node(tbl)
else
:wikitext('<div>')
row:addClass('empty-group')
else
end
local nav = res:tag('div')
-- list cell
:attr('role', 'navigation')
local listCell = row:tag('div'):addClass(CLASS_PREFIX..'listbox')
:addClass('navbox')
if not v.list and not v.sub then
:addClass(args.navboxclass)
listCell:addClass('empty')
:cssText(args.bodystyle)
row:addClass('empty-list')
:cssText(args.style)
end
:css('padding', '3px')
if v.list or (v.group and not v.sub) then
:wikitext(addListStyles())
--listCell:node(h.renderList(v['list'] or '', k, level, args))
:node(tbl)
even = not even -- flip even/odd status
-- aria-labelledby title, otherwise above, otherwise lone group
local cell = listCell:tag('div')
if args.title or args.above or (args.group1 and not args.group2) then
:addClass(CLASS_PREFIX..'wrap')
nav:attr('aria-labelledby', mw.uri.anchorEncode(args.title or args.above or args.group1))
:addClass(even and CLASS_PREFIX..'even' or CLASS_PREFIX..'odd')
else
if v.list then
nav:attr('aria-label', 'Navbox')
cell:addClass(v.list.class):cssText(v.list.style)
:tag('div'):addClass(CLASS_PREFIX..'list'):wikitext(v.list.content)
end
end
if v.sub then
local sublistBox = listCell:tag('div'):addClass(CLASS_PREFIX..'sublist level-'..level)
even = h.renderBody(v.sub, sublistBox, level+1, even)
end
end
end
end
end
if count > 0 then
 
box:css('--count', count) -- for flex-grow
if (args.nocat or 'false'):lower() == 'false' then
renderTrackingCategories(res)
end
end
return even
 
return striped(tostring(res))
end
end


-- pairs, but sort the keys alphabetically
function p.navbox(frame)
function h.orderedPairs(t, f)
if not getArgs then
local a = {}
getArgs = require('Module:Arguments').getArgs
for n in pairs(t) do table.insert(a, n) end
end
table.sort(a, f)
args = getArgs(frame, {wrappers = {'Template:Navbox', 'Template:Navbox subgroup'}})
local i = 0      -- iterator variable
if frame.args.border then
local iter = function ()  -- iterator function
-- This allows Template:Navbox_subgroup to use {{#invoke:Navbox|navbox|border=...}}.
i = i + 1
args.border = frame.args.border
if a[i] == nil then return nil
else return a[i], t[a[i]]
end
end
end
return iter
end


-- For cascading parameters, such as style or class, they are merged in exact order (from general to specific).
-- Read the arguments in the order they'll be output in, to make references number in the right order.
-- Any parameter starting with multiple hyphens(minus signs) will terminate the cascade.
local _
-- An example:
_ = args.title
-- For group_1.1, its style is affected by parameters |group_1.1_style=... , |subgroup_level_1_style=... , and |subgroup_style=... .
_ = args.above
-- If we have |group_1.1_style= color:red; |subgroup_level_1_style= font-weight: bold; and |subgroup_style= color: green; ,
for i = 1, 20 do
-- the style of group_1.1 will be style="color:green; font-weight: bold; color: red;" ;
_ = args["group" .. tostring(i)]
-- if we have |group_1.1_style= -- color:red; |subgroup_level_1_style= font-weight: bold; and |subgroup_style= color: green; ,
_ = args["list" .. tostring(i)]
-- the style of group_1.1 will be style="color: red;" only, and the cascade is no longer performed for |subgroup_level_1_style and |subgroup_style.
function h.mergeAttrs(...)
local trim = mw.text.trim
local s = ''
for i=1, select('#', ...) do
local v = trim(select(i, ...) or '')
local str = string.match(v, '^%-%-+(.*)$')
if str then
s = trim(str..' '..s)
break
else
s = trim(v..' '..s)
end
end
end
if s == '' then s = nil end
_ = args.below
return s
end


function h.runHook(key, ...)
return p._navbox(args)
if hooks[key] then
hooks[key](...)
end
end
end


-----------------------------------------------
return p
return p

Latest revision as of 23:03, 20 January 2025

Documentation for this module may be created at Module:Navbox/doc 

--
-- This module implements {{Navbox}}
--

local p = {}

local navbar = require('Module: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 = '[[Category:Navbox orphans]]'
	if border == 'subgroup' and args.orphan ~= 'yes' then
		-- No change; striping occurs in outermost navbox.
		return wikitext .. orphanCat
	end
	local first, second = 'odd', 'even'
	if args.evenodd then
		if args.evenodd == 'swap' then
			first, second = second, first
		else
			first = args.evenodd
			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' 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

-- Separate function so that we can evaluate properly whether hlist should
-- be added by the module
local function has_navbar()
	return args.navbar ~= 'off' and args.navbar ~= 'plain' and not
		(not args.name and mw.getCurrentFrame():getParent():getTitle():gsub('/sandbox$', '') == 'Template:Navbox')
end

local function renderNavBar(titleCell)

	if has_navbar() then
		titleCell:wikitext(navbar{
			args.name,
			-- we depend on this being mini = 1 when the navbox module decides
			-- to add hlist templatestyles. we also depend on navbar outputting
			-- a copy of the hlist templatestyles.
			mini = 1,
			fontstyle = (args.basestyle or '') .. ';' .. (args.titlestyle or '') .. ';background:none transparent;border:none;box-shadow:none; padding:0;'
		})
	end

end

--
--   Title row
--
local function renderTitleRow(tbl)
	if not args.title then return end

	local titleRow = tbl:tag('tr')

	if args.titlegroup then
		titleRow
			:tag('th')
				:attr('scope', 'row')
				:addClass('navbox-group')
				:addClass(args.titlegroupclass)
				:cssText(args.basestyle)
				:cssText(args.groupstyle)
				:cssText(args.titlegroupstyle)
				:wikitext(args.titlegroup)
	end

	local titleCell = titleRow:tag('th'):attr('scope', 'col')

	if args.titlegroup then
		titleCell
			:addClass('navbox-title1')
	end

	local titleColspan = 2
	if args.imageleft then titleColspan = titleColspan + 1 end
	if args.image then titleColspan = titleColspan + 1 end
	if args.titlegroup then titleColspan = titleColspan - 1 end

	titleCell
		:cssText(args.basestyle)
		:cssText(args.titlestyle)
		:addClass('navbox-title')
		:attr('colspan', titleColspan)

	renderNavBar(titleCell)

	titleCell
		:tag('div')
			-- id for aria-labelledby attribute
			:attr('id', mw.uri.anchorEncode(args.title))
			:addClass(args.titleclass)
			:css('font-size', '114%')
			:css('margin', '0 4em')
			:wikitext(processItem(args.title))
end

--
--   Above/Below rows
--

local function getAboveBelowColspan()
	local ret = 2
	if args.imageleft then ret = ret + 1 end
	if args.image then ret = ret + 1 end
	return ret
end

local function renderAboveRow(tbl)
	if not args.above then return end

	tbl:tag('tr')
		:tag('td')
			:addClass('navbox-abovebelow')
			:addClass(args.aboveclass)
			:cssText(args.basestyle)
			:cssText(args.abovestyle)
			:attr('colspan', getAboveBelowColspan())
			:tag('div')
				-- id for aria-labelledby attribute, if no title
				:attr('id', args.title and nil or mw.uri.anchorEncode(args.above))
				:wikitext(processItem(args.above, args.nowrapitems))
end

local function renderBelowRow(tbl)
	if not args.below then return end

	tbl:tag('tr')
		:tag('td')
			:addClass('navbox-abovebelow')
			:addClass(args.belowclass)
			:cssText(args.basestyle)
			:cssText(args.belowstyle)
			:attr('colspan', getAboveBelowColspan())
			:tag('div')
				:wikitext(processItem(args.below, args.nowrapitems))
end

--
--   List rows
--
local function renderListRow(tbl, index, listnum)
	local row = tbl:tag('tr')

	if index == 1 and args.imageleft then
		row
			:tag('td')
				:addClass('navbox-image')
				:addClass(args.imageclass)
				:css('width', '1px')               -- Minimize width
				:css('padding', '0px 2px 0px 0px')
				:cssText(args.imageleftstyle)
				:attr('rowspan', #listnums)
				:tag('div')
					:wikitext(processItem(args.imageleft))
	end

	if args['group' .. 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.above or args.group2) then
			groupCell
				:attr('id', mw.uri.anchorEncode(args.group1))
		end

		groupCell
			:attr('scope', 'row')
			:addClass('navbox-group')
			:addClass(args.groupclass)
			:cssText(args.basestyle)
			:css('width', args.groupwidth or '1%') -- If groupwidth not specified, minimize width

		groupCell
			:cssText(args.groupstyle)
			:cssText(args['group' .. listnum .. 'style'])
			:wikitext(args['group' .. listnum])
	end

	local listCell = row:tag('td')

	if args['group' .. listnum] then
		listCell
			:addClass('navbox-list1')
	else
		listCell:attr('colspan', 2)
	end

	if not args.groupwidth then
		listCell:css('width', '100%')
	end

	local rowstyle  -- usually nil so cssText(rowstyle) usually adds nothing
	if index % 2 == 1 then
		rowstyle = args.oddstyle
	else
		rowstyle = args.evenstyle
	end

	local listText = args['list' .. 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)
		:cssText(rowstyle)
		:cssText(args['list' .. listnum .. 'style'])
		:addClass('navbox-list')
		:addClass('navbox-' .. oddEven)
		:addClass(args.listclass)
		:addClass(args['list' .. listnum .. 'class'])
		:tag('div')
			:css('padding', (index == 1 and args.list1padding) or args.listpadding or '0em 0.25em')
			:wikitext(processItem(listText, args.nowrapitems))

	if index == 1 and args.image then
		row
			:tag('td')
				:addClass('navbox-image')
				:addClass(args.imageclass)
				:css('width', '1px')               -- Minimize width
				:css('padding', '0px 0px 0px 2px')
				:cssText(args.imagestyle)
				:attr('rowspan', #listnums)
				:tag('div')
					:wikitext(processItem(args.image))
	end
end


--
--   Tracking categories
--

local function needsHorizontalLists()
	if border == 'subgroup' or args.tracking == 'no' 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.bodyclass])
end

-- there are a lot of list classes in the wild, so we have a function to find
-- them and add their TemplateStyles
local function addListStyles()
	local frame = mw.getCurrentFrame()
	-- TODO?: Should maybe take a table of classes for e.g. hnum, hwrap as above
	-- I'm going to do the stupid thing first though
	-- Also not sure hnum and hwrap are going to live in the same TemplateStyles
	-- as hlist
	local function _addListStyles(htmlclass, templatestyles)
		local class_args = { -- rough order of probability of use
			'bodyclass', 'listclass', 'aboveclass', 'belowclass', 'titleclass',
			'navboxclass', 'groupclass', 'titlegroupclass', 'imageclass'
		}
		local patterns = {
			'^' .. htmlclass .. '$',
			'%s' .. htmlclass .. '$',
			'^' .. htmlclass .. '%s',
			'%s' .. htmlclass .. '%s'
		}
		
		local found = false
		for _, arg in ipairs(class_args) do
			for _, pattern in ipairs(patterns) do
				if mw.ustring.find(args[arg] or '', pattern) then
					found = true
					break
				end
			end
			if found then break end
		end
		if found then
			return frame:extensionTag{
				name = 'templatestyles', args = { src = templatestyles }
			}
		else
			return ''
		end
	end
	
	local hlist_styles = ''
	-- navbar always has mini = 1, so here (on this wiki) we can assume that
	-- we don't need to output hlist styles in navbox again.
	if not has_navbar() then
		hlist_styles = _addListStyles('hlist', 'Flatlist/styles.css')
	end
	local plainlist_styles = _addListStyles('plainlist', 'Plainlist/styles.css')
	
	return hlist_styles .. plainlist_styles
end

local function hasBackgroundColors()
	for _, key in ipairs({'titlestyle', 'groupstyle', 'basestyle', 'abovestyle', 'belowstyle'}) do
		if tostring(args[key]):find('background', 1, true) then
			return true
		end
	end
end

local function hasBorders()
	for _, key in ipairs({'groupstyle', 'basestyle', 'abovestyle', 'belowstyle'}) do
		if tostring(args[key]):find('border', 1, true) then
			return true
		end
	end
end

local function isIllegible()
	-- require('Module:Color contrast') absent on mediawiki.org
	return false
end

local function getTrackingCategories()
	local cats = {}
	if needsHorizontalLists() then table.insert(cats, 'Navigational boxes without horizontal lists') end
	if hasBackgroundColors() then table.insert(cats, 'Navboxes using background colours') end
	if isIllegible() then table.insert(cats, 'Potentially illegible navboxes') end
	if hasBorders() then table.insert(cats, 'Navboxes using borders') 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 == 'sandbox' or subpage == 'testcases' then return end

	for _, cat in ipairs(getTrackingCategories()) do
		builder:wikitext('[[Category:' .. cat .. ']]')
	end
end

--
--   Main navbox tables
--
local function renderMainTable()
	local tbl = mw.html.create('table')
		:addClass('nowraplinks')
		:addClass(args.bodyclass)

	if args.title and (args.state ~= 'plain' and args.state ~= 'off') then
		if args.state == 'collapsed' then args.state = 'mw-collapsed' end
		tbl
			:addClass('mw-collapsible')
			:addClass(args.state or 'autocollapse')
	end

	tbl:css('border-spacing', 0)
	if border == 'subgroup' or border == 'none' then
		tbl
			:addClass('navbox-subgroup')
			:cssText(args.bodystyle)
			:cssText(args.style)
	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)

	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+)$')
			if listnum then table.insert(listnums, tonumber(listnum)) end
		end
	end
	table.sort(listnums)

	border = mw.text.trim(args.border or args[1] or '')
	if border == 'child' then
		border = 'subgroup'
	end

	-- render the main body of the navbox
	local tbl = renderMainTable()
	
	-- get templatestyles
	local frame = mw.getCurrentFrame()
	local base_templatestyles = frame:extensionTag{
		name = 'templatestyles', args = { src = 'Module:Navbox/styles.css' }
	}
	local templatestyles = ''
	if args.templatestyles and args.templatestyles ~= '' then
		templatestyles = frame:extensionTag{
			name = 'templatestyles', args = { src = args.templatestyles }
		}
	end
	
	local res = mw.html.create()
	-- 'navbox-styles' exists for two reasons:
	--  1. To wrap the styles to work around phab: T200206 more elegantly. Instead
	--	   of combinatorial rules, this ends up being linear number of CSS rules.
	--  2. To allow MobileFrontend to rip the styles out with 'nomobile' such that
	--     they are not dumped into the mobile view.
	res:tag('div')
		:addClass('navbox-styles')
		:addClass('nomobile')
		:wikitext(base_templatestyles .. templatestyles)
		:done()
	
	-- render the appropriate wrapper around the navbox, depending on the border param
	if border == 'none' then
		local nav = res:tag('div')
			:attr('role', 'navigation')
			:wikitext(addListStyles())
			:node(tbl)
		-- aria-labelledby title, otherwise above, otherwise lone group
		if args.title or args.above or (args.group1 and not args.group2) then
			nav:attr('aria-labelledby', mw.uri.anchorEncode(args.title or args.above or args.group1))
		else
			nav:attr('aria-label', 'Navbox')
		end
	elseif border == 'subgroup' 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>')
			:wikitext(addListStyles())
			:node(tbl)
			:wikitext('<div>')
	else
		local nav = res:tag('div')
			:attr('role', 'navigation')
			:addClass('navbox')
			:addClass(args.navboxclass)
			:cssText(args.bodystyle)
			:cssText(args.style)
			:css('padding', '3px')
			:wikitext(addListStyles())
			:node(tbl)
		-- aria-labelledby title, otherwise above, otherwise lone group
		if args.title or args.above or (args.group1 and not args.group2) then
			nav:attr('aria-labelledby', mw.uri.anchorEncode(args.title or args.above or args.group1))
		else
			nav:attr('aria-label', 'Navbox')
		end
	end

	if (args.nocat or 'false'):lower() == 'false' then
		renderTrackingCategories(res)
	end

	return striped(tostring(res))
end

function p.navbox(frame)
	if not getArgs then
		getArgs = require('Module:Arguments').getArgs
	end
	args = getArgs(frame, {wrappers = {'Template:Navbox', 'Template:Navbox subgroup'}})
	if frame.args.border then
		-- This allows Template:Navbox_subgroup to use {{#invoke:Navbox|navbox|border=...}}.
		args.border = frame.args.border
	end

	-- Read the arguments in the order they'll be output in, to make references number in the right order.
	local _
	_ = args.title
	_ = args.above
	for i = 1, 20 do
		_ = args["group" .. tostring(i)]
		_ = args["list" .. tostring(i)]
	end
	_ = args.below

	return p._navbox(args)
end

return p
Retrieved from "https://wiki.jads.stream/index.php?title=Module:Navbox&oldid=82"