Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【HTML Living Standard】ruby要素の使い方

ruby要素の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

rubyオブジェクトは、東アジアの言語などで、振り仮名や短い注釈テキストを、ベースとなる主要なテキストに付与するために使用されるオブジェクトです。このHTML要素は、主に日本語や中国語といった表意文字を持つ言語において、漢字などの文字の読み方を示す発音ガイドや、短い意味の補足情報を表示することを目的としています。例えば、「漢字」の上に「かんじ」と振り仮名を振るような場合に利用されます。

ruby要素の内部には、注釈の対象となる主要なテキスト(ベーステキスト)と、その注釈であるルビテキストの両方を含めます。ルビテキストは通常<rt>要素を用いて指定され、ベーステキストの上部や隣に表示されます。また、ルビ表示に対応していない古いウェブブラウザや環境向けに、代替のテキスト(例えば括弧など)を表示するために<rp>要素と組み合わせて使用されることもあります。

この要素は、ウェブコンテンツの国際化対応において非常に重要です。読みづらい漢字に振り仮名を振ることで、テキストの可読性を高め、多様な読者層がコンテンツを正確に理解するのを助けます。ウェブサイトやアプリケーションにおいて、特定の言語圏のユーザー体験を向上させるために活用される、表現豊かなHTML要素の一つです。

公式リファレンス: <ruby>: The Ruby Annotation element

構文(syntax)

1<ruby>
2  ベーステキスト
3  <rp>(</rp><rt>ルビテキスト</rt><rp>)</rp>
4</ruby>

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ