imported>Diskdance 来自 2025年7月29日 (二) 09:38

2025-07-29T09:38:19Z

新页面

{{high-use|30929}}
{{module rating|protected}}
{{Uses TemplateStyles|Template:Hlist/styles.css|Template:Plainlist/styles.css}}

该模块输出各种列表。目前，它支持项目符号列表、无项目符号列表、水平列表、排序列表(编号或字母顺序)和水平排序列表。它允许轻松设置列表或单个列表项的CSS样式。
== 用法 ==

; 快捷用法

<syntaxhighlight lang="wikitext">{{#invoke:list|函数名|第一项|第二项|第三项|...}}</syntaxhighlight>

; 所有参数

<syntaxhighlight lang="wikitext">
{{#invoke:list|函数名|第一项|第二项|第三项|...
| start = 
| type = 
| list_style_type = 
| class = 
| style = 
| list_style = 
| item_style = 
| item1_style = 
| item2_style = 
| item1_value = 
| item2_value = 
| indent = 
}}
</syntaxhighlight>

; 从父模板传递的参数

<syntaxhighlight lang="wikitext">
{{#invoke:list|函数名}}
</syntaxhighlight>

; 功能

{| 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>1</code>，<code>2</code>，<code>3</code>...） - 这些是列表项。如果没有列表项，则模块将不输出任何内容。
* <code>start</code> - 设置有序列表的起始项。这可以是有序列表的起始数字，也可以是有序列表的起始字母。水平有序列表只支持数字。
* <code>type</code> - 有序列表中使用的标记类型。可能的值为 "1" 表示数字（默认），"A" 表示大写字母，"a" 表示小写字母，"I" 表示大写罗马数字，"i" 表示小写罗马数字。水平有序列表不支持。另请参阅 <code>list_style_type</code> 参数。
* <code>list_style_type</code> - 有序列表中使用的标记类型。这使用CSS样式，比 <code>type</code> 参数提供更多类型的标记。可能的值列在 [https://developer.mozilla.org/en-US/docs/Web/CSS/list-style-type MDN 的 list-style-type 页面] 上。浏览器支持可能有所不同。 <code>list-style-type</code> 是此参数的别名。
* <code>class</code> - {{tag|div}} 标签周围列表的自定义类，例如 <code>plainlinks</code>。
* <code>style</code> - {{tag|div}} 标签周围列表的自定义CSS样式，例如 <code>font-size: 90%;</code>。
* <code>list_style</code> - 列表本身的自定义CSS样式。格式与 {{para|style}} 参数相同。
* <code>item_style</code> - 所有列表项（{{tag|li}} 标签）的自定义CSS样式。格式与 {{para|style}} 参数相同。
* <code>item1_style</code>、<code>item2_style</code>、<code>item3_style</code>... - 每个列表项的自定义CSS样式。格式与 {{para|style}} 参数相同。
* <code>item1_value</code>、<code>item2_value</code>、<code>item3_value</code>... - 给定列表项的自定义值。在给定值之后的列表项将从指定值递增。该值应为正整数。（请注意，此选项仅对有序列表有效。）
* <code>indent</code> - 此参数缩进列表，仅适用于水平和水平有序列表。值必须为数字，例如 <code>2</code>。缩进以 [[Em (typography)|em]] 计算，并且是指定值的 1.6 倍。如果未指定缩进，则默认值为零。

== 示例 ==

; 无序列表

{| class="wikitable"
! 代码 !! 效果
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|bulleted|第一项|第二项|第三项}}</syntaxhighlight>
| {{#invoke:list|bulleted|第一项|第二项|第三项}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|bulleted|第一项|第二项|第三项|item_style=color:blue;}}</syntaxhighlight>
| {{#invoke:list|bulleted|第一项|第二项|第三项|item_style=color:blue;}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|bulleted|第一项|第二项|第三项|item1_style=background-color:yellow;|item2_style=background-color:silver;}}</syntaxhighlight>
| {{#invoke:list|bulleted|第一项|第二项|第三项|item1_style=background-color:yellow;|item2_style=background-color:silver;}}
|}

; 无序列表

{| class="wikitable"
! 代码 !! 效果
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|unbulleted|第一项|第二项|第三项}}</syntaxhighlight>
| {{#invoke:list|unbulleted|第一项|第二项|第三项}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|unbulleted|第一项|第二项|第三项|item_style=color:blue;}}</syntaxhighlight>
| {{#invoke:list|unbulleted|第一项|第二项|第三项|item_style=color:blue;}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|unbulleted|第一项|第二项|第三项|item1_style=background-color:yellow;|item2_style=background-color:silver;}}</syntaxhighlight>
| {{#invoke:list|unbulleted|第一项|第二项|第三项|item1_style=background-color:yellow;|item2_style=background-color:silver;}}
|}

; 水平列表

{| class="wikitable"
! 代码 !! 效果
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|horizontal|第一项|第二项|第三项}}</syntaxhighlight>
| {{#invoke:list|horizontal|第一项|第二项|第三项}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|horizontal|第一项|第二项|第三项|indent=2}}</syntaxhighlight>
| {{#invoke:list|horizontal|第一项|第二项|第三项|indent=2}}
|}

; 有序列表

{| class="wikitable"
! 代码 !! 效果
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|ordered|第一项|第二项|第三项}}</syntaxhighlight>
| {{#invoke:list|ordered|第一项|第二项|第三项}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|ordered|第一项|第二项|第三项|start=3}}</syntaxhighlight>
| {{#invoke:list|ordered|第一项|第二项|第三项|start=3}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|ordered|第一项|第二项|第三项|type=i}</syntaxhighlight>
| {{#invoke:list|ordered|第一项|第二项|第三项|type=i}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|ordered|第一项|第二项|第三项|list_style_type=lower-greek}}</syntaxhighlight>
| {{#invoke:list|ordered|第一项|第二项|第三项|list_style_type=lower-greek}}
|}

; 水平有序列表

{| class="wikitable"
! 代码 !! 效果
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|horizontal_ordered|第一项|第二项|第三项}}</syntaxhighlight>
| {{#invoke:list|horizontal_ordered|第一项|第二项|第三项}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|horizontal_ordered|第一项|第二项|第三项|start=3}}</syntaxhighlight>
| {{#invoke:list|horizontal_ordered|第一项|第二项|第三项|start=3}}
|-
| <syntaxhighlight lang="wikitext" inline>{{#invoke:list|horizontal_ordered|第一项|第二项|第三项|indent=2}}</syntaxhighlight>
| {{#invoke:list|horizontal_ordered|第一项|第二项|第三项|indent=2}}
|}

== 追蹤分類 ==
* {{clc|含有过期参数的列表模板}}

== 參見 ==
* [[Module:Separated entries]]
* [[Module:Unbulleted list]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |

[[Category:添加追踪分类的模块]]
}}</includeonly>

Module:List/doc - 版本历史

imported>Diskdance 来自 2025年7月29日 (二) 09:38