ruby-align

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The ruby-align CSS property defines the distribution of the different ruby elements over the base.

Syntax

css
/* Keyword values */
ruby-align: start;
ruby-align: center;
ruby-align: space-between;
ruby-align: space-around;

/* Global values */
ruby-align: inherit;
ruby-align: initial;
ruby-align: revert;
ruby-align: revert-layer;
ruby-align: unset;

Values

start

Is a keyword indicating that the ruby will be aligned with the start of the base text.

center

Is a keyword indicating that the ruby will be aligned at the middle of the base text.

space-between

Is a keyword indicating that the extra space will be distributed between the elements of the ruby.

space-around

Is a keyword indicating that the extra space will be distributed between the elements of the ruby, and around it.

Formal definition

Initial valuespace-around
Applies toruby bases, ruby annotations, ruby base containers, ruby annotation containers
Inheritedyes
Computed valueas specified
Animation typeby computed value type

Formal syntax

ruby-align = 
  start          |
  center         |
  space-between  |
  space-around

Examples

Ruby aligned at the start of the base text

HTML

html
<ruby>
  <rb>This is a long text to check</rb>
  <rp>（</rp><rt>short ruby</rt><rp>）</rp>
</ruby>

CSS

css
ruby {
  ruby-align: start;
}

Result

Ruby aligned at the center of the base text

HTML

html
<ruby>
  <rb>This is a long text to check</rb>
  <rp>（</rp><rt>short ruby</rt><rp>）</rp>
</ruby>

CSS

css
ruby {
  ruby-align: center;
}

Result

Extra space distributed between ruby elements

HTML

html
<ruby>
  <rb>This is a long text to check</rb>
  <rp>（</rp><rt>short ruby</rt><rp>）</rp>
</ruby>

CSS

css
ruby {
  ruby-align: space-between;
}

Result

Extra space distributed between and around ruby elements

HTML

html
<ruby>
  <rb>This is a long text to check</rb>
  <rp>（</rp><rt>short ruby</rt><rp>）</rp>
</ruby>

CSS

css
ruby {
  ruby-align: space-around;
}

Result

Specifications

Specification
CSS Ruby Annotation Layout Module Level 1
# ruby-align-property

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
ruby-align
Experimental
center
Experimental
space-around
Experimental
space-between
Experimental
start
Experimental

See also