Модуль:Sidebar

Документація модуля[перегляд] [редагувати] [історія] [очистити кеш]

Цей модуль реалізує роботу шаблонів {{sidebar}} та {{sidebar with collapsible lists}}. Дивіться документацію на окремих сторінках шаблонів.

--
-- Цей модуль реалізує роботу шаблону {{Sidebar}}
--
require('strict')
local cfg = mw.loadData('Модуль:Sidebar/configuration')

local p = {}

local getArgs = require('Модуль:Arguments').getArgs

--[[
Categorizes calling templates and modules with a 'style' parameter of any sort
for tracking to convert to TemplateStyles.

TODO after a long cleanup: Catch sidebars in other namespaces than Template and Module.
TODO would probably want to remove /log and /archive as CS1 does
]]
local function categorizeTemplatesWithInlineStyles(args)
	local title = mw.title.getCurrentTitle()
	if title.namespace ~= 10 and title.namespace ~= 828 then return '' end
	for _, pattern in ipairs (cfg.i18n.pattern.uncategorized_conversion_titles) do
		if title.text:match(pattern) then return '' end
	end
	
	for key, _ in pairs(args) do
		if mw.ustring.find(key, cfg.i18n.pattern.style_conversion) or key == 'width' then
			return cfg.i18n.category.conversion
		end
	end
end

--[[
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.
]]
-- See ([[meta:Help:Newlines and spaces#Automatic newline]])
local function trimAndAddAutomaticNewline(s)
	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

--[[
Finds whether a sidebar has a subgroup sidebar.
]]
local function hasSubgroup(s)
	if mw.ustring.find(s, cfg.i18n.pattern.subgroup) then
		return true
	else
		return false
	end
end

local function has_navbar(navbar_mode, sidebar_name)
	return navbar_mode ~= cfg.i18n.navbar_none and
		navbar_mode ~= cfg.i18n.navbar_off and
		(
			sidebar_name or
			mw.getCurrentFrame():getParent():getTitle():gsub(cfg.i18n.pattern.sandbox, '') ~=
			cfg.i18n.title_not_to_add_navbar
		)
end

local function has_list_class(args, htmlclass)
	local patterns = {
		'^' .. htmlclass .. '$',
		'%s' .. htmlclass .. '$',
		'^' .. htmlclass .. '%s',
		'%s' .. htmlclass .. '%s'
	}
	
	for arg, value in pairs(args) do
		if type(arg) == 'string' and mw.ustring.find(arg, 'class') then
			for _, pattern in ipairs(patterns) do
				if mw.ustring.find(args[arg] or '', pattern) then
					return true
				end
			end
		end
	end
	return false
end

-- there are a lot of list classes in the wild, so we add their TemplateStyles
local function add_list_styles(args)
	local frame = mw.getCurrentFrame()
	local function add_list_templatestyles(htmlclass, templatestyles)
		if has_list_class(args, htmlclass) then
			return frame:extensionTag{
				name = 'templatestyles', args = { src = templatestyles }
			}
		else
			return ''
		end
	end
	
	local plainlist_styles = add_list_templatestyles('plainlist', cfg.i18n.plainlist_templatestyles)
	local hlist_styles = add_list_templatestyles('hlist', cfg.i18n.hlist_templatestyles)
	
	-- a second workaround for [[phab:T303378]]
	-- when that issue is fixed, we can actually use has_navbar not to emit the
	-- tag here if we want
	if has_navbar(args.navbar or args['навпан'], args.name or args['ім\'я']) and hlist_styles == '' then
		hlist_styles = frame:extensionTag{
			name = 'templatestyles', args = { src = cfg.i18n.hlist_templatestyles}
		}
	end

	-- hlist -> plainlist is best-effort to preserve old Common.css ordering. [hlist_note]
	return hlist_styles .. plainlist_styles
end

-- work around [[phab:T303378]]
-- for each arg: find all the templatestyles strip markers, insert them into a
-- table. then remove all templatestyles markers from the arg
local function move_hiding_templatestyles(args)
	local gfind = string.gfind
	local gsub = string.gsub
	local templatestyles_markers = {}
	local strip_marker_pattern = '(\127[^\127]*UNIQ%-%-templatestyles%-%x+%-QINU[^\127]*\127)'
	for k, arg in pairs(args) do
		for marker in gfind(arg, strip_marker_pattern) do
			table.insert(templatestyles_markers, marker)
		end
		args[k] = gsub(arg, strip_marker_pattern, '')
	end
	return templatestyles_markers
end

--[[
Main sidebar function. Takes the frame, args, and an optional collapsibleClass.
The collapsibleClass is and should be used only for sidebars with collapsible
lists, as in p.collapsible.
]]
function p.sidebar(frame, args, collapsibleClass)
	if not args then
		args = getArgs(frame)
	end
	local hiding_templatestyles = table.concat(move_hiding_templatestyles(args))
	local root = mw.html.create()
	args.child = args.child or args['вбудовування']
	local child = args.child and mw.text.trim(args.child) == cfg.i18n.child_yes

	root = root:tag('table')
	if not child then
		root 
			:addClass(cfg.i18n.class.sidebar)
			-- force collapsibleclass to be sidebar-collapse otherwise output nothing
			:addClass(collapsibleClass == cfg.i18n.class.collapse and cfg.i18n.class.collapse or nil)
			:addClass('nomobile')
			:addClass(args.float == cfg.i18n.float_none and cfg.i18n.class.float_none or nil)
			:addClass(args.float == cfg.i18n.float_left and cfg.i18n.class.float_left or nil)
			:addClass(args.wraplinks ~= cfg.i18n.wrap_true and cfg.i18n.class.wraplinks or nil)
			:addClass(args.bodyclass or args.class or args['клас_тіла'] or args['клас'])
			:css('width', args.width or args['ширина'] or nil)
			:cssText(args.bodystyle or args.style or args['стиль_тіла'] or args['стиль'])

		if args.outertitle or args['зовнішня_назва'] then
			root
				:tag('caption')
					:addClass(cfg.i18n.class.outer_title)
					:addClass(args.outertitleclass or args['клас_зовнішньої_назви'])
					:cssText(args.outertitlestyle or args['стиль_зовнішньої_назви'])
					:wikitext(args.outertitle or args['зовнішня_назва'])
		end

		if args.topimage or args['зображення_угорі'] then
			local imageCell = root:tag('tr'):tag('td')

			imageCell
				:addClass(cfg.i18n.class.top_image)
				:addClass(args.topimageclass or args['клас_зображення_угорі'])
				:cssText(args.topimagestyle or args['стиль_зображення_угорі'])
				:wikitext(args.topimage or args['зображення_угорі'])

			if args.topcaption or args['підпис_угорі'] then
				imageCell
					:tag('div')
						:addClass(cfg.i18n.class.top_caption)
						:cssText(args.topcaptionstyle or args['стиль_підпису_угорі'])
						:wikitext(args.topcaption or args['підпис_угорі'])
			end
		end

		if args.pretitle or args['передназва'] then
			root
				:tag('tr')
					:tag('td')
						:addClass((args.topimage or args['зображення_угорі']) and cfg.i18n.class.pretitle_with_top_image
							or cfg.i18n.class.pretitle)
						:addClass(args.pretitleclass or args['клас_передназви'])
						:cssText(args.basestyle or args['основний_стиль'])
						:cssText(args.pretitlestyle or args['стиль_передназви'])
						:wikitext(args.pretitle or args['передназва'])
		end
	else
		root
			:addClass(cfg.i18n.class.subgroup)
			:addClass(args.bodyclass or args.class or args['клас_тіла'] or args['клас'])
			:cssText(args.bodystyle or args.style or args['стиль_тіла'] or args['стиль'])
	end

	if args.title or args['назва'] then
		if child then
			root
				:wikitext(args.title or args['назва'])
		else
			root
				:tag('tr')
					:tag('th')
						:addClass((args.pretitle or args['передназва']) and cfg.i18n.class.title_with_pretitle
							or cfg.i18n.class.title)
						:addClass(args.titleclass or args['клас_назви'])
						:cssText(args.basestyle or args['основний_стиль'])
						:cssText(args.titlestyle or args['стиль_назви'])
						:wikitext(args.title or args['назва'])
		end
	end

	if args.image or args['зображення'] then
		local imageCell = root:tag('tr'):tag('td')

		imageCell
			:addClass(cfg.i18n.class.image)
			:addClass(args.imageclass or args['клас_зображення'])
			:cssText(args.imagestyle or args['стиль_зображення'])
			:wikitext(args.image or args['зображення'])

		if args.caption or args['підпис'] then
			imageCell
				:tag('div')
					:addClass(cfg.i18n.class.caption)
					:cssText(args.captionstyle or args['стиль_підпису'])
					:wikitext(args.caption or args['підпис'])
		end
	end

	if args.above or args['угорі'] then
		root
			:tag('tr')
				:tag('td')
					:addClass(cfg.i18n.class.above)
					:addClass(args.aboveclass or args['клас_угорі'])
					:cssText(args.abovestyle or args['стиль_угорі'])
					:newline() -- newline required for bullet-points to work
					:wikitext(args.above or args['угорі'])
	end

	local rowNums = {}
	for k, v in pairs(args) do
		k = '' .. k
		local num = k:match('^heading(%d+)$') or mw.ustring.match(k, '^заголовок(%d+)$') or k:match('^content(%d+)$') or mw.ustring.match(k, '^вміст(%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] or args['заголовок' .. num]
		if heading then
			root
				:tag('tr')
					:tag('th')
						:addClass(cfg.i18n.class.heading)
						:addClass(args.headingclass or args['клас_заголовків'])
						:addClass(args['heading' .. num .. 'class'] or args['клас_заголовоку' .. num])
						:cssText(args.basestyle or args['основний_стиль'])
						:cssText(args.headingstyle or args['стиль_заголовків'])
						:cssText(args['heading' .. num .. 'style'] or args['стиль_заголовку' .. num])
						:newline()
						:wikitext(heading)
		end

		local content = args['content' .. num] or args['вміст' .. num]
		if content then
			root
				:tag('tr')
					:tag('td')
						:addClass(hasSubgroup(content) and cfg.i18n.class.content_with_subgroup
							or cfg.i18n.class.content)
						:addClass(args.contentclass or args['клас_вмісту'])
						:addClass(args['content' .. num .. 'class'] or args['клас_вмісту' .. num])
						:cssText(args.contentstyle or args['стиль_вмісту'])
						:cssText(args['content' .. num .. 'style'] or args['стиль_вмісту' .. num])
						:newline()
						:wikitext(content)
						:done()
					 -- Without a linebreak after the </td>, a nested list like
					 -- "* {{hlist| ...}}" doesn't parse correctly.
					:newline()
		end
	end

	if args.below or args['внизу'] then
		root
			:tag('tr')
				:tag('td')
					:addClass(cfg.i18n.class.below)
					:addClass(args.belowclass or args['клас_внизу'])
					:cssText(args.belowstyle or args['стиль_внизу'])
					:newline()
					:wikitext(args.below or args['внизу'])
	end

	if not child and has_navbar(args.navbar or args['навпан'], args.name or args['ім\'я']) then
		root
			:tag('tr')
				:tag('td')
					:addClass(cfg.i18n.class.navbar)
					:cssText(args.navbarstyle or args['стиль_навпан'])
					:wikitext(require('Модуль:Navbar')._navbar{
						args.name or args['ім\'я'],
						mini = 1,
						fontstyle = args.navbarfontstyle or args['стиль_шрифту_навпан']
					})
	end
	
	local base_templatestyles = frame:extensionTag{
		name = 'templatestyles', args = { src = cfg.i18n.templatestyles }
	}
	
	local templatestyles = ''
	args['templatestyles'] = args['templatestyles'] or args['стилі_шаблону']
	if args['templatestyles'] and args['templatestyles'] ~= '' then
		templatestyles = frame:extensionTag{
			name = 'templatestyles', args = { src = args['templatestyles'] }
		}
	end
	
	local child_templatestyles = ''
	args['child templatestyles'] = args['child templatestyles'] or args['стилі_шаблону вбудовування']
	if args['child templatestyles'] and args['child templatestyles'] ~= '' then
		child_templatestyles = frame:extensionTag{
			name = 'templatestyles', args = { src = args['child templatestyles'] }
		}
	end
	
	local grandchild_templatestyles = ''
	args['grandchild templatestyles'] = args['grandchild templatestyles'] or args['стилі_шаблону вторинного_вбудовування']
	if args['grandchild templatestyles'] and args['grandchild templatestyles'] ~= '' then
		grandchild_templatestyles = frame:extensionTag{
			name = 'templatestyles', args = { src = args['grandchild templatestyles'] }
		}
	end

	return table.concat({
		add_list_styles(args), -- see [hlist_note] above about ordering
		base_templatestyles,
		templatestyles,
		child_templatestyles,
		grandchild_templatestyles,
		hiding_templatestyles,
		tostring(root),
		(child and cfg.i18n.category.child or ''),
		categorizeTemplatesWithInlineStyles(args)
	})
end

local function list_title(args, is_centered_list_titles, num)
	
	local title_text = trimAndAddAutomaticNewline(args['list' .. num .. 'title'] or args['назва_списку' .. num]
		or cfg.i18n.default_list_title)

	local title
	if is_centered_list_titles then
		-- collapsible can be finicky, so provide some CSS/HTML to support
		title = mw.html.create('div')
			:addClass(cfg.i18n.class.list_title_centered)
			:wikitext(title_text)
	else
		title = mw.html.create()
			:wikitext(title_text)
	end
		
	local title_container = mw.html.create('div')
		:addClass(cfg.i18n.class.list_title)
		-- don't /need/ a listnumtitleclass because you can do
		-- .templateclass .listnumclass .sidebar-list-title
		:addClass(args.listtitleclass or args['клас_назви_списку'])
		:cssText(args.basestyle or args['основний_стиль'])
		:cssText(args.listtitlestyle or args['стиль_назви_списку'])
		:cssText('color: var(--color-base)')
		:cssText(args['list' .. num .. 'titlestyle'] or args['стиль_назви_списку' .. num])
		:node(title)
		:done()
	
	return title_container
end

--[[
Main entry point for sidebar with collapsible lists.
Does the work of creating the collapsible lists themselves and including them
into the args.
]]
function p.collapsible(frame)
	local args = getArgs(frame)
	if not (args.name or args['ім\'я']) and
		frame:getParent():getTitle():gsub(cfg.i18n.pattern.collapse_sandbox, '') ==
		cfg.i18n.collapse_title_not_to_add_navbar then
		args.navbar = cfg.i18n.navbar_none
	end

	local contentArgs = {}
	
	args['centered list titles'] = args['centered list titles'] or args['відцентровані назви списків']
	
	local is_centered_list_titles = false
	if args['centered list titles'] and args['centered list titles'] ~= '' then
		is_centered_list_titles = true
	end

	for k, v in pairs(args) do
		local num = string.match(k, '^list(%d+)$') or mw.ustring.match(k, '^список(%d+)$')
		if num then
			args.expanded = args.expanded or args['розгорнуто']
			local expand = args.expanded and
				(args.expanded == 'all' or args.expanded == 'всі' or args.expanded == args['list' .. num .. 'name'] or args.expanded == args['ім\'я_списку' .. num ] )
				
			local row = mw.html.create('div')
			row
				:addClass(cfg.i18n.class.list)
				:addClass('mw-collapsible')
				:addClass((not expand) and 'mw-collapsed' or nil)
				:addClass(args['list' .. num .. 'class'] or args['клас_списку' .. num])
				:cssText(args.listframestyle or args['стиль_рамки_списків' .. num])
				:cssText(args['list' .. num .. 'framestyle'] or args['стиль_рамки_списку' .. num])
				:node(list_title(args, is_centered_list_titles, num))
				:tag('div')
					:addClass(cfg.i18n.class.list_content)
					:addClass('mw-collapsible-content')
					-- don't /need/ a listnumstyleclass because you can do
					-- .templatename .listnumclass .sidebar-list
					:addClass(args.listclass or args['клас_списку'])
					:cssText(args.liststyle or args['стиль_списку'])
					:cssText(args['list' .. num .. 'style'] or args['стиль_cписку' .. num])
					:wikitext(trimAndAddAutomaticNewline(args['list' .. num] or args['список' .. num]))

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

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

	return p.sidebar(frame, args, cfg.i18n.class.collapse)
end

return p