Warning:
This wiki has been archived and is now read-only.

User:Myakura2/Notes/ruby-spec

From HTML5 JP IG
Jump to: navigation, search

ルビ関連要素の翻訳。

ruby 要素

カテゴリ
Flow content
Phrasing content
利用可能な箇所
Phrasing content が期待される箇所
内容モデル
Phrasing content と rt 要素のグループがひとつ以上
もしくは phrasing content と rp, rt, rp 要素のグループがひとつ以上
内容属性
グローバル属性
DOM インターフェース
HTMLElement を利用

ruby 要素を利用することで、ひとつ以上の phrasing content をルビ注釈によってマークすることができる。ルビ注釈とは基テキストの側に表示される短いテキストを指し、主に東アジアでのタイポグラフィにおいて発音のためのガイドやその他の注釈を付加する際に利用される。日本語においてこの形式は「ふりがな」と呼ばれる。

ruby 要素は、要素内容のうち rt 要素 rp 要素、それらの子孫要素を省いた phrasing content を表す。要素が表す箇所には、rt 要素によって生成された注釈が対応する。

この例では、日本語のテキスト「漢字」に対し、一文字ごとにひらがなによる読みがふられている。

...
<ruby>
 漢 <rt> かん </rt>
 字 <rt> じ  </rt>
</ruby>
...

これは次のように表示されるだろう。

http://dev.w3.org/html5/spec/images/sample-ruby-ja.png

この例では、繁体字のテキスト「漢字」に対し、一文字ごとに注音符号による読みがふられている。

<ruby>
 漢 <rt> ㄏㄢˋ </rt>
 字 <rt> ㄗˋ  </rt>
</ruby>

これは次のように表示されるだろう。

http://dev.w3.org/html5/spec/images/sample-ruby-bopomofo.png

この例では、簡体字のテキスト「汉字」に対し、一文字ごとにピンインによる読みがふられている。

...
<ruby>
 汉 <rt> hàn </rt>
 字 <rt> zì  </rt>
</ruby>
...

これは次のように表示されるだろう。

http://dev.w3.org/html5/spec/images/sample-ruby-pinyin.png

rt 要素

カテゴリ
None
利用可能な箇所
ruby 要素の子要素として
内容モデル
Phrasing content
内容属性
グローバル属性
DOM インターフェース
HTMLElement を利用

rt 要素はルビ注釈におけるルビテキストを記す。

ruby 要素の子である rt 要素は注釈を表す。注釈は rt 要素の子によって与えられ、ruby 要素内にある rt 要素の直前に現れる 0 以上の phrasing content に対し適用される。なお、ruby 要素内に rp が存在するとき、その要素は無視される。

ruby 要素の子でない rt 要素は、その子と同じものを表す。

rp 要素

カテゴリ
None
利用可能な箇所
ruby 要素の子要素として、rt 要素の直前または直後に
内容モデル
Phrasing content
内容属性
グローバル属性
DOM インターフェース

rp 要素はルビ注釈に対応しないユーザーエージェントに対して、ルビテキストの前後に括弧を提供するために利用することができる。

ruby 要素内の rp 要素は何も表さず、内容は無視されなければならない。ruby 要素の子でない rp 要素は、その子を表す。

rp を利用して、古いユーザーエージェントでは読みが括弧内に現れるようにすることができる。前述した「漢字」に読みを与える例を書き換えてみよう。

...
<ruby>
 漢 <rp>(</rp><rt>かん</rt><rp>)</rp>
 字 <rp>(</rp><rt>じ</rt><rp>)</rp>
</ruby>
...

適合するユーザーエージェントでは表示が変化することはないが、ruby をサポートしないユーザーエージェントにおいては、次のように表示されるだろう。

... 漢 (かん) 字 (じ) ...

Disclaimer

このページは HTML5 (I. Hickson / Editor's Draft, Rev 1.3627) より、ruby, rt, rp 要素の箇所について翻訳したものである。翻訳には誤りが含まれる可能性に注意されたい。

Copyright © 2009 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.