Add RTL stylesheet and support for right-to-left languages that confgurable in config.json #30327
Conversation
…gurable in config.json
|
Mohammad Rezaei seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You have signed the CLA already but the status is still pending? Let us recheck it. |
github-actions
bot
added
the
Z-Community-PR
|
Why would it be set in config.json given user language is user selectable? What would happen if config.json said RTL but the user's language is English? |
Thank you for your feedback and for taking the time to review this PR! The decision to include the direction setting in config.json was made to provide greater flexibility for customization, allowing administrators or users to explicitly control the text direction (LTR or RTL) independently of the selected language. This is particularly useful in cases where users prefer a specific direction for their UI, even if it deviates from the default direction of their chosen language. For example, some users might select an RTL language like Persian (Farsi), Arabic, or Hebrew but prefer an LTR layout due to personal habits, accessibility needs, or specific deployment requirements (e.g., in multilingual environments where LTR is standardized). If config.json specifies RTL, but the user selects English, the UI applies RTL and loads _rtl-style.pcss. Without a direction setting, it defaults to LTR, ensuring English users are unaffected unless configured otherwise. To improve, we could align direction with the user’s language by default (e.g., RTL for Arabic, LTR for English) or add a UI option to override the config. I’m open to refining this to better support LTR and RTL communities. Please share your feedback. If you could accept this PR for now, we can work together to improve it in the future. |
Hello, thank you for good support to Element Web.
This PR adds RTL support to Element Web by configuring text direction (
ltrorrtl) viaconfig.json. Thedirectionfield sets thedirattribute on the<html>element and loads an_rtl-style.pcssstylesheet that overrides LTR-specific properties for RTL languages. It uses the[dir="rtl"]selector for automation. Tested with Persian (Farsi), Arabic and Hebrew on Chrome and Firefox. Includes documentation updates.Fixes requirements like as mentioned #28120, #22445, #21731, #14520, #5604, #2922, #1712, #26283, etc.
RTL display:
Checklist
public/exportedsymbols have accurate TSDoc documentation.