HTML Tags – Ruby Annotation Tag


What is the HTML <ruby> tag ?

HTML <ruby> tag is used to represent a ruby annotation.

Ruby annotations are used to represent pronunciation of Chinese, Japanese, and Korean typography (East Asian characters).

HTML <ruby> tag is introduced new in HTML5.

HTML <ruby> tag is used together with the <rt> and the <rp> tags.

What is a Ruby character ?

Ruby characters are small, annotative glosses that can be placed above or to the right of a Chinese character while writing logographic languages such as Chinese or Japanese to show the pronunciation.

Ruby annotations, are usually used as a pronunciation guide for relatively obscure characters.

What is ruby annotations ?

Ruby annotations are used in East Asian Chinese, Japanese, and Korean typography.

Its used to display certain characters in several Asian languages, using the <ruby> element.

How HTML <ruby> tag works ?

HTML <ruby> tag consists of one or more characters that needs an explanation/pronunciation.

HTML <rt> element that gives that information.

And <rp> element that defines what to show for browsers that not support ruby annotations.


We have to use HTML <rp> tag together with HTML <ruby> and HTML <rp> tag.

Note : <rp> element is an optional element.

Why is the HTML <ruby> tag used ?

Ruby annotations are mostly/widely used in Chinese and Japanese publications.

Ruby annotations are useful to show the pronunciation of East Asian characters like Chinese and Japanese Chinese.


HTML <rt> tag is used to provide translation, pronunciations, or transliteration information for the east Asian characters present in ruby language annotation.

HTML <rt> tag is mostly used in showing pronunciation of characters in languages, like Chinese and Japanese Chinese.

HTML beginners tutorial !!!

Click to Learn More about – HTML Tutorial for beginners

Syntax :

<ruby attributes> Contents... </ruby>

Example :

<!DOCTYPE html>
<html>
        <head>
                <title>rp tag</title>
                <style>
                        body {
                                text-align:left;
                        }
                        h1 {
                                color:blue;
                        }
                </style>
        </head>
        <body>
                <h1>Welcome to CSTechbook</h1>
                <ruby>WHO :
                        <rt>
                                <rp>[</rp>World Health Organization
                                <rp>]</rp>
                        </rt>
                </ruby>
        </body>
</html>

Output :

<ruby> Tag Attributes

HTML <ruby> tag does not support any specific attributes.

Global Attributes

HTML <ruby> tag support following global attributes.

SnoAttributesValueDescription
1idunique_nameDeclared unique id for an element.
2classclass_nameDeclared one or more classnames for an element.
3stylestylesCSS inline styles specify an element.
4titletitleSpecify extra details of element contain, this will display as a “tooltip” for an elements.

Event Attributes

HTML <ruby> tag support following event attributes.

SnoAttributesValueDescription
1onfocusscriptelement gets focus on object when script tobe run.
2onblurscriptelement lose the focus on object when scrip tobe run.
3onabortscriptelement gets aborted on object when script tobe run.
4onchangescriptelement gets anytime change on object when script tobe run.
5onbeforeunloadscriptelement gets unloaded on object when scrip tobe run.
6onclickscriptclicked on object when script tobe run.
7ondblclickscriptdouble click on object when script tobe run.
8onkeydownscriptkey is pressed when script tobe run.
9onkeypressscriptkey is pressed over element then released when script tobe run.
10onkeyupscriptkey is released over element when script tobe run.
11onmousedownscriptmouse button was pressed over an element when script tobe run.
12onmouseoutscriptmouse pointer release over an element when script tobe run.
13onmousemovescriptrun mouse pointer moved when script tobe run.
14onmouseoverscriptrun mouse pointer move over when script tobe run.
15onmouseupscriptmouse button is released when script tobe run.
16onresetscriptform has been reset when script tobe run.
17onselectscriptSelect some content when script tobe run.
18onsubmitscriptform has been submitted when script tobe run.
19onloadscriptobject has load when script tobe run.
20onchangescriptallow to change the object when script tobe run.
21onunloadscriptunload to the browser window when script tobe run.
22ondragscriptelement being dragged when script tobe run.
23ondragendscriptelement being stop dragged when script tobe run.
24ondragenterscriptelement being go target dragged when script tobe run.
25ondragleavescriptelement being leave to target dragged when script tobe run.
26ondragoverscriptelement being over to target dragged when script tobe run.
27ondragstartscriptelement being start dragged when script tobe run.
28ondropscriptelement being dropped when script tobe run.
29onerrorscriptelement error occurs when script tobe run.
30onmessagescriptelement message display when script tobe run.
31onerrorscriptelement error occurs when script tobe run.
32onmousewheelscriptmouse wheel will be rotate when script tobe run.
33onscrollscriptscrollbar is scroll when script tobe run.
34onresizescriptelement should be resize when script tobe run.
35onselectscriptall element content selected when script tobe run.
36onstoragescriptelement should be store in target when script tobe run.

Browser Compatibility

SnoBrowserSupport
1ChromeYes
2FirefoxYes
3EdgeYes
4OperaYes
5SafariYes
6Internet ExplorerYes