This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The ruby-position
CSS property defines the position of a ruby element relatives to its base element. It can be position over the element (over
), under it (under
), or between the characters, on their right side (inter-character
).
/* Keyword values */ ruby-position: over; ruby-position: under; ruby-position: inter-character; /* Global values */ ruby-position: inherit; ruby-position: initial; ruby-position: unset;
Initial value | over |
---|---|
Applies to | ruby annotations containers |
Inherited | yes |
Media | visual |
Computed value | as specified |
Animation type | discrete |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Syntax
Values
over
- Is a keyword indicating that the ruby has to be placed over the main text for horizontal scripts and right to it for vertical scripts.
under
- Is a keyword indicating that the ruby has to be placed under the main text for horizontal scripts and left to it for vertical scripts.
inter-character
- Is a keyword indicating that the ruby has to be placed between the different characters.
Formal syntax
over | under | inter-character
Examples
This HTML will render differently with each value of ruby-position
:
<ruby> <rb>超電磁砲</rb> <rp>(</rp><rt>レールガン</rt><rp>)</rp> </ruby>
Ruby positioned over the text
ruby { ruby-position:over; }
This gives the following result:
Ruby positioned under the text
ruby { ruby-position:under; }
This gives the following result:
Specifications
Specification | Status | Comment |
---|---|---|
CSS Ruby Layout Module Level 1 The definition of 'ruby-position' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | No support | (Yes) | 38 (38) | No support [1] | ? | No support [2] |
inter-character |
No support | ? | No support | No support | ? | No support |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | (Yes) | 38.0 (38) | No support [1] | No support | No support [2] |
inter-character |
No support | No support | No support | No support | No support |
[1] Internet Explorer, since IE 9, supports a very old draft version, which defined inline
(equivalent of having display: inline
on the ruby), and above
(synonym of the modern over
)
[2] WebKit implements a non-standard, prefixed, version of ruby-position
, -webkit-ruby-position
: it has two properties: before
and after
(both equivalent, for ltr and rtl scripts to the standard over
value used with ruby-align: start
).
See also
- HTML Ruby elements:
<ruby>
,<rt>
,<rp>
, and<rtc>
. - CSS Ruby properties:
ruby-align
,ruby-merge
.