Module:Infobox: Difference between revisions
Undid revision 663978215 by Jackmcbarn (talk): gerrit:216688
m>Jackmcbarn (from sandbox, remove now-unnecessary argument parsing complexity, and some other fixes) |
m>Jackmcbarn (Undid revision 663978215 by Jackmcbarn (talk): gerrit:216688) |
||
Line 2: | Line 2: | ||
-- This module implements {{Infobox}} | -- This module implements {{Infobox}} | ||
-- | -- | ||
local p = {} | |||
local | local navbar = require('Module:Navbar')._navbar | ||
local args = {} | |||
local origArgs | |||
local root | |||
local function union(t1, t2) | local function union(t1, t2) | ||
Line 21: | Line 27: | ||
end | end | ||
local function getArgNums( | local function getArgNums(prefix) | ||
-- Returns a table containing the numbers of the arguments that exist | -- Returns a table containing the numbers of the arguments that exist | ||
-- for the specified prefix. For example, if the prefix was 'data', and | -- for the specified prefix. For example, if the prefix was 'data', and | ||
Line 34: | Line 40: | ||
end | end | ||
local function addRow( | local function addRow(rowArgs) | ||
-- Adds a row to the infobox, with either a header cell | -- Adds a row to the infobox, with either a header cell | ||
-- or a label/data cell combination. | -- or a label/data cell combination. | ||
Line 66: | Line 72: | ||
:done() | :done() | ||
end | end | ||
local dataCell = row:tag('td') | local dataCell = row:tag('td') | ||
if not rowArgs.label then | if not rowArgs.label then | ||
dataCell | dataCell | ||
:attr('colspan', 2) | :attr('colspan', 2) | ||
:css('text-align', 'center') | :css('text-align', 'center') | ||
end | end | ||
dataCell | dataCell | ||
Line 82: | Line 88: | ||
end | end | ||
local function renderTitle( | local function renderTitle() | ||
if not args.title then return end | if not args.title then return end | ||
Line 92: | Line 98: | ||
end | end | ||
local function renderAboveRow( | local function renderAboveRow() | ||
if not args.above then return end | if not args.above then return end | ||
root | root | ||
:tag('tr') | :tag('tr') | ||
Line 107: | Line 113: | ||
end | end | ||
local function renderBelowRow( | local function renderBelowRow() | ||
if not args.below then return end | if not args.below then return end | ||
root | root | ||
:tag('tr') | :tag('tr') | ||
Line 121: | Line 127: | ||
end | end | ||
local function renderSubheaders( | local function renderSubheaders() | ||
if args.subheader then | if args.subheader then | ||
args.subheader1 = args.subheader | args.subheader1 = args.subheader | ||
Line 128: | Line 134: | ||
args.subheaderrowclass1 = args.subheaderrowclass | args.subheaderrowclass1 = args.subheaderrowclass | ||
end | end | ||
local subheadernums = getArgNums( | local subheadernums = getArgNums('subheader') | ||
for k, num in ipairs(subheadernums) do | for k, num in ipairs(subheadernums) do | ||
addRow( | addRow({ | ||
data = args['subheader' .. tostring(num)], | data = args['subheader' .. tostring(num)], | ||
datastyle = args.subheaderstyle or args['subheaderstyle' .. tostring(num)], | datastyle = args.subheaderstyle or args['subheaderstyle' .. tostring(num)], | ||
Line 139: | Line 145: | ||
end | end | ||
local function renderImages( | local function renderImages() | ||
if args.image then | if args.image then | ||
args.image1 = args.image | args.image1 = args.image | ||
Line 146: | Line 152: | ||
args.caption1 = args.caption | args.caption1 = args.caption | ||
end | end | ||
local imagenums = getArgNums( | local imagenums = getArgNums('image') | ||
for k, num in ipairs(imagenums) do | for k, num in ipairs(imagenums) do | ||
local caption = args['caption' .. tostring(num)] | local caption = args['caption' .. tostring(num)] | ||
Line 156: | Line 162: | ||
:wikitext(caption) | :wikitext(caption) | ||
end | end | ||
addRow( | addRow({ | ||
data = tostring(data), | data = tostring(data), | ||
datastyle = args.imagestyle, | datastyle = args.imagestyle, | ||
Line 165: | Line 171: | ||
end | end | ||
local function renderRows( | local function renderRows() | ||
-- Gets the union of the header and data argument numbers, | -- Gets the union of the header and data argument numbers, | ||
-- and renders them all in order using addRow. | -- and renders them all in order using addRow. | ||
local rownums = union(getArgNums( | local rownums = union(getArgNums('header'), getArgNums('data')) | ||
table.sort(rownums) | table.sort(rownums) | ||
for k, num in ipairs(rownums) do | for k, num in ipairs(rownums) do | ||
addRow( | addRow({ | ||
header = args['header' .. tostring(num)], | header = args['header' .. tostring(num)], | ||
label = args['label' .. tostring(num)], | label = args['label' .. tostring(num)], | ||
Line 187: | Line 193: | ||
end | end | ||
local function renderNavBar( | local function renderNavBar() | ||
if not args.name then return end | if not args.name then return end | ||
root | root | ||
:tag('tr') | :tag('tr') | ||
Line 195: | Line 201: | ||
:attr('colspan', '2') | :attr('colspan', '2') | ||
:css('text-align', 'right') | :css('text-align', 'right') | ||
:wikitext( | :wikitext(navbar{ | ||
args.name, | args.name, | ||
mini = 1, | mini = 1, | ||
Line 201: | Line 207: | ||
end | end | ||
local function renderItalicTitle( | local function renderItalicTitle() | ||
local italicTitle = args['italic title'] and mw.ustring.lower(args['italic title']) | local italicTitle = args['italic title'] and mw.ustring.lower(args['italic title']) | ||
if italicTitle == '' or italicTitle == 'force' or italicTitle == 'yes' then | if italicTitle == '' or italicTitle == 'force' or italicTitle == 'yes' then | ||
Line 208: | Line 214: | ||
end | end | ||
local function renderTrackingCategories( | local function renderTrackingCategories() | ||
if args.decat ~= 'yes' then | if args.decat ~= 'yes' then | ||
if #(getArgNums( | if #(getArgNums('data')) == 0 and mw.title.getCurrentTitle().namespace == 0 then | ||
root:wikitext('[[Category:Articles which use infobox templates with no data rows]]') | root:wikitext('[[Category:Articles which use infobox templates with no data rows]]') | ||
end | end | ||
Line 219: | Line 225: | ||
end | end | ||
local function _infobox() | |||
-- Specify the overall layout of the infobox, with special settings | -- Specify the overall layout of the infobox, with special settings | ||
-- if the infobox is used as a 'child' inside another infobox. | -- if the infobox is used as a 'child' inside another infobox. | ||
if args.child ~= 'yes' then | if args.child ~= 'yes' then | ||
root = mw.html.create('table') | root = mw.html.create('table') | ||
root | root | ||
:addClass('infobox') | :addClass('infobox') | ||
:addClass(args.bodyclass) | :addClass(args.bodyclass) | ||
if args.subbox == 'yes' then | if args.subbox == 'yes' then | ||
root | root | ||
Line 253: | Line 252: | ||
root | root | ||
:cssText(args.bodystyle) | :cssText(args.bodystyle) | ||
renderTitle( | renderTitle() | ||
renderAboveRow( | renderAboveRow() | ||
else | else | ||
root = mw.html.create() | root = mw.html.create() | ||
root | root | ||
:wikitext(args.title) | :wikitext(args.title) | ||
end | end | ||
renderSubheaders( | renderSubheaders() | ||
renderImages( | renderImages() | ||
renderRows( | renderRows() | ||
renderBelowRow( | renderBelowRow() | ||
renderNavBar( | renderNavBar() | ||
renderItalicTitle( | renderItalicTitle() | ||
renderTrackingCategories(root | renderTrackingCategories() | ||
return tostring(root) | |||
end | |||
local function preprocessSingleArg(argName) | |||
-- If the argument exists and isn't blank, add it to the argument table. | |||
-- Blank arguments are treated as nil to match the behaviour of ParserFunctions. | |||
if origArgs[argName] and origArgs[argName] ~= '' then | |||
args[argName] = origArgs[argName] | |||
end | |||
end | end | ||
local function preprocessArgs(prefixTable, step) | |||
-- Assign the parameters with the given prefixes to the args table, in order, in batches | |||
-- of the step size specified. This is to prevent references etc. from appearing in the | |||
-- wrong order. The prefixTable should be an array containing tables, each of which has | |||
-- two possible fields, a "prefix" string and a "depend" table. The function always parses | |||
-- parameters containing the "prefix" string, but only parses parameters in the "depend" | |||
-- table if the prefix parameter is present and non-blank. | |||
if type(prefixTable) ~= 'table' then | |||
error("Non-table value detected for the prefix table", 2) | |||
end | |||
if type(step) ~= 'number' then | |||
error("Invalid step value detected", 2) | |||
end | |||
-- Get arguments without a number suffix, and check for bad input. | |||
for i,v in ipairs(prefixTable) do | |||
if type(v) ~= 'table' or type(v.prefix) ~= "string" or (v.depend and type(v.depend) ~= 'table') then | |||
error('Invalid input detected to preprocessArgs prefix table', 2) | |||
end | |||
preprocessSingleArg(v.prefix) | |||
-- Only parse the depend parameter if the prefix parameter is present and not blank. | |||
if args[v.prefix] and v.depend then | |||
for j, dependValue in ipairs(v.depend) do | |||
if type(dependValue) ~= 'string' then | |||
error('Invalid "depend" parameter value detected in preprocessArgs') | |||
end | |||
preprocessSingleArg(dependValue) | |||
end | |||
end | |||
end | |||
-- Get arguments with number suffixes. | |||
local a = 1 -- Counter variable. | |||
local moreArgumentsExist = true | |||
while moreArgumentsExist == true do | |||
moreArgumentsExist = false | |||
for i = a, a + step - 1 do | |||
for j,v in ipairs(prefixTable) do | |||
local prefixArgName = v.prefix .. tostring(i) | |||
if origArgs[prefixArgName] then | |||
moreArgumentsExist = true -- Do another loop if any arguments are found, even blank ones. | |||
preprocessSingleArg(prefixArgName) | |||
end | |||
-- Process the depend table if the prefix argument is present and not blank, or | |||
-- we are processing "prefix1" and "prefix" is present and not blank, and | |||
-- if the depend table is present. | |||
if v.depend and (args[prefixArgName] or (i == 1 and args[v.prefix])) then | |||
for j,dependValue in ipairs(v.depend) do | |||
local dependArgName = dependValue .. tostring(i) | |||
preprocessSingleArg(dependArgName) | |||
end | |||
end | |||
end | |||
end | |||
a = a + step | |||
end | |||
end | |||
function p.infobox(frame) | |||
-- If called via #invoke, use the args passed into the invoking template. | |||
-- Otherwise, for testing purposes, assume args are being passed directly in. | |||
if frame == mw.getCurrentFrame() then | |||
origArgs = frame:getParent().args | |||
else | |||
origArgs = frame | |||
end | |||
-- Parse the data parameters in the same order that the old {{infobox}} did, so that | |||
-- references etc. will display in the expected places. Parameters that depend on | |||
-- another parameter are only processed if that parameter is present, to avoid | |||
-- phantom references appearing in article reference lists. | |||
preprocessSingleArg('child') | |||
preprocessSingleArg('bodyclass') | |||
preprocessSingleArg('subbox') | |||
preprocessSingleArg('bodystyle') | |||
preprocessSingleArg('title') | |||
preprocessSingleArg('titleclass') | |||
preprocessSingleArg('titlestyle') | |||
preprocessSingleArg('above') | |||
preprocessSingleArg('aboveclass') | |||
preprocessSingleArg('abovestyle') | |||
preprocessArgs({ | |||
{prefix = 'subheader', depend = {'subheaderstyle', 'subheaderrowclass'}} | |||
}, 10) | |||
preprocessSingleArg('subheaderstyle') | |||
preprocessSingleArg('subheaderclass') | |||
preprocessArgs({ | |||
{prefix = 'image', depend = {'caption', 'imagerowclass'}} | |||
}, 10) | |||
preprocessSingleArg('captionstyle') | |||
preprocessSingleArg('imagestyle') | |||
preprocessSingleArg('imageclass') | |||
preprocessArgs({ | |||
{prefix = 'header'}, | |||
{prefix = 'data', depend = {'label'}}, | |||
{prefix = 'rowclass'}, | |||
{prefix = 'rowstyle'}, | |||
{prefix = 'class'}, | |||
{prefix = 'dataid'}, | |||
{prefix = 'labelid'}, | |||
{prefix = 'headerid'}, | |||
{prefix = 'rowid'} | |||
}, 50) | |||
preprocessSingleArg('headerclass') | |||
preprocessSingleArg('headerstyle') | |||
preprocessSingleArg('labelstyle') | |||
preprocessSingleArg('datastyle') | |||
preprocessSingleArg('below') | |||
preprocessSingleArg('belowclass') | |||
preprocessSingleArg('belowstyle') | |||
preprocessSingleArg('name') | |||
args['italic title'] = origArgs['italic title'] -- different behaviour if blank or absent | |||
preprocessSingleArg('decat') | |||
return _infobox() | |||
end | |||
return p | return p |