このページは日本語に翻訳済みです。
blockElementElementElement 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.
引数ParametersParameters 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,
)
breakableSettableSettableSettable 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),
)
radiusSettableSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.ブロックの角の丸めの大きさ。 詳細はrectangleのドキュメントを参照してください。
デフォルト値: (:)
insetSettableSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.ブロックのコンテンツのパディング量。 詳細はboxのドキュメントを参照してください。
デフォルト値: (:)
outsetSettableSettableSettable 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
clipSettableSettableSettable 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)
)
stickySettableSettableSettable 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)
