place

要素関数

要素関数

要素関数はsetルールやshowルールでカスタマイズできます。

親コンテナに対して相対的なコンテンツの配置。

コンテンツはオーバーレイ（デフォルト）またはフロートのいずれかで配置できます。 オーバーレイのコンテンツは、指定されたalignmentに従って親コンテナにあわせて配置され、これまでに追加された他のコンテンツの上に表示されます。 フロートのコンテンツは、親コンテナの上部または下部に配置され、他のコンテンツを下または上にそれぞれずらします。 両方の場合で、コンテンツの位置はdxおよびdyオフセットを用いてレイアウトに影響を与えることなく調整可能です。

block、box、rectなどの任意のコンテナが親になることができます。 トップレベルのplaceの呼び出しは現在のページのテキスト領域に直接コンテンツを配置します。 これはページ上の絶対位置指定に使用できます。 top + left alignmentと組み合わせると、dxおよびdyオフセットはテキスト領域の左上隅を基準として要素の左上隅の位置を設定します。 マージンを含めたページ全体における絶対位置指定は、page.foregroundかpage.background中でplaceを使うと可能です。

例

#set page(height: 120pt)
Hello, world!

#rect(
  width: 100%,
  height: 2cm,
  place(horizon + right, square()),
)

#place(
  top + left,
  dx: -5pt,
  square(size: 5pt, fill: red),
)

他の要素の位置に対する影響

要素のオーバーレイはコンテンツの流れの中にスペースを取りませんが、placeの呼び出しは、流れの中にブロックレベルの不可視要素を挿入します。 これは現在の段落を中断することでレイアウトに影響を与える可能性があります。 これを避けるために、段落の途中でplaceを呼び出す場合には、それをboxでラップするとよいでしょう。 このとき、配置とオフセットは、この大きさを持たないボックスを基準にしたものになります。 間隔に影響しないように、ワードジョイナーを使用してボックスを単語に結合してください。

例えば、以下は直後の単語に注釈を付与する関数を定義しています。

#let annotate(..args) = {
  box(place(..args))
  sym.wj
  h(0pt, weak: true)
}

A placed #annotate(square(), dy: 2pt)
square in my text.

ゼロ幅の弱い空白は、関数呼び出しと次の単語との間の空白を削除する役割を果たします。

Accessibility

Assistive Technology (AT) will always read the placed element at the point where it logically appears in the document, regardless of where this function physically moved it. Put its markup where it would make the most sense in the reading order.