UIs for languages that are read from right-to-left (RTL), such as Arabic and Hebrew, should be mirrored to ensure content is easy to understand.
Design & API Documentation
npm install @material/rtl
rtl is the most flexible mixin, because it can work with multiple CSS properties. All other RTL mixins logic could be engineered by only using
rtl, but we provide these mixins for convenience.
reflexive-box work with one base box-model property, e.g. margin, border, padding. But
reflexive-property is more flexible because it accepts different left and right values.
reflexive-box assumes the left and right values are the same, and therefore that the box-model is symmetrical.
reflexive-position is the least flexible mixin. It only works with one horizontal position property, "left" or "right". It also assumes the left and right values are the same.
||Creates a rule that is applied when the root element is within an RTL context|
||Applies the value to the
||Emits rules that assign
||Applies the value to the specified position in a LTR context, and flips the direction in an RTL context.
||Applies the pair of property values to the specified position in a LTR context, and flips the direction in an RTL context.|
A note about [dir="rtl"]:
rtl($root-selector) checks for
[dir="rtl"] on the ancestor element. This works in most cases, it will sometimes lead to false negatives for more complex layouts, e.g.
<html dir="rtl"> <!-- ... --> <div dir="ltr"> <div class="mdc-foo">Styled incorrectly as RTL!</div> </div> </html>
Unfortunately, we've found that this is the best we can do for now. In the future, selectors such as :dir will help us mitigate this.