This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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;
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 definition
Initial value | over |
---|---|
Applies to | ruby annotations containers |
Inherited | yes |
Computed value | as specified |
Animation type | discrete |
Formal syntax
over | under | inter-character
Examples
Ruby positioned over the text
HTML
<ruby> <rb>超電磁砲</rb> <rp>(</rp><rt>レールガン</rt><rp>)</rp> </ruby>
CSS
ruby { ruby-position:over; }
Result
Ruby positioned under the text
HTML
<ruby> <rb>超電磁砲</rb> <rp>(</rp><rt>レールガン</rt><rp>)</rp> </ruby>
CSS
ruby { ruby-position:under; }
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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
ruby-position | Chrome No support No | Edge No support 12 — 79 | Firefox Full support 38 | IE
No support
No
| Opera No support No | Safari
No support
No
| WebView Android No support No | Chrome Android No support No | Firefox Android Full support 38 | Opera Android No support No | Safari iOS
No support
No
| Samsung Internet Android No support No |
inter-character | Chrome No support No | Edge No support No | Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
See also
- HTML Ruby elements:
<ruby>
,<rt>
,<rp>
, and<rtc>
. - CSS Ruby properties:
ruby-align
,ruby-merge
.