`link` Element

URLや文書中の位置へのリンク。

デフォルトでは、リンクの外見は通常のテキストと変わりません。しかし、showルールを使うことで、簡単に任意のスタイルを適用できます。

例

#show link: underline

https://example.com \

#link("https://example.com") \
#link("https://example.com")[
  See example.com
]

ハイフネーションや両端揃えを有効にしていても、意図しないURL中のハイフネーションを防ぐため、デフォルトではリンクには適用されません。これを無効化するには、show link: set text(hyphenate: true)を使用します。

この関数には専用の構文もあります。 http://やhttps://で始まるテキストは、自動的にリンクに変換されます。

link(

リンクの遷移先。

Webページにリンクする場合、destは有効なURL文字列である必要があります。 mailto:やtel:のURLスキームを含むURLが指定され、かつbodyパラメーターが省略された場合、 URLスキームを除いたメールアドレスまたは電話番号がリンクの本文になります。
文書中の別の部分にリンクする場合、 destには次の3つのうちいずれかの形式を用いることができます。
- 要素に付与されたlabel。要素に基づいて自動的にリンクの本文を生成したい場合は、 referenceの使用を検討してください。
- location（通常はhereやlocate、 queryから取得される）。
- integer型のpageキーとlength型のx座標、y座標を持つ辞書。ページ番号は1から始まり、座標はページの左上隅からの相対位置です。

View example

= Introduction <intro>
#link("mailto:hello@typst.app") \
#link(<intro>)[Go to intro] \
#link((page: 1, x: 0pt, y: 0pt))[
  Go to top
]

リンクとして表示する内容。

destがURL文字列の場合、このパラメーターは省略可能です。この場合、URLがリンクとして表示されます。