Модуль:Список: различия между версиями

Материал из in.wiki
Перейти к навигации Перейти к поиску
м (Изменил уровень защиты Модуль:List: критический шаблон или модуль: более 5000 включений + используется на заглавной странице ([Редактирование=только администраторы] (бессрочно) [Переименование=только администраторы] (бессрочно)))
 
(export multiline)
Строка 1: Строка 1:
-- This module outputs different kinds of lists. At the moment, bulleted,
 
-- unbulleted, horizontal, ordered, and horizontal ordered lists are supported.
 
 
local libUtil = require('libraryUtil')
 
local checkType = libUtil.checkType
 
local mTableTools = require('Module:TableTools')
 
 
 
local p = {}
 
local p = {}
  
local listTypes = {
+
local function get_args (frame)
['bulleted'] = true,
+
-- На случай вызова из шаблона и из модуля:
['unbulleted'] = true,
+
local args = frame:getParent () and mw.clone (frame:getParent ().args) or {}
['horizontal'] = true,
+
-- Overrides:
['ordered'] = true,
+
for key, val in pairs (frame.args) do
['horizontal_ordered'] = true
+
args [key] = val
}
 
 
 
function p.makeListData(listType, args)
 
-- Constructs a data table to be passed to p.renderList.
 
local data = {}
 
 
 
-- Classes
 
data.classes = {}
 
if listType == 'horizontal' or listType == 'horizontal_ordered' then
 
table.insert(data.classes, 'hlist')
 
elseif listType == 'unbulleted' then
 
table.insert(data.classes, 'plainlist')
 
 
end
 
end
table.insert(data.classes, args.class)
+
return args
 +
end -- local function get_args (frame)
  
-- Main div style
+
local function remove_empty (list)
data.style = args.style
+
local ret = {}
 
+
for i, item in ipairs (list) do
-- Indent for horizontal lists
+
if item ~= '' then
if listType == 'horizontal' or listType == 'horizontal_ordered' then
+
ret [#ret + 1] = item
local indent = tonumber(args.indent)
 
indent = indent and indent * 1.6 or 0
 
if indent > 0 then
 
data.marginLeft = indent .. 'em'
 
 
end
 
end
 
end
 
end
+
return ret
-- List style types for ordered lists
+
end -- local function remove_empty (list)
-- This could be "1, 2, 3", "a, b, c", or a number of others. The list style
 
-- type is either set by the "type" attribute or the "list-style-type" CSS
 
-- property.
 
if listType == 'ordered' or listType == 'horizontal_ordered' then
 
data.listStyleType = args.list_style_type or args['list-style-type']
 
data.type = args['type']
 
  
-- Detect invalid type attributes and attempt to convert them to
+
local function multiline (list, mark, header)
-- list-style-type CSS properties.
+
local ret = ''
if data.type
+
for _, item in ipairs (list) do
and not data.listStyleType
+
ret = ret .. '\n' .. mark .. ' ' .. tostring (item)
and not tostring(data.type):find('^%s*[1AaIi]%s*$')
 
then
 
data.listStyleType = data.type
 
data.type = nil
 
end
 
 
end
 
end
+
if ret ~= '' and header then
-- List tag type
+
ret = header .. ret
if listType == 'ordered' or listType == 'horizontal_ordered' then
 
data.listTag = 'ol'
 
else
 
data.listTag = 'ul'
 
end
 
 
 
-- Start number for ordered lists
 
data.start = args.start
 
if listType == 'horizontal_ordered' then
 
-- Apply fix to get start numbers working with horizontal ordered lists.
 
local startNum = tonumber(data.start)
 
if startNum then
 
data.counterReset = 'listitem ' .. tostring(startNum - 1)
 
end
 
 
end
 
end
 +
return ret
 +
end -- local function multiline (list, mark, header)
  
-- List style
+
p.multiline = multiline
-- ul_style and ol_style are included for backwards compatibility. No
 
-- distinction is made for ordered or unordered lists.
 
data.listStyle = args.list_style
 
  
-- List items
+
function p.l (frame)
-- li_style is included for backwards compatibility. item_style was included
+
local args = get_args (frame)
-- to be easier to understand for non-coders.
 
data.itemStyle = args.item_style or args.li_style
 
data.items = {}
 
for i, num in ipairs(mTableTools.numKeys(args)) do
 
local item = {}
 
item.content = args[num]
 
item.style = args['item' .. tostring(num) .. '_style']
 
or args['item_style' .. tostring(num)]
 
item.value = args['item' .. tostring(num) .. '_value']
 
or args['item_value' .. tostring(num)]
 
table.insert(data.items, item)
 
end
 
 
return data
 
end
 
  
function p.renderList(data)
+
-- Извлекаем параметры — не пункты списка:
-- Renders the list HTML.
+
local header = args ['заголовок']
+
local separator = args ['разделитель']
-- Return the blank string if there are no list items.
+
-- Для явно заданного разделителя, вроде «•», «и» не нужно:
if type(data.items) ~= 'table' or #data.items < 1 then
+
local last = separator or args ['последний']
return ''
 
end
 
 
-- Render the main div tag.
 
local root = mw.html.create('div')
 
for i, class in ipairs(data.classes or {}) do
 
root:addClass(class)
 
end
 
root:css{['margin-left'] = data.marginLeft}
 
if data.style then
 
root:cssText(data.style)
 
end
 
  
-- Render the list tag.
+
-- Случай многострочного списка:
local list = root:tag(data.listTag or 'ul')
+
if separator == '*' or separator == '#' then
list
+
return multiline (remove_empty (args), separator, header)
:attr{start = data.start, type = data.type}
+
else
:css{
+
local ret = mw.text.listToText (remove_empty (args), separator, last)
['counter-reset'] = data.counterReset,
+
if ret ~= '' and header then
['list-style-type'] = data.listStyleType
+
ret = header .. ' ' .. ret
}
 
if data.listStyle then
 
list:cssText(data.listStyle)
 
end
 
 
 
-- Render the list items
 
for i, t in ipairs(data.items or {}) do
 
local item = list:tag('li')
 
if data.itemStyle then
 
item:cssText(data.itemStyle)
 
 
end
 
end
if t.style then
+
return ret
item:cssText(t.style)
 
end
 
item
 
:attr{value = t.value}
 
:wikitext(t.content)
 
 
end
 
end
 +
end -- function p.l (frame)
  
return tostring(root)
+
function p.bl (frame)
end
+
local args = get_args (frame)
 +
-- Общий маркёр:
 +
local bullet = args ['маркёр'] or args ['bullet'] or '{{*}}'
  
function p.renderTrackingCategories(args)
+
local lines = {}
local isDeprecated = false -- Tracks deprecated parameters.
+
for i = 1, #args, 2 do
for k, v in pairs(args) do
+
lines [#lines + 1] = {bullet = args [i] or bullet, str = args [i + 1] or ''}
k = tostring(k)
 
if k:find('^item_style%d+$') or k:find('^item_value%d+$') then
 
isDeprecated = true
 
break
 
end
 
 
end
 
end
 
local ret = ''
 
local ret = ''
if isDeprecated then
+
if #lines > 0 then
ret = ret .. '[[Category:List templates with deprecated parameters]]'
+
ret = ret .. '<table style="background: transparent; vertical-align: top;">'
 +
for _, line in ipairs (lines) do
 +
ret = ret .. '\n<tr><td style="vertical-align:top; padding-top: 0.3ex">' .. line.bullet
 +
  .. '</td><td style="vertical-align:top">' .. line.str .. '</td></tr>'
 +
end
 +
ret = ret .. '\n</table>'
 
end
 
end
 
return ret
 
return ret
end
+
end -- function p.bl (frame)
  
function p.makeList(listType, args)
+
function p.ul (frame)
if not listType or not listTypes[listType] then
+
local args = get_args (frame)
error(string.format(
+
-- Извлекаем параметры — не пункты списка:
"bad argument #1 to 'makeList' ('%s' is not a valid list type)",
+
local header = args ['заголовок']
tostring(listType)
+
return multiline (remove_empty (args), '*', header)
), 2)
+
end -- function p.ul (frame)
end
 
checkType('makeList', 2, args, 'table')
 
local data = p.makeListData(listType, args)
 
local list = p.renderList(data)
 
local trackingCategories = p.renderTrackingCategories(args)
 
return list .. trackingCategories
 
end
 
  
for listType in pairs(listTypes) do
+
function p.ol (frame)
p[listType] = function (frame)
+
local args = get_args (frame)
local mArguments = require('Module:Arguments')
+
-- Извлекаем параметры — не пункты списка:
local origArgs = mArguments.getArgs(frame)
+
local header = args ['заголовок']
-- Copy all the arguments to a new table, for faster indexing.
+
return multiline (remove_empty (args), '#', header)
local args = {}
+
end -- function p.ol (frame)
for k, v in pairs(origArgs) do
 
args[k] = v
 
end
 
return p.makeList(listType, args)
 
end
 
end
 
  
 
return p
 
return p

Версия от 05:36, 12 декабря 2019

Для документации этого модуля может быть создана страница Модуль:Список/doc

local p = {}

local function get_args (frame)
	-- На случай вызова из шаблона и из модуля:
	local args = frame:getParent () and mw.clone (frame:getParent ().args) or {}
	-- Overrides:
	for key, val in pairs (frame.args) do
		args [key] = val
	end
	return args
end		-- local function get_args (frame)

local function remove_empty (list)
	local ret = {}
	for i, item in ipairs (list) do
		if item ~= '' then
			ret [#ret + 1] = item
		end
	end
	return ret
end		-- local function remove_empty (list)

local function multiline (list, mark, header)
	local ret = ''
	for _, item in ipairs (list) do
		ret = ret .. '\n' .. mark .. ' ' .. tostring (item)
	end
	if ret ~= '' and header then
		ret = header .. ret
	end
	return ret
end		-- local function multiline (list, mark, header)

p.multiline = multiline

function p.l (frame)
	local args = get_args (frame)

	-- Извлекаем параметры — не пункты списка:
	local header = args ['заголовок']
	local separator = args ['разделитель']
	-- Для явно заданного разделителя, вроде «•», «и» не нужно:
	local last = separator or args ['последний']

	-- Случай многострочного списка:
	if separator == '*' or separator == '#' then
		return multiline (remove_empty (args), separator, header)
	else
		local ret = mw.text.listToText (remove_empty (args), separator, last)
		if ret ~= '' and header then
			ret = header .. ' ' .. ret
		end
		return ret
	end
end		-- function p.l (frame)

function p.bl (frame)
	local args = get_args (frame)
	-- Общий маркёр:
	local bullet = args ['маркёр'] or args ['bullet'] or '{{*}}'

	local lines = {}
	for i = 1, #args, 2 do
		lines [#lines + 1] = {bullet = args [i] or bullet, str = args [i + 1] or ''}
	end
	local ret = ''
	if #lines > 0 then
		ret = ret .. '<table style="background: transparent; vertical-align: top;">'
		for _, line in ipairs (lines) do
			ret = ret .. '\n<tr><td style="vertical-align:top; padding-top: 0.3ex">' .. line.bullet
					  .. '</td><td style="vertical-align:top">' .. line.str .. '</td></tr>'
		end
		ret = ret .. '\n</table>'
	end
	return ret
end		-- function p.bl (frame)

function p.ul (frame)
	local args = get_args (frame)
	-- Извлекаем параметры — не пункты списка:
	local header = args ['заголовок']
	return multiline (remove_empty (args), '*', header)
end	-- function p.ul (frame)

function p.ol (frame)
	local args = get_args (frame)
	-- Извлекаем параметры — не пункты списка:
	local header = args ['заголовок']
	return multiline (remove_empty (args), '#', header)
end	-- function p.ol (frame)

return p