このページは日本語に翻訳済みです。
block
ElementElement functions can be customized with set
and show
rules.
set
and show
rules.ブロックレベルのコンテナ。
このようなコンテナは、コンテンツを区切り、その大きさを調整し、背景や枠線を付与するために使用できます。
ブロックは、テキストが段落の一部となるかどうかを制御する主要な方法でもあります。 詳細は段落のドキュメントを参照してください。
例
ブロックを使用すると、複数のページに渡って分割されるコンテンツに背景を与えることができます。
#set page(height: 100pt)
#block(
fill: luma(230),
inset: 8pt,
radius: 4pt,
lorem(30),
)

ブロックは、特にshowルールを記述する際、本来インラインとなる要素を強制的にブロックレベルとして扱う場合にも有用です。
#show heading: it => it.body
= Blockless
More text.
#show heading: it => block(it.body)
= Blocky
More text.

引数Parameters are the inputs to a function. They are specified in parentheses after the function name.
width
ブロックの幅。
デフォルト値: auto
例を表示
#set align(center)
#block(
width: 60%,
inset: 8pt,
fill: silver,
lorem(10),
)

height
ブロックの高さ。
高さがページに残された余白より大きく、breakable
がtrue
の場合、 ブロックは残りの高さで次のページに続きます。
デフォルト値: auto
例を表示
#set page(height: 80pt)
#set align(center)
#block(
width: 80%,
height: 150%,
fill: aqua,
)

breakable
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.ブロックが分割可能で次のページに継続するかどうか。
デフォルト値: true
例を表示
#set page(height: 80pt)
The following block will
jump to its own page.
#block(
breakable: false,
lorem(15),
)

radius
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.ブロックの角の丸めの大きさ。 詳細はrectangleのドキュメントを参照してください。
デフォルト値: (:)
inset
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.ブロックのコンテンツのパディング量。 詳細はboxのドキュメントを参照してください。
デフォルト値: (:)
outset
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.レイアウトに影響を与えずにブロックの大きさを拡大する量。 詳細はboxのドキュメントを参照してください。
デフォルト値: (:)
spacing
ブロック周りの間隔。auto
の場合、段落のspacing
を継承します。
隣接する2つのブロックについては、最初のブロックのabove
と2番目のブロックのbelow
のうち、 大きい方の間隔が優先されます。
また、ブロックの間隔は段落のspacing
よりも優先されます。
これはabove
とbelow
を同じ値に設定するための短縮記法にすぎないことに注意してください。
above
とbelow
の値は異なる可能性があるため、contextブロックではblock.above
と block.below
にのみアクセスでき、block.spacing
に直接アクセスすることはできません。
このプロパティはshowルールと組み合わせて使用することで、任意のブロックレベル要素の周りの間隔を調整できます。
デフォルト値: 1.2em
例を表示
#set align(center)
#show math.equation: set block(above: 8pt, below: 16pt)
This sum of $x$ and $y$:
$ x + y = z $
A second paragraph.

above
このブロックとその前のブロックとの間隔。
デフォルト値: auto
below
このブロックとその後のブロックとの間隔。
デフォルト値: auto
clip
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.ブロックの内側のコンテンツのクリッピングを行うか否か。
クリッピングは、ブロックの境界を超えたコンテンツを隠すため、ブロックのコンテンツがブロック本体よりも大きい場合に便利です。
デフォルト値: false
例を表示
#block(
width: 50pt,
height: 50pt,
clip: true,
image("tiger.jpg", width: 100pt, height: 100pt)
)

sticky
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.このブロックが、次のブロックとの間に区切りを入れることなく続ける必要があるかどうか。
この設定は、ページの下部で見出しが孤立することを防ぐために、見出しブロックに対してデフォルトで適用されています。
デフォルト値: false
例を表示
// Disable stickiness of headings.
#show heading: set block(sticky: false)
#lorem(20)
= Chapter
#lorem(10)
