このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HTML <dfn> 定義要素

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

<dfn> HTML 要素は、定義される用語を示します。<dfn> 要素は、完全な定義文の中で使用する必要があります。その際、用語の完全な定義は以下のいずれかとなります。

  • 祖先である段落(テキストのブロック、<p> 要素で示されることもある)
  • <dt>/<dd> の組み合わせ
  • この <dfn> 要素の直近の祖先セクション

試してみましょう

<p>
  <dfn id="def-validator">バリデーター</dfn>とは、コードや文書に含まれる構文
  エラーをチェックするプログラムのことです。
</p>
dfn {
  /* ここにスタイルを追加 */
}

属性

この要素の属性はグローバル属性を含みます。

title 属性は後述のとおり、通常と異なる特別な意味合いを持ちます。

使用上のメモ

<dfn> 要素の使用については、必ずしも明確に分かりやすくない側面がいくつかあります。ここでそれらを説明します。

定義される用語の指定

定義される用語は、以下の規則に従います。

  1. <dfn> 要素に title 属性がある場合、 title 属性の値が定義される用語とみなされます。その要素の中の文字列もその用語でなければなりませんが、略語(おそらく <abbr> を使用)や、用語のその他の形でも構いません。
  2. <dfn> が単一の子要素を持ち、自分自身には何も文字列がなく、かつその子要素が title 属性を持つ <abbr> 要素である場合は、 <abbr> 要素の title の値が定義する用語です。
  3. それ以外では、 <dfn> 要素の文字列コンテンツが定義される用語です。これは以下の最初の例で示します。

メモ: もし <dfn> 要素に title 属性があれば、それが定義する用語であり、それ以外の文字列ではありません。

<dfn> 要素へのリンク

<dfn> 要素に id 属性をつけた場合は、 <a> 要素を使用してそこにリンクすることができます。用語の使用時にはそのようなリンクを使用して、用語のリンクをクリックすることで読者が用語の定義にすばやく移動できるようにしてください。

これは以下の定義へのリンクの例で示します。

様々な利用シナリオの例をいくつか見てみましょう。

基本的な用語の識別

この例は、定義の中の用語の位置を識別するために素の <dfn> 要素を使用しています。

HTML

html
<p>
  <strong>HTML の定義要素 (<dfn>&lt;dfn&gt;</dfn>)</strong> は、定義句または文の文脈内で定義される用語を示すために使用されます。
</p>

<dfn> 要素に title がないので、 <dfn> 要素自身の文字列コンテンツが定義される用語として使用されます。

結果

定義へのリンク

定義へのリンクを追加するには、いつも通りの方法で <a> 要素を使ってリンクを作成します。

HTML

html

ここで id 属性の "definition-dfn" の値をリンク先として使用して、定義を見ることができます。その後で、 <a>href 属性を "#definition-dfn" に設定して、定義に戻るリンクを設定します。

結果

略語と定義の両方の使用

場合によっては、用語を定義する際に略語を使用したくなる場合もあるでしょう。これは <dfn><abbr> 要素を組み合わせて、このように実現できます。

HTML

html
<p>
  <dfn><abbr title="ハッブル宇宙望遠鏡">HST</abbr></dfn>は、これまでに建造された科学観測装置の中でも、最も多くの成果を上げてきたもののひとつです。20 年以上にわたり軌道上にあり、空をくまなく観測し、かつてないほど高品質で詳細なデータや写真を送り続けています。
</p>

<p>
  実際、<abbr title="ハッブル宇宙望遠鏡">HST</abbr>は、これまでに作られたどの装置よりも、科学の発展に大きく貢献してきたと言えるでしょう。
</p>

<abbr> 要素が <dfn> の中で入れ子になっています。前者は用語が略語 ("HST") であることを示し、完全な用語 ("Hubble Space Telescope") を title 属性で定義します。後者は略語が定義された用語であることを表します。

結果

技術的概要

コンテンツカテゴリー フローコンテンツ, 記述コンテンツ, 知覚可能コンテンツ
許可されている内容 記述コンテンツ、ただし <dfn> 要素を子孫にしてはいけません。
タグの省略 なし。開始タグと終了タグの両方が必須です。
許可されている親要素 記述コンテンツを受け入れるすべての要素
暗黙の ARIA ロール term
許可されている ARIA ロール すべて
DOM インターフェイス HTMLElement

仕様書

仕様書
HTML
# the-dfn-element

ブラウザーの互換性

関連情報