Módulo:List
Ir a la navegación
Ir a la búsqueda
Plantilla:Module rating Este módulo genera varios tipos de listas. Actualmente admite listas con viñetas, listas sin viñetas, listas horizontales, listas ordenadas (numeradas o alfabéticas) y listas ordenadas horizontales. Permite un estilo css fácil de la lista o de los elementos de la lista individuales.
Uso
- Uso rápido
{{#invoke:list|function|first item|second item|third item|...}}
- Todos los parámetros
{{#invoke:list|function |first item|second item|third item|... |start = start number for ordered lists |type = type of numbering for ordered lists |list_style_type = type of marker for ordered lists (uses CSS) |class = class |style = style |list_style = style for the list |item_style = style for all list items |item1_style = style for the first list item |item2_style = style for the second list item |... |item1_value = value for the first list item |item2_value = value for the second list item |... |indent = indent for horizontal lists }}
- Argumentos pasados desde la plantilla principal
{{#invoke:list|function}}
- Funciones
Nombre de la función | Produce | Ejemplo | Plantilla usada |
---|---|---|---|
bulleted
|
Bulleted lists |
|
{{bulleted list}}
|
unbulleted
|
Unbulleted lists |
|
{{unbulleted list}}
|
horizontal
|
Horizontal bulleted lists |
|
{{hlist}}
|
ordered
|
Ordered lists (numbered lists and alphabetical lists) |
|
{{ordered list}}
|
horizontal_ordered
|
Horizontal ordered lists |
|
Parámetros
- Párametros posicionales (
1
,2
,3
...): Estos son el elementos de la lista. Si no hay elementos de lista presentes, el módulo no generará nada. start
: Establece el elemento de inicio para las listas ordenadas. Puede ser un número inicial para listas numeradas o una letra inicial para listas alfabéticas. Las listas ordenadas en horizontal solo admiten números.type
: El tipo de marcador utilizado en las listas ordenadas. Los valores posibles son "1" para números (por defecto), "A" para letras mayúsculas, "a" para letras minúsculas, "I" para números romanos en mayúsculas y "i" para números romanos en minúsculas. No se admiten en listas ordenadas horizontales. Véase también el parámetrolist_style_type
.list_style_type
: El tipo de marcador utilizado en las listas ordenadas. Esto usa estilo CSS y tiene más tipos disponibles que el parámetrotype
, que usa un atributo html. Los valores disponibles se encuentran en la página de MDN list-style-type. El soporte puede variar según el navegador.list-style-type
es un alias para el parámetro.class
: Una clase personalizada para las etiquetas<div>...</div>
que rodean la lista, por ejemplo,plainlinks
.style
: Un estilo css personalizado para las etiquetas<div>...</div>
que rodean la lista, por ejemplo,font-size: 90%;
.list_style
: Un estilo css personalizado para la lista en sí. El formato es el mismo que para el parámetro|style=
.item_style
: Un estilo css personalziado para todos los elementos de la lista (las etiquetas<li>...</li>
). El formato es el mismo que para el parámetro|style=
.item1_style
,item2_style
,item3_style
...: Estilos css personalizados para cada uno de los elementos de la lista. El formato es el mismo que para el parámetro|style=
.item1_value
,item2_value
,item3_value
...: Valor personalizado para el elemento dado de lista. Los elementos de la lista que siguen al dado se incrementarán a partir del valor especificado. El avlor debe ser un entero positivo. (En en cuenta que esta opción solo tiene efecto en las listas ordenadas.)indent
: Este parámetro sangra la lista, solo para listas horizontales y ordenadas horizontalmente. El valor debe ser un número, por ejemplo,2
. La sangría se calcula en em y es 1.6 veces el valor especificado. Si no se especifica ninguna sangría, el valor predeterminado es cero.
Ejemplos
- Listas con viñetas
Código | Resultado |
---|---|
{{#invoke:list|bulleted|First item|Second item|Third item}}
|
|
{{#invoke:list|bulleted|First item|Second item|Third item|item_style=color:blue;}}
|
|
{{#invoke:list|bulleted|First item|Second item|Third item|item1_style=background-color:yellow;|item2_style=background-color:silver;}}
|
|
- Listas sin viñetas
Código | Resultado |
---|---|
{{#invoke:list|unbulleted|First item|Second item|Third item}}
|
|
{{#invoke:list|unbulleted|First item|Second item|Third item|item_style=color:blue;}}
|
|
{{#invoke:list|unbulleted|First item|Second item|Third item|item1_style=background-color:yellow;|item2_style=background-color:silver;}}
|
|
- Listas horizontales
Código | Resultado |
---|---|
{{#invoke:list|horizontal|First item|Second item|Third item}}
|
|
{{#invoke:list|horizontal|First item|Second item|Third item|indent=2}}
|
|
- Listas ordenadas
Código | Resultado |
---|---|
{{#invoke:list|ordered|First item|Second item|Third item}}
|
|
{{#invoke:list|ordered|First item|Second item|Third item|start=3}}
|
|
{{#invoke:list|ordered|First item|Second item|Third item|type=i}
|
|
{{#invoke:list|ordered|First item|Second item|Third item|list_style_type=lower-greek}}
|
|
- Listas horizontales ordenadas
Código | Resultado |
---|---|
{{#invoke:list|horizontal_ordered|First item|Second item|Third item}}
|
|
{{#invoke:list|horizontal_ordered|First item|Second item|Third item|start=3}}
|
|
{{#invoke:list|horizontal_ordered|First item|Second item|Third item|indent=2}}
|
|
Véase también
- Módulo:Separated entries
-- 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 listTypes = {
['bulleted'] = true,
['unbulleted'] = true,
['horizontal'] = true,
['ordered'] = true,
['horizontal_ordered'] = true
}
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 hlist-separated')
elseif listType == 'unbulleted' then
table.insert(data.classes, 'plainlist')
end
table.insert(data.classes, args.class)
-- Main div style
data.style = args.style
-- Indent for horizontal lists
if listType == 'horizontal' or listType == 'horizontal_ordered' then
local indent = tonumber(args.indent)
indent = indent and indent * 1.6 or 0
if indent > 0 then
data.marginLeft = indent .. 'em'
end
end
-- List style types for ordered lists
-- 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
-- list-style-type CSS properties.
if data.type
and not data.listStyleType
and not tostring(data.type):find('^%s*[1AaIi]%s*$')
then
data.listStyleType = data.type
data.type = nil
end
end
-- List tag type
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
-- List style
-- 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
-- li_style is included for backwards compatibility. item_style was included
-- 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.
-- Return the blank string if there are no list items.
if type(data.items) ~= 'table' or #data.items < 1 then
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')
list
:attr{start = data.start, type = data.type}
:css{
['counter-reset'] = data.counterReset,
['list-style-type'] = data.listStyleType
}
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
if t.style then
item:cssText(t.style)
end
item
:attr{value = t.value}
:wikitext(t.content)
end
return tostring(root)
end
function p.renderTrackingCategories(args)
local isDeprecated = false -- Tracks deprecated parameters.
for k, v in pairs(args) do
k = tostring(k)
if k:find('^item_style%d+$') or k:find('^item_value%d+$') then
isDeprecated = true
break
end
end
local ret = ''
if isDeprecated then
ret = ret .. '[[Category:List templates with deprecated parameters]]'
end
return ret
end
function p.makeList(listType, args)
if not listType or not listTypes[listType] then
error(string.format(
"bad argument #1 to 'makeList' ('%s' is not a valid list type)",
tostring(listType)
), 2)
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
p[listType] = function (frame)
local mArguments = require('Module:Arguments')
local origArgs = mArguments.getArgs(frame)
-- Copy all the arguments to a new table, for faster indexing.
local args = {}
for k, v in pairs(origArgs) do
args[k] = v
end
return p.makeList(listType, args)
end
end
return p