NEW: Start my new Ultimate Portfolio App course with a free Hacking with Swift+ trial! >>

How to support right-to-left languages

Swift version: 5.2

Paul Hudson    @twostraws   

Hebrew, Arabic, Farsi, and more are all languages that use a right-to-left layout, and it doesn’t take much work to make your iOS apps fit in more naturally for those languages. In fact, there are four things you need to do to get most of the way there, and I want to walk through them briefly with some code.

First, make sure you use natural text alignment for your labels and text views. “Natural” automatically becomes either left aligned or right aligned depending on the user’s region, which means you don’t need to worry about. For example:

label.textAlignment = .natural

Second, use leading and trailing constraints rather than left and right, and again UIKit will automatically flip these when running on right-to-left devices:

label.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor).isActive = true
label.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor).isActive = true

Third, flip any images that need it. Most images should be fine without flipping, but if you have images that point to parts of your user interface then they should be flipped. This takes one line of code:

let flipped = originalImage.imageFlippedForRightToLeftLayoutDirection()

Note: that doesn’t actually flip the UIImage, but instead configures the image to be drawn flipped when it’s placed inside a UIImageView.

Finally, test your changes using a right-to-left region. The easiest way to do this is to go to the Product menu, hold down Alt, then click “Run…” to adjust your run schema. Now go to the Options tab and change Application Language from “System Language” to “Right-to-Left Pseudolanguage”. Now run your app in the simulator, and you should see your flipped layout working.

Hacking with Swift is sponsored by RevenueCat

SPONSORED Building and maintaining in-app subscription infrastructure is hard. Luckily there's a better way. With RevenueCat, you can implement subscriptions for your app in hours, not months, so you can get back to building your app.

Try it for free

Sponsor Hacking with Swift and reach the world's largest Swift community!

Available from iOS 9.0

Similar solutions…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

BUY OUR BOOKS
Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 2.9/5

 
Unknown user

You are not logged in

Log in or create account
 

Link copied to your pasteboard.