Right-to-Left Support

Right-to-Left Support

SAPUI5 application developers need to be aware of how applications behave when right-to-left (RTL) directionality is selected. Changing the directionality has a big impact on text-displaying controls, images and the alignment of the whole application.

SAPUI5 sets the RTL mode based on the current language which is usually picked automatically based on the locale configuration of the user's browser or profile data.

The default text direction is left-to-right (LTR). If you need to change the mode for testing purposes you can do it by using one of the following configuration switches:

  • URL parameter sap-ui-rtl=true

  • Configuration object: window["sap-ui-config"].rtl = true;

  • Script tag configuration: data-sap-ui-rtl="true"

  • Setting an RTL language as default language for the application.

SAPUI5 then sets the overall page direction to RTL and all SAPUI5 content is displayed in RTL mode. Self-written controls and content has to be tested separately. If your application comes with additional CSS and needs specific style rules for the RTL case, then use a selector starting with html[dir=rtl].

In this section: