IdleTap-bot：导入自求闻百科

2026-08-03T08:08:01Z

导入自求闻百科

新页面

{{NoteTA|G1=MediaWiki}}
{{notice|本模块及其文档搬运自[https://rs.miraheze.org/wiki/Module:List 其他网站]，经作者授权，按CC-BY-SA 4.0的协议发布。}}
本模块可以输出各种类型的列表。目前，它支持带点的无序列表、不带点的无序列表、水平列表、有序列表（数字的或字母的）、水平有序列表、直接连接列表和用自然语言连成的列表。它允许对各个列表项目进行单独的css样式。

== 用法==

=== 快速使用 ===

{{tlx|#invoke:list|''函数''|''第一项''|''第二项''|''第三项''|…}}

=== 所有参数 ===
; 位次参数
: 列表的内容
; start
: 有序列表的开始数字
; type
: 有序列表的标序类别
; liststyletype或list-style-type
: 有序列表标记的类型（使用CSS）
; class
: 类
; style
: 样式
; liststyle
: 列表的样式
; itemstyle
: 列表项的样式
; item1style、item2style、item3style
: 第1项的样式、第2项的样式、第3项的样式
; item1value、item2value、item3value
: 第1项的值、第2项的值、第3项的值
; indent
: 水平列表的缩进
; arguments
: 指定参数的来源
; modification
: 指定一个模块对各项进行修改
; function
: 将模块作为一个表，指定其内函数进行修改
; call
: 对每个参数调用一个模板，其模板名称即为这个值
; content_as
: 调用模板时，将列表项的原始内容作为值，其对应的键即为这个content_as的值（可以是数字或字符串），默认为1
; para_参数名称
: 调用模板时的参数
; replacement
: 列表的每一项为将这个值中的%s替换为原始内容之后的值
; prefix
: 列表每一项的前缀
; suffix
: 列表每一项的后缀
; trim
: 是否移除各参数的两侧空格并忽略空白参数。

=== 从上级模板传递下来的参数 ===
{{tlx|#invoke:list|''函数''}}

=== 函数 ===

{| class="wikitable"
|-
! 函数名称
! 产生
! 示例输出
|-
| <code>bulleted</code>
| 带点的无序列表
| {{#invoke:list|bulleted|第一项|第二项|第三项}}
|-
| <code>unbulleted</code>
| 不带点的无序列表
| {{#invoke:list|unbulleted|第一项|第二项|第三项}}
|-
| <code>horizontal</code>
| 水平无序列表
| {{#invoke:list|horizontal|第一项|第二项|第三项}}
|-
| <code>ordered</code>
| 有序列表（数字标识和字母标识）
| {{#invoke:list|ordered|第一项|第二项|第三项}}
|-
| <code>horizontal_ordered</code>
| 水平有序列表
| {{#invoke:list|horizontal_ordered|第一项|第二项|第三项}}
|-
| <code>concat</code>
| 直接连接（本站特有）
| {{#invoke:list|concat|第一项|第二项|第三项}}
|-
| <code>list_to_text</code>
| 使用自然语言连接（本站特有）
| {{#invoke:list|list_to_text|第一项|第二项|第三项}}
|}

== 参数 ==

=== 基本参数 ===

* 位次参数（positional parameters）（<code>1</code>、<code>2</code>、<code>3</code>……）——这些是列表项。如果没有列表项，模块不输出任何值。
* <code>start</code>——设置有序列表的开始。可以是数字序列列表的开始数字，也可以是字母列表的开始字母。水平有序列表只支持数字。
* <code>type</code>——有序列表使用的标识类别。比如，数字“1”（默认）、大写字母“A”、小写字母“a”、大写[[希腊字母]]“I”、小写希腊字母“i”。水平有序列表不支持。参考<code>liststyletype</code>参数。
* <code>liststyletype</code>或<code>list-style-type</code>——有序列表标识的类别，使用CSS样式，并且使用html标记比<code>type</code>参数拥有更多的可行类型。可用的值都列举在[https://developer.mozilla.org/zh-CN/docs/Web/CSS/list-style-type MDN的list-style-type页面]。不同浏览器可能支持性不同。
* <code>class</code>——列表标签的自定义类。本模块不使用div标签。
* <code>style</code>——列表标签的自定义css样式，例如，<code>font-size: 90%;</code>。
* <code>liststyle</code>——同<code>style</code>参数。
* <code>itemstyle</code>——对于所有列表项的自动css样式。格式同<code>style</code>参数。
* <code>item1style</code>、<code>item2style</code>、<code>item3style</code>……——为每个列表项的自定义css样式。格式同<code>style</code>参数。
* <code>item1value</code>、<code>item2value</code>、<code>item3value</code>……对给定列表项的自定义值。给定一个，后面的值会从这个指定的值开始增加。这个值应该是正整数。（仅对有序列表有效。）
* <code>indent</code>——缩进列表，仅适用于水平列表和水平有序列表。值必须是一个数字，比如<code>2</code>。缩进成倍计算，是指定值的1.6倍。未指定时为零。
* <code>arguments</code>——参数的来源。<code>self</code>表示只接受通过#invoke调用模块时的参数，<code>parent</code>表示使用调用了此模块的模板时传入的参数，<code>template</code>表示位次参数视为parent，赋名参数为self，<code>both</code>表示同时考虑二者，且parent优先。默认为<code>both</code>。
* <code>separation</code>或<code>sep</code>——在类型为code或list_to_text时，将各项连接起来。
* <code>conjunction</code>或<code>conj</code>——在类型为list_to_text时，最后一项与倒数第二项的连接。

=== 修改列表各项内容 ===

本模块支持对列表各项内容进行统一的修改。共有以下几种修改方法。注意以下这些修改方法只能选择一种，或者全都不选。

为了表述方便，我们将模板参数中输入的每一项内容称为'''原始内容'''，修改后的每一项的内容称为'''修改后内容'''，这个用于修改的函数（如有）称为'''修改函数'''。

==== 调用模块 ====

可以对每一项调用特定的模块进行修改。其参数用法为：

* <code>modification</code> = 要调用的模块的页面名称。当这个页面不存在时无效。当这个页面未指定而<code>function</code>指定了时，这个模块名称默认为[[Module:List/preset functions]]
* <code>function</code> = 要调用的模块中的函数名称。如果这个值指定了，则将整个模块作为一个表，取其相应的域作为修改函数。如果这个值没有指定，则将整个模块作为修改函数。

比如，如果<code>modification</code>=Module:a，而<code>function</code>是b，则这个修改函数（记为modify）可以理解为：
<syntaxhighlight lang=lua>modify = require 'Module:a'.b</syntaxhighlight>

如果<code>modification</code>=Module:a，而<code>function</code>没有指定，则这个修改函数可以理解为：
<syntaxhighlight lang=lua>modify = require 'Module:a'</syntaxhighlight>

==== 调用模板 ====
我们可以将原始内容作为模板的参数，同时加入其它参数，将模板展开后的结果作为修改后内容。

其参数用法为：

* <code>call</code> = 要调用的模板名称，可以省略命名空间前缀。
* <code>content_as</code> = 要将原始内容作为调用的模板的哪个参数，默认为要调用的模板的第一个参数，即默认值为1。
* <code>para_''参数名称''</code> = 指定调用模板时加入的其他参数。

为了更好地理解，我们将各个代码的用法和''等价''效果进行比较。

{| class=wikitable
! 代码 !! 等价效果
|-
| <pre>-{}-
{{#invoke:list|list_to_text|第一项|第二项|第三项
|call=a}}
</pre>
| <pre>-{}-
{{a|第一项}}、{{a|第二项}}和{{a|第三项}}
</pre>
|-
| <pre>-{}-
{{#invoke:list|list_to_text|第一项|第二项|第三项
|call=a|content_as=b}}
</pre>
| <pre>-{}-
{{a|b=第一项}}、{{a|b=第二项}}和{{a|b=第三项}}
</pre>
|-
| <pre>-{}-
{{#invoke:list|list_to_text|第一项|第二项|第三项
|call=a|content_as=b|para_c=d}}
</pre>
| <pre>-{}-
{{a|b=第一项|c=d}}、{{a|b=第二项|c=d}}和{{a|b=第三项|c=d}}
</pre>
|-
| <pre>-{}-
{{#invoke:list|list_to_text|第一项|第二项|第三项
|call=a|para_2=d}}
</pre>
| <pre>-{}-
{{a|第一项|d}}、{{a|第二项|d}}和{{a|第三项|d}}
</pre>
或：
<pre>-{}-
{{a|1=第一项|2=d}}、{{a|1=第二项|2=d}}和{{a|1=第三项|2=d}}
</pre>
|}

请注意这种修改方法比较占开销，因此这种方法能避免就避免。

==== 替换格式 ====
你可以指定一个被替换文本，将被替换文本中的“%s”替换为原始内容之后即为修改后内容。这有点类似于string.format函数，但是可以替换可以多次，且不支持%a、%d等特殊用法。

{{编辑演示
|source= <pre>-{}-{{#invoke:list|bulleted|第一项|第二项|第三项
|replacement=这个%s和那个%s}}</pre>
|result= {{#invoke:list|bulleted|第一项|第二项|第三项
|replacement=这个%s和那个%s}}
}}
{{编辑演示
|source= <pre>-{}-{{#invoke:list|bulleted|第一项|第二项|第三项
|replacement=[[User:%s|%s]]}}</pre>
|result= {{#invoke:list|bulleted|第一项|第二项|第三项
|replacement=[[User:%s|%s]]}}
}}

==== 前后缀 ====
你可以直接给原始内容加入前缀和后缀。这个当然也可以通过替换文字来实现，不过直接加前后缀显然更加简便。

{{编辑演示
|source= <pre>-{}-{{#invoke:list|bulleted|第一项|第二项|第三项
|prefix=这是}}</pre>
|result= {{#invoke:list|bulleted|第一项|第二项|第三项
|prefix=这是}}
}}
{{编辑演示
|source= <pre>-{}-{{#invoke:list|concat|第一项|第二项|第三项
|suffix=平安|sep=，}}</pre>
|result= {{#invoke:list|concat|第一项|第二项|第三项
|suffix=平安|sep=，}}
}}

注意，前后缀可以同时都有，但是不能设置像<code><nowiki>|prefix={{|suffix=}}</nowiki></code>或<code><nowiki>|prefix=[[|suffix=]]</nowiki></code>这样的参数，因为这会直接影响维基文本的解析；即使加了nowiki也不行，因为这会直接导致文本不解析。

== 示例 ==

=== 带点的有序列表 ===

{{编辑演示
|source= {{tlx|#invoke:list|bulleted|-{}-第一项|第二项|第三项}}
|result= {{#invoke:list|bulleted|第一项|第二项|第三项}}
}}
{{编辑演示
|source= {{tlx|#invoke:list|bulleted|-{}-第一项|第二项|第三项|itemstyle=color:blue;}}
|result= {{#invoke:list|bulleted|第一项|第二项|第三项|itemstyle=color:blue;}}
}}
{{编辑演示
|source= {{tlx|#invoke:list|bulleted|-{}-第一项|第二项|第三项|item1style=background-color:yellow;|item2style=background-color:silver;}}
|result= {{#invoke:list|bulleted|第一项|第二项|第三项|item1style=background-color:yellow;|item2style=background-color:silver;}}
}}

=== 不带点的无序列表 ===

{{编辑演示
|source= {{tlx|#invoke:list|unbulleted|-{}-第一项|第二项|第三项}}
|result= {{#invoke:list|unbulleted|第一项|第二项|第三项}}
}}
{{编辑演示
|source= {{tlx|#invoke:list|unbulleted|-{}-第一项|第二项|第三项|itemstyle=color:blue;}}
|result= {{#invoke:list|unbulleted|第一项|第二项|第三项|itemstyle=color:blue;}}
}}
{{编辑演示
|source= {{tlx|#invoke:list|unbulleted|-{}-第一项|第二项|第三项|item1style=background-color:yellow;|item2style=background-color:silver;}}
|result= {{#invoke:list|unbulleted|第一项|第二项|第三项|item1style=background-color:yellow;|item2style=background-color:silver;}}
}}

=== 水平列表 ===

{{编辑演示
|source= {{tlx|#invoke:list|horizontal|-{}-第一项|第二项|第三项}}
|result= {{#invoke:list|horizontal|第一项|第二项|第三项}}
}}
{{编辑演示
|source= {{tlx|#invoke:list|horizontal|-{}-第一项|第二项|第三项|indent=2}}
|result= {{#invoke:list|horizontal|第一项|第二项|第三项|indent=2}}
}}

=== 有序列表 ===

{{编辑演示
|source = {{tlx|#invoke:list|ordered|-{}-第一项|第二项|第三项}}
|result = {{#invoke:list|ordered|第一项|第二项|第三项}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|ordered|-{}-第一项|第二项|第三项|start=3}}
|result = {{#invoke:list|ordered|第一项|第二项|第三项|start=3}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|ordered|-{}-第一项|第二项|第三项|type=i}}
|result = {{#invoke:list|ordered|第一项|第二项|第三项|type=i}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|ordered|-{}-第一项|第二项|第三项|liststyletype=lower-greek}}
|result = {{#invoke:list|ordered|第一项|第二项|第三项|liststyletype=lower-greek}}
}}

=== 水平有序列表 ===

{{编辑演示
|source = {{tlx|#invoke:list|horizontal_ordered|-{}-第一项|第二项|第三项}}
|result = {{#invoke:list|horizontal_ordered|第一项|第二项|第三项}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|horizontal_ordered|-{}-第一项|第二项|第三项|start=3}}
|result = {{#invoke:list|horizontal_ordered|第一项|第二项|第三项|start=3}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|horizontal_ordered|-{}-第一项|第二项|第三项|indent=2}}
|result = {{#invoke:list|horizontal_ordered|第一项|第二项|第三项|indent=2}}
}}

=== 直接连接 ===

{{编辑演示
|source = {{tlx|#invoke:list|concat|-{}-第一项|第二项|第三项}}
|result = {{#invoke:list|concat|第一项|第二项|第三项}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|concat|-{}-第一项|第二项|第三项|sep= / }}
|result = {{#invoke:list|concat|第一项|第二项|第三项|sep= / }}
}}
{{编辑演示
|source = {{tlx|#invoke:list|concat|-{}-第一项|第二项|第三项|sep=、|conj=及}}
|result = {{#invoke:list|concat|第一项|第二项|第三项|sep=、|conj=及}}
}}
注：<code>separation</code>和<code>sep</code>等价，<code>conjunction</code>和<code>conj</code>等价。

=== 用自然语言连接 ===

{{编辑演示
|source = {{tlx|#invoke:list|list_to_text|-{}-第一项|第二项|第三项}}
|result = {{#invoke:list|list_to_text|第一项|第二项|第三项}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|list_to_text|-{}-第一项|第二项|第三项|sep=，}}
|result = {{#invoke:list|list_to_text|第一项|第二项|第三项|sep=，}}
}}
{{编辑演示
|source = {{tlx|#invoke:list|list_to_text|-{}-第一项|第二项|第三项|conj=或}}
|result = {{#invoke:list|list_to_text|第一项|第二项|第三项|conj=或}}
}}

Module:List/doc - 版本历史

IdleTap-bot：​导入自求闻百科

IdleTap-bot：导入自求闻百科