このページは日本語に翻訳済みです。
list
ElementElement functions can be customized with set
and show
rules.
set
and show
rules.箇条書きリスト。
各項目の先頭にマーカーを付け、 一連の項目を縦に並べて表示します。
Example
Normal list.
- Text
- Math
- Layout
- ...
Multiple lines.
- This list item spans multiple
lines because it is indented.
Function call.
#list(
[Foundations],
[Calculate],
[Construct],
[Data Loading],
)

構文
この関数には専用の構文もあります。 行頭にハイフンとスペースを置くことでリスト項目を作成します。 リスト項目には複数の段落や、他のブロックレベルコンテンツを含めることができます。 リスト項目の記号よりも深く字下げされた全てのコンテンツは、そのリスト項目の一部になります。
引数Parameters are the inputs to a function. They are specified in parentheses after the function name.
tight
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.リストのデフォルトのspacingを定義します。
これがfalse
の場合、 項目の間隔はparagraph spacingによって決まります。
true
の場合、代わりにparagraph leadingが使用されます。
これによりリストがよりコンパクトになり、
各項目が短い場合に見栄えが良くなります。
マークアップモードでは、
この引数の値は項目が空行で区切られているかどうかに基づいて決定されます。
項目間に空行がなく連続している場合、この値はtrue
に設定されますが、
項目間が空行で区切られている場合はfalse
に設定されます。
マークアップで定義された間隔はsetルールで上書きすることはできません。
デフォルト値: true
例を表示
- If a list has a lot of text, and
maybe other inline content, it
should not be tight anymore.
- To make a list wide, simply insert
a blank line between the items.

marker
各項目の先頭に付けるマーカー。
単純なコンテンツの代わりに、ネストされたリストに使用する、
複数のマーカーを持つ配列を渡すこともできます。
リストのネストの深さがマーカーの数を超えた場合、使用されるマーカーは循環します。
完全に制御したい場合は、
リストのネストの深さ(0
から開始する)に応じて、使用するマーカーを決める関数を渡すこともできます。
デフォルト値: ([•], [‣], [–])
例を表示
#set list(marker: [--])
- A more classic list
- With en-dashes
#set list(marker: ([•], [--]))
- Top-level
- Nested
- Items
- Items

indent
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.各項目のインデント。
デフォルト値: 0pt
body-indent
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.各項目のマーカーと本文の間隔を指定します。
デフォルト値: 0.5em
spacing
デフォルト値: auto
children
RequiredRequired parameters must be specified when calling the function.PositionalPositional parameters are specified in order, without names.VariadicVariadic parameters can be specified multiple times.
箇条書きリストの項目。
list構文を使用する場合、forループのような構造を挟んでも、 隣接する項目は自動的にリストとしてまとめられます。
例を表示
#for letter in "ABC" [
- Letter #letter
]
