Modul:Navbox/pískoviště

Dokumentaci tohoto modulu lze vytvořit na stránce Modul:Navbox/pískoviště/Dokumentace

--
-- Tento modul implementuje {{Navbox}}
--
require 'strict'

local keywords = {
	name				= 'název',
	child				= 'child',
	bodystyle			= 'styl těla',
	bodyclass			= 'třída těla',
	title				= 'titulek',
	titlestyle			= 'styl titulku',
	titleclass			= 'třída titulku',
	above				= 'záhlaví',
	abovestyle			= 'styl záhlaví',
	aboveclass			= 'třída záhlaví',
	image				= 'obrázek',
	imagestyle			= 'styl obrázku',
	imageleft			= 'obrázek vlevo',
	imageleftstyle		= 'styl obrázku vlevo',
	imageclass			= 'třída obrázku',
	below				= 'zápatí',
	belowstyle			= 'styl zápatí',
	belowclass			= 'třída zápatí',
} -- here is what you want to translate

local p = {}

local navbar = require('Modul: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 getWithLocal(args, global)
	-- funkce zajišťujicí rovnocenné fungování jak lokálního, tak globálního názvu pro parametr
	if keywords[global] then
		return args[keywords[global]] or args[global]
	end
	return args[global]
end

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 = '[[Kategorie:Sirotčí podnavboxy]]'
	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

--
--   Navbar
--
-- [[Modul:Navbar]] není doladěn. tato část kódu je tedy momentálně nefunkční. 
-- Poznámka: tato část kódu zprostředkovává zobrazení klikacího mini-menu typu V*T*E (View*Talk*Edit) na úvodním řádku navboxu.
--
-- local function renderNavBar(titleCell)
--
-- if args.navbar ~= 'off' and args.navbar ~= 'plain' and not (not args.name and mw.getCurrentFrame():getParent():getTitle():gsub('/sandbox$', '') == 'Template:Navbox') then
--		titleCell:wikitext(navbar{
--			args.name,
--			mini = 1,
--			fontstyle = (args.basestyle or '') .. ';' .. (args.titlestyle or '') .. ';background:none transparent;border:none;-moz-box-shadow:none;-webkit-box-shadow:none;box-shadow:none;'
--		})
--	end
--
-- end

--
--   Title row / Řádek titulku
--
local function renderTitleRow(tbl)
	if not getWithLocal(args, 'title') then return end

	local titleRow = tbl:tag('tr')

	if args.titlegroup then
		titleRow
			:tag('th')
				:attr('scope', 'row')
				:addClass('navbox2-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
			:css('border-left', '2px solid #fdfdfd')
			:css('width', '100%')
	end

	local titleColspan = 2
	if getWithLocal(args, 'imageleft') then titleColspan = titleColspan + 1 end
	if getWithLocal(args, 'image') then titleColspan = titleColspan + 1 end
	if args.titlegroup then titleColspan = titleColspan - 1 end

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

	-- renderNavBar(titleCell)

	titleCell
		:tag('div')
			-- id for aria-labelledby attribute
			:attr('id', mw.uri.anchorEncode(getWithLocal(args, 'name')))
			:addClass(getWithLocal(args, 'titleclass'))
			-- TODO: přesunout do CSS a nahradit třídou .navbox-titletext
			:css('font-size', '114%')
			:css('margin', '0 4em')
			:wikitext(processItem(getWithLocal(args, 'title')))
end

--
--   Above/Below rows / Řádky záhlaví a zápatí
--

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

local function renderAboveRow(tbl)
	if not getWithLocal(args, 'above') then return end

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

local function renderBelowRow(tbl)
	if not getWithLocal(args, 'below') then return end

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

--
--   List rows / Řádky seznamů
--
local function renderListRow(tbl, index, listnum)
	local row = tbl:tag('tr')

	if index == 1 and getWithLocal(args, 'imageleft') then
		row
			:tag('td')
				:addClass('navbox2-image')
				:addClass(getWithLocal(args, 'imageclass'))
				-- TODO: přesunout do CSS
				:css('width', '1px')               -- Minimize width
				:css('padding', '0px 2px 0px 0px')
				:cssText(getWithLocal(args, 'imageleftstyle'))
				:attr('rowspan', #listnums)
				:tag('div')
					:wikitext(processItem(getWithLocal(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 (getWithLocal(args, 'name') or getWithLocal(args, 'above') or args.group2) then
			groupCell
				:attr('id', mw.uri.anchorEncode(args.group1))
		end

		groupCell
			:attr('scope', 'row')
			:addClass('navbox2-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
			-- TODO: možná vytvořit CSS třídu
			:css('text-align', 'left')
			:css('border-left-width', '2px')
			:css('border-left-style', 'solid')
	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('navbox2-list')
		:addClass('navbox2-' .. oddEven)
		:addClass(args.listclass)
		: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 getWithLocal(args, 'image') then
		row
			:tag('td')
				:addClass('navbox2-image')
				:addClass(getWithLocal(args, 'imageclass'))
				-- TODO: přesunout do CSS
				:css('width', '1px')               -- Minimize width
				:css('padding', '0px 0px 0px 2px')
				:cssText(getWithLocal(args, 'imagestyle'))
				:attr('rowspan', #listnums)
				:tag('div')
					:wikitext(processItem(getWithLocal(args, 'image')))
	end
end


--
--   Tracking categories / Monitorovací kategorie
--

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[getWithLocal(args, 'bodyclass')])
end

local function hasBackgroundColors()
	for _, key in ipairs{'titlestyle', 'groupstyle', 'basestyle', 'abovestyle', 'belowstyle'} do
		if tostring(getWithLocal(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(getWithLocal(args, key)):find('border', 1, true) then
			return true
		end
	end
end

local function isIllegible()
	local styleratio = require('Modul:Color contrast')._styleratio

	for key, style in pairs(args) do
		if tostring(key):match("style$") then
			if styleratio{mw.text.unstripNoWiki(style)} < 4.5 then
				return true
			end
		end
	end
	return false
end

local function getTrackingCategories()
	local cats = {}
	if needsHorizontalLists() then table.insert(cats, 'Navboxy bez horizontálních seznamů') end
	if hasBackgroundColors() then table.insert(cats, 'Navboxy s vlastní barvou pozadí') end
	if isIllegible() then table.insert(cats, 'Navboxy s možným problémem s čitelností') end
	if hasBorders() then table.insert(cats, 'Navboxy používající ohraničení') 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 == 'pískoviště' or subpage == 'příklady' then return end

	for _, cat in ipairs(getTrackingCategories()) do
		builder:wikitext('[[Kategorie:Údržba:' .. cat .. ']]')
	end
end

--
--   Main navbox tables / Hlavní tabulky navboxu
--
local function renderMainTable()
	local tbl = mw.html.create('table')
		:addClass('nowraplinks')
		:addClass(getWithLocal(args, 'bodyclass'))
		:addClass('noprint')

	if getWithLocal(args, 'title') and (args.state ~= 'plain' and args.state ~= 'off') then
		tbl
			:addClass('mw-collapsible')
			:addClass(args.state or 'autocollapse')
			:attr('data-collapsetext', 'skrýt')
			:attr('data-expandtext', 'zobrazit')
	end

	-- TODO: přesunout do CSS
	tbl:css('border-spacing', 0)
	if border == 'subgroup' or border == 'none' then
		tbl
			:addClass('navbox2-subgroup')
			:cssText(getWithLocal(args, 'bodystyle'))
			:cssText(args.style)
	else  -- regular navbox - bodystyle and style will be applied to the wrapper table
		tbl
			:addClass('navbox2-inner')
			-- TODO: přesunout do CSS
			: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

	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' or border == 'vnořený' then
		border = 'subgroup'
	end

	-- render the main body of the navbox
	local tbl = renderMainTable()

	-- render the appropriate wrapper around the navbox, depending on the border param
	local res = mw.html.create()
	if border == 'none' then
		local nav = res:tag('div')
			:attr('role', 'navigation')
			:node(tbl)
		-- aria-labelledby name, otherwise above, otherwise lone group
		if getWithLocal(args, 'name') or getWithLocal(args, 'above') or (args.group1 and not args.group2) then
			nav:attr('aria-labelledby', mw.uri.anchorEncode(getWithLocal(args, 'name') or getWithLocal(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>')
			:node(tbl)
			:wikitext('<div>')
	else
		local nav = res:tag('div')
			:attr('role', 'navigation')
			:addClass('navbox2')
			:addClass('noprint')
			:cssText(getWithLocal(args, 'bodystyle'))
			:cssText(args.style)
			-- FIXME: konflikt s definicí .navbox2
			:css('padding', '2px')
			:node(tbl)
		-- aria-labelledby name, otherwise above, otherwise lone group
		if getWithLocal(args, 'name') or getWithLocal(args, 'above') or (args.group1 and not args.group2) then
			nav:attr('aria-labelledby', mw.uri.anchorEncode(getWithLocal(args, 'name') or getWithLocal(args, 'above') or args.group1))
		else
			nav:attr('aria-label', 'Navbox')
		end
	end

	renderTrackingCategories(res)

	return striped(tostring(res))
end

function p.navbox(frame)
	if not getArgs then
		getArgs = require('Modul:Arguments').getArgs
	end
	args = getArgs(frame, { wrappers = {
		'Šablona:Navbox', 'Šablona:Navbox/pískoviště', 'Šablona:Navbox subgroup', 'Šablona:Test',
	} })
	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 _
	_ = getWithLocal(args, 'title')
	_ = getWithLocal(args, 'above')
	for i = 1, 20 do
		_ = args["group" .. tostring(i)]
		_ = args["list" .. tostring(i)]
	end
	_ = getWithLocal(args, 'below')

	return p._navbox(args)
end

return p