Difference between revisions of "Module:Sidebar"

From blackwiki
Jump to navigation Jump to search
blackwiki>Jackmcbarn
(fix incorrect navbars, and other minor fixes from sandbox)
m (31 revisions imported)
 
(11 intermediate revisions by 5 users not shown)
Line 7: Line 7:
  
 
local getArgs = require('Module:Arguments').getArgs
 
local getArgs = require('Module:Arguments').getArgs
local HtmlBuilder = require('Module:HtmlBuilder')
 
 
local navbar = require('Module:Navbar')._navbar
 
local navbar = require('Module:Navbar')._navbar
  
Line 20: Line 19:
 
else
 
else
 
return s
 
return s
 +
end
 +
end
 +
 +
local function hasSubgroup(s)
 +
if mw.ustring.find(s, 'vertical%-navbox%-subgroup') then
 +
return true
 +
else
 +
return false
 
end
 
end
 
end
 
end
Line 27: Line 34:
 
args = getArgs(frame)
 
args = getArgs(frame)
 
end
 
end
local root = HtmlBuilder.create()
+
local root = mw.html.create()
 
local child = args.child and mw.text.trim(args.child) == 'yes'
 
local child = args.child and mw.text.trim(args.child) == 'yes'
  
 +
root = root:tag('table')
 
if not child then
 
if not child then
root = root
+
root  
.tag('table')
+
:addClass('vertical-navbox')
.addClass('vertical-navbox')
+
:addClass(args.wraplinks ~= 'true' and 'nowraplinks' or nil)
.addClass(args.wraplinks ~= 'true' and 'nowraplinks')
+
:addClass(args.bodyclass or args.class)
.addClass(args.bodyclass or args.class)
+
:css('float', args.float or 'right')
.css('float', args.float or 'right')
+
:css('clear', (args.float == 'none' and 'both') or args.float or 'right')
.css('clear', (args.float == 'none' and 'both') or args.float or 'right')
+
:css('width', args.width or '22.0em')
.css('width', args.width or '22.0em')
+
:css('margin', args.float == 'left' and '0 1.0em 1.0em 0' or '0 0 1.0em 1.0em')
.css('margin', args.float == 'left' and '0 1.0em 1.0em 0' or '0 0 1.0em 1.0em')
+
:css('background', '#f8f9fa')
.css('background', '#f9f9f9')
+
:css('border', '1px solid #aaa')
.css('border', '1px solid #aaa')
+
:css('padding', '0.2em')
.css('padding', '0.2em')
+
:css('border-spacing', '0.4em 0')
.css('border-spacing', '0.4em 0')
+
:css('text-align', 'center')
.css('text-align', 'center')
+
:css('line-height', '1.4em')
.css('line-height', '1.4em')
+
:css('font-size', '88%')
.css('font-size', '88%')
+
:cssText(args.bodystyle or args.style)
.cssText(args.bodystyle or args.style)
 
  
 
if args.outertitle then
 
if args.outertitle then
 
root
 
root
.tag('caption')
+
:tag('caption')
.addClass(args.outertitleclass)
+
:addClass(args.outertitleclass)
.css('padding-bottom', '0.2em')
+
:css('padding-bottom', '0.2em')
.css('font-size', '125%')
+
:css('font-size', '125%')
.css('line-height', '1.2em')
+
:css('line-height', '1.2em')
.css('font-weight', 'bold')
+
:css('font-weight', 'bold')
.cssText(args.outertitlestyle)
+
:cssText(args.outertitlestyle)
.wikitext(args.outertitle)
+
:wikitext(args.outertitle)
 
end
 
end
  
 
if args.topimage then
 
if args.topimage then
local imageCell = root.tag('tr').tag('td')
+
local imageCell = root:tag('tr'):tag('td')
  
 
imageCell
 
imageCell
.addClass(args.topimageclass)
+
:addClass(args.topimageclass)
.css('padding', '0.4em 0')
+
:css('padding', '0.4em 0')
.cssText(args.topimagestyle)
+
:cssText(args.topimagestyle)
.wikitext(args.topimage)
+
:wikitext(args.topimage)
  
 
if args.topcaption then
 
if args.topcaption then
 
imageCell
 
imageCell
.tag('div')
+
:tag('div')
.css('padding-top', '0.2em')
+
:css('padding-top', '0.2em')
.css('line-height', '1.2em')
+
:css('line-height', '1.2em')
.cssText(args.topcaptionstyle)
+
:cssText(args.topcaptionstyle)
.wikitext(args.topcaption)
+
:wikitext(args.topcaption)
 
end
 
end
 
end
 
end
Line 82: Line 89:
 
if args.pretitle then
 
if args.pretitle then
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('td')
+
:tag('td')
.addClass(args.pretitleclass)
+
:addClass(args.pretitleclass)
.cssText(args.basestyle)
+
:cssText(args.basestyle)
.css('padding-top', args.topimage and '0.2em' or '0.4em')
+
:css('padding-top', args.topimage and '0.2em' or '0.4em')
.css('line-height', '1.2em')
+
:css('line-height', '1.2em')
.cssText(args.pretitlestyle)
+
:cssText(args.pretitlestyle)
.wikitext(args.pretitle)
+
:wikitext(args.pretitle)
 
end
 
end
 
+
else
 +
root
 +
:addClass('vertical-navbox-subgroup')
 +
:css('width', '100%')
 +
:css('margin', '0px')
 +
:css('border-spacing', '0px')
 +
:addClass(args.bodyclass or args.class)
 +
:cssText(args.bodystyle or args.style)
 
end
 
end
  
Line 97: Line 111:
 
if child then
 
if child then
 
root
 
root
.wikitext(args.title)
+
:wikitext(args.title)
.tag('/th', {unclosed = true})
 
.tag('/tr', {unclosed = true})
 
 
else
 
else
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('th')
+
:tag('th')
.addClass(args.titleclass)
+
:addClass(args.titleclass)
.cssText(args.basestyle)
+
:cssText(args.basestyle)
.css('padding', '0.2em 0.4em 0.2em')
+
:css('padding', '0.2em 0.4em 0.2em')
.css('padding-top', args.pretitle and 0)
+
:css('padding-top', args.pretitle and 0)
.css('font-size', '145%')
+
:css('font-size', '145%')
.css('line-height', '1.2em')
+
:css('line-height', '1.2em')
.cssText(args.titlestyle)
+
:cssText(args.titlestyle)
.wikitext(args.title)
+
:wikitext(args.title)
 
end
 
end
 
end
 
end
  
 
if args.image then
 
if args.image then
local imageCell = root.tag('tr').tag('td')
+
local imageCell = root:tag('tr'):tag('td')
  
 
imageCell
 
imageCell
.addClass(args.imageclass)
+
:addClass(args.imageclass)
.css('padding', '0.2em 0 0.4em')
+
:css('padding', '0.2em 0 0.4em')
.cssText(args.imagestyle)
+
:cssText(args.imagestyle)
.wikitext(args.image)
+
:wikitext(args.image)
  
 
if args.caption then
 
if args.caption then
 
imageCell
 
imageCell
.tag('div')
+
:tag('div')
.css('padding-top', '0.2em')
+
:css('padding-top', '0.2em')
.css('line-height', '1.2em')
+
:css('line-height', '1.2em')
.cssText(args.captionstyle)
+
:cssText(args.captionstyle)
.wikitext(args.caption)
+
:wikitext(args.caption)
 
end
 
end
 
end
 
end
Line 136: Line 148:
 
if args.above then
 
if args.above then
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('td')
+
:tag('td')
.addClass(args.aboveclass)
+
:addClass(args.aboveclass)
.css('padding', '0.3em 0.4em 0.3em')
+
:css('padding', '0.3em 0.4em 0.3em')
.css('font-weight', 'bold')
+
:css('font-weight', 'bold')
.cssText(args.abovestyle)
+
:cssText(args.abovestyle)
.newline() -- newline required for bullet-points to work
+
:newline() -- newline required for bullet-points to work
.wikitext(args.above)
+
:wikitext(args.above)
 
end
 
end
  
Line 164: Line 176:
 
if heading then
 
if heading then
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('th')
+
:tag('th')
.addClass(args.headingclass)
+
:addClass(args.headingclass)
.css('padding', '0.1em')
+
:css('padding', '0.1em')
.cssText(args.basestyle)
+
:cssText(args.basestyle)
.cssText(args.headingstyle)
+
:cssText(args.headingstyle)
.cssText(args['heading' .. num .. 'style'])
+
:cssText(args['heading' .. num .. 'style'])
.newline()
+
:newline()
.wikitext(heading)
+
:wikitext(heading)
 
end
 
end
  
Line 178: Line 190:
 
if content then
 
if content then
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('td')
+
:tag('td')
.addClass(args.contentclass)
+
:addClass(args.contentclass)
.css('padding', '0 0.1em 0.4em')
+
:css('padding', hasSubgroup(content) and '0.1em 0 0.2em' or '0 0.1em 0.4em')
.cssText(args.contentstyle)
+
:cssText(args.contentstyle)
.cssText(args['content' .. num .. 'style'])
+
:cssText(args['content' .. num .. 'style'])
.newline()
+
:newline()
.wikitext(content)
+
:wikitext(content)
.done()
+
:done()
.newline() -- Without a linebreak after the </td>, a nested list like "* {{hlist| ...}}" doesn't parse correctly.
+
:newline() -- Without a linebreak after the </td>, a nested list like "* {{hlist| ...}}" doesn't parse correctly.
 
end
 
end
 
end
 
end
Line 193: Line 205:
 
if args.below then
 
if args.below then
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('td')
+
:tag('td')
.addClass(args.belowclass)
+
:addClass(args.belowclass)
.css('padding', '0.3em 0.4em 0.3em')
+
:css('padding', '0.3em 0.4em 0.3em')
.css('font-weight', 'bold')
+
:css('font-weight', 'bold')
.cssText(args.belowstyle)
+
:cssText(args.belowstyle)
.newline()
+
:newline()
.wikitext(args.below)
+
:wikitext(args.below)
 
end
 
end
  
Line 207: Line 219:
 
if navbarArg ~= 'none' and navbarArg ~= 'off' and (args.name or frame:getParent():getTitle():gsub('/sandbox$', '') ~= 'Template:Sidebar') then
 
if navbarArg ~= 'none' and navbarArg ~= 'off' and (args.name or frame:getParent():getTitle():gsub('/sandbox$', '') ~= 'Template:Sidebar') then
 
root
 
root
.tag('tr')
+
:tag('tr')
.tag('td')
+
:tag('td')
.css('text-align', 'right')
+
:css('text-align', 'right')
.css('font-size', '115%')
+
:css('font-size', '115%')
.cssText(args.navbarstyle or args.tnavbarstyle)
+
:cssText(args.navbarstyle or args.tnavbarstyle)
.wikitext(navbar{
+
:wikitext(navbar{
 
args.name,
 
args.name,
 
mini = 1,
 
mini = 1,
Line 220: Line 232:
 
end
 
end
  
return tostring(root)
+
return tostring(root) .. (child and '[[Category:Pages using sidebar with the child parameter]]' or '')
 
end
 
end
  
function p.collapsibleSidebar(frame)
+
function p.collapsible(frame)
 
local args = getArgs(frame)
 
local args = getArgs(frame)
  
Line 229: Line 241:
 
args.belowstyle = 'border-top: 1px solid #aaa; border-bottom: 1px solid #aaa;' .. (args.belowstyle or '')
 
args.belowstyle = 'border-top: 1px solid #aaa; border-bottom: 1px solid #aaa;' .. (args.belowstyle or '')
 
args.navbarstyle = 'padding-top: 0.6em;' .. (args.navbarstyle or args.tnavbarstyle or '')
 
args.navbarstyle = 'padding-top: 0.6em;' .. (args.navbarstyle or args.tnavbarstyle or '')
 +
if not args.name and frame:getParent():getTitle():gsub('/sandbox$', '') == 'Template:Sidebar with collapsible lists' then
 +
args.navbar = 'none'
 +
end
  
 
local contentArgs = {}
 
local contentArgs = {}
Line 237: Line 252:
 
local expand = args.expanded and (args.expanded == 'all' or args.expanded == args['list' .. num .. 'name'])
 
local expand = args.expanded and (args.expanded == 'all' or args.expanded == args['list' .. num .. 'name'])
  
local row = HtmlBuilder.create('div')
+
local row = mw.html.create('div')
 
row
 
row
.addClass('NavFrame')
+
:addClass('NavFrame')
.addClass((not expand) and 'collapsed')
+
:addClass((not expand) and 'collapsed' or nil)
.css('border', 'none')
+
:css('border', 'none')
.css('padding', 0)
+
:css('padding', 0)
.cssText(args.listframestyle)
+
:cssText(args.listframestyle)
.cssText(args['list' .. num .. 'framestyle'])
+
:cssText(args['list' .. num .. 'framestyle'])
.tag('div')
+
:tag('div')
.addClass('NavHead')
+
:addClass('NavHead')
.addClass(args.listtitleclass)
+
:addClass(args.listtitleclass)
.css('font-size', '105%')
+
:css('font-size', '105%')
.css('background', 'transparent')
+
:css('background', 'transparent')
.css('text-align', 'left')
+
:css('text-align', 'left')
.cssText(args.basestyle)
+
:cssText(args.basestyle)
.cssText(args.listtitlestyle)
+
:cssText(args.listtitlestyle)
.cssText(args['list' .. num .. 'titlestyle'])
+
:cssText(args['list' .. num .. 'titlestyle'])
.wikitext(trimAndAddAutomaticNewline(args['list' .. num .. 'title'] or 'List'))
+
:wikitext(trimAndAddAutomaticNewline(args['list' .. num .. 'title'] or 'List'))
.done()
+
:done()
.tag('div')
+
:tag('div')
.addClass('NavContent')
+
:addClass('NavContent')
.addClass(args.listclass)
+
:addClass(args.listclass)
.addClass(args['list' .. num .. 'class'])
+
:addClass(args['list' .. num .. 'class'])
.css('font-size', '105%')
+
:css('font-size', '105%')
.css('padding', '0.2em 0 0.4em')
+
:css('padding', '0.2em 0 0.4em')
.css('text-align', 'center')
+
:css('text-align', 'center')
.cssText(args.liststyle)
+
:cssText(args.liststyle)
.cssText(args['list' .. num .. 'style'])
+
:cssText(args['list' .. num .. 'style'])
.wikitext(trimAndAddAutomaticNewline(args['list' .. num]))
+
:wikitext(trimAndAddAutomaticNewline(args['list' .. num]))
  
 
contentArgs['content' .. num] = tostring(row)
 
contentArgs['content' .. num] = tostring(row)
Line 275: Line 290:
 
end
 
end
  
return p.sidebar(args)
+
return p.sidebar(frame, args)
 
end
 
end
  
 
return p
 
return p

Latest revision as of 15:15, 22 September 2020

This module implements the templates {{sidebar}} and {{sidebar with collapsible lists}}. See the individual template pages for documentation.


--
-- This module implements {{Sidebar}}
--
require('Module:No globals')

local p = {}

local getArgs = require('Module:Arguments').getArgs
local navbar = require('Module:Navbar')._navbar

local function trimAndAddAutomaticNewline(s)
	-- For compatibility with the original {{sidebar with collapsible lists}}
	-- implementation, which passed some parameters through {{#if}} to trim
	-- their whitespace. This also triggered the automatic newline behavior.
	-- ([[meta:Help:Newlines and spaces#Automatic newline]])
	s = mw.ustring.gsub(s, "^%s*(.-)%s*$", "%1")
	if mw.ustring.find(s, '^[#*:;]') or mw.ustring.find(s, '^{|') then
		return '\n' .. s
	else
		return s
	end
end

local function hasSubgroup(s)
	if mw.ustring.find(s, 'vertical%-navbox%-subgroup') then
		return true
	else
		return false
	end
end

function p.sidebar(frame, args)
	if not args then
		args = getArgs(frame)
	end
	local root = mw.html.create()
	local child = args.child and mw.text.trim(args.child) == 'yes'

	root = root:tag('table')
	if not child then
		root 
			:addClass('vertical-navbox')
			:addClass(args.wraplinks ~= 'true' and 'nowraplinks' or nil)
			:addClass(args.bodyclass or args.class)
			:css('float', args.float or 'right')
			:css('clear', (args.float == 'none' and 'both') or args.float or 'right')
			:css('width', args.width or '22.0em')
			:css('margin', args.float == 'left' and '0 1.0em 1.0em 0' or '0 0 1.0em 1.0em')
			:css('background', '#f8f9fa')
			:css('border', '1px solid #aaa')
			:css('padding', '0.2em')
			:css('border-spacing', '0.4em 0')
			:css('text-align', 'center')
			:css('line-height', '1.4em')
			:css('font-size', '88%')
			:cssText(args.bodystyle or args.style)

		if args.outertitle then
			root
				:tag('caption')
					:addClass(args.outertitleclass)
					:css('padding-bottom', '0.2em')
					:css('font-size', '125%')
					:css('line-height', '1.2em')
					:css('font-weight', 'bold')
					:cssText(args.outertitlestyle)
					:wikitext(args.outertitle)
		end

		if args.topimage then
			local imageCell = root:tag('tr'):tag('td')

			imageCell
				:addClass(args.topimageclass)
				:css('padding', '0.4em 0')
				:cssText(args.topimagestyle)
				:wikitext(args.topimage)

			if args.topcaption then
				imageCell
					:tag('div')
						:css('padding-top', '0.2em')
						:css('line-height', '1.2em')
						:cssText(args.topcaptionstyle)
						:wikitext(args.topcaption)
			end
		end

		if args.pretitle then
			root
				:tag('tr')
					:tag('td')
						:addClass(args.pretitleclass)
						:cssText(args.basestyle)
						:css('padding-top', args.topimage and '0.2em' or '0.4em')
						:css('line-height', '1.2em')
						:cssText(args.pretitlestyle)
						:wikitext(args.pretitle)
		end
	else
		root
			:addClass('vertical-navbox-subgroup')
			:css('width', '100%')
			:css('margin', '0px')
			:css('border-spacing', '0px')
			:addClass(args.bodyclass or args.class)
			:cssText(args.bodystyle or args.style)
	end

	if args.title then
		if child then
			root
				:wikitext(args.title)
		else
			root
				:tag('tr')
					:tag('th')
						:addClass(args.titleclass)
						:cssText(args.basestyle)
						:css('padding', '0.2em 0.4em 0.2em')
						:css('padding-top', args.pretitle and 0)
						:css('font-size', '145%')
						:css('line-height', '1.2em')
						:cssText(args.titlestyle)
						:wikitext(args.title)
		end
	end

	if args.image then
		local imageCell = root:tag('tr'):tag('td')

		imageCell
			:addClass(args.imageclass)
			:css('padding', '0.2em 0 0.4em')
			:cssText(args.imagestyle)
			:wikitext(args.image)

		if args.caption then
			imageCell
				:tag('div')
					:css('padding-top', '0.2em')
					:css('line-height', '1.2em')
					:cssText(args.captionstyle)
					:wikitext(args.caption)
		end
	end

	if args.above then
		root
			:tag('tr')
				:tag('td')
					:addClass(args.aboveclass)
					:css('padding', '0.3em 0.4em 0.3em')
					:css('font-weight', 'bold')
					:cssText(args.abovestyle)
					:newline() -- newline required for bullet-points to work
					:wikitext(args.above)
	end

	local rowNums = {}
	for k, v in pairs(args) do
		k = '' .. k
		local num = k:match('^heading(%d+)$') or k:match('^content(%d+)$')
		if num then table.insert(rowNums, tonumber(num)) end
	end
	table.sort(rowNums)
	-- remove duplicates from the list (e.g. 3 will be duplicated if both heading3 and content3 are specified)
	for i = #rowNums, 1, -1 do
		if rowNums[i] == rowNums[i - 1] then
			table.remove(rowNums, i)
		end
	end

	for i, num in ipairs(rowNums) do
		local heading = args['heading' .. num]
		if heading then
			root
				:tag('tr')
					:tag('th')
						:addClass(args.headingclass)
						:css('padding', '0.1em')
						:cssText(args.basestyle)
						:cssText(args.headingstyle)
						:cssText(args['heading' .. num .. 'style'])
						:newline()
						:wikitext(heading)
		end

		local content = args['content' .. num]
		if content then
			root
				:tag('tr')
					:tag('td')
						:addClass(args.contentclass)
						:css('padding', hasSubgroup(content) and '0.1em 0 0.2em' or '0 0.1em 0.4em')
						:cssText(args.contentstyle)
						:cssText(args['content' .. num .. 'style'])
						:newline()
						:wikitext(content)
						:done()
					:newline() -- Without a linebreak after the </td>, a nested list like "* {{hlist| ...}}" doesn't parse correctly.
		end
	end

	if args.below then
		root
			:tag('tr')
				:tag('td')
					:addClass(args.belowclass)
					:css('padding', '0.3em 0.4em 0.3em')
					:css('font-weight', 'bold')
					:cssText(args.belowstyle)
					:newline()
					:wikitext(args.below)
	end

	if not child then
		local navbarArg = args.navbar or args.tnavbar
		if navbarArg ~= 'none' and navbarArg ~= 'off' and (args.name or frame:getParent():getTitle():gsub('/sandbox$', '') ~= 'Template:Sidebar') then
			root
				:tag('tr')
					:tag('td')
						:css('text-align', 'right')
						:css('font-size', '115%')
						:cssText(args.navbarstyle or args.tnavbarstyle)
						:wikitext(navbar{
							args.name,
							mini = 1,
							fontstyle = args.navbarfontstyle or args.tnavbarfontstyle
						})
		end
	end

	return tostring(root) .. (child and '[[Category:Pages using sidebar with the child parameter]]' or '')
end

function p.collapsible(frame)
	local args = getArgs(frame)

	args.abovestyle = 'border-top: 1px solid #aaa; border-bottom: 1px solid #aaa;' .. (args.abovestyle or '')
	args.belowstyle = 'border-top: 1px solid #aaa; border-bottom: 1px solid #aaa;' .. (args.belowstyle or '')
	args.navbarstyle = 'padding-top: 0.6em;' .. (args.navbarstyle or args.tnavbarstyle or '')
	if not args.name and frame:getParent():getTitle():gsub('/sandbox$', '') == 'Template:Sidebar with collapsible lists' then
		args.navbar = 'none'
	end

	local contentArgs = {}

	for k, v in pairs(args) do
		local num = string.match(k, '^list(%d+)$')
		if num then
			local expand = args.expanded and (args.expanded == 'all' or args.expanded == args['list' .. num .. 'name'])

			local row = mw.html.create('div')
			row
				:addClass('NavFrame')
				:addClass((not expand) and 'collapsed' or nil)
				:css('border', 'none')
				:css('padding', 0)
				:cssText(args.listframestyle)
				:cssText(args['list' .. num .. 'framestyle'])
				:tag('div')
					:addClass('NavHead')
					:addClass(args.listtitleclass)
					:css('font-size', '105%')
					:css('background', 'transparent')
					:css('text-align', 'left')
					:cssText(args.basestyle)
					:cssText(args.listtitlestyle)
					:cssText(args['list' .. num .. 'titlestyle'])
					:wikitext(trimAndAddAutomaticNewline(args['list' .. num .. 'title'] or 'List'))
					:done()
				:tag('div')
					:addClass('NavContent')
					:addClass(args.listclass)
					:addClass(args['list' .. num .. 'class'])
					:css('font-size', '105%')
					:css('padding', '0.2em 0 0.4em')
					:css('text-align', 'center')
					:cssText(args.liststyle)
					:cssText(args['list' .. num .. 'style'])
					:wikitext(trimAndAddAutomaticNewline(args['list' .. num]))

			contentArgs['content' .. num] = tostring(row)
		end
	end

	for k, v in pairs(contentArgs) do
		args[k] = v
	end

	return p.sidebar(frame, args)
end

return p