L10n-swift is a simple framework that improves localization in swift app, providing cleaner syntax and in-app language switching.
Overview
π
Features
- Change the language of your apps "on the fly".
- IBInspectable for Xcode Interface Builder (Cocoa - coming soon).
- Support for user-defined
Localizable
file names. - Support for formats:
*.plist
,*.json
,*.stringsdict
,*.strings
. - Support for grouping localization keys.
- Support for plural forms in any language with multiple arguments.
- Support for pseudo-languages:
NonLocalized
,DoubleLength
,Accented
,Bounded
,ForcedRightToLeft
. - Use
.l10n()
to localize any string, date and numbers. - Use more than one language at the same time.
- About 25 times faster than a native solution.
π»
Demo
pod try L10n-swift
β οΈ
Requirements
- iOS 9.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+
- Swift 3.0+
π₯
Communication
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, submit a pull request.
π
Installation
Core | Extension | IBInspectable | |
---|---|---|---|
L10n-swift |
|
|
|
L10n-swift/Core |
|
||
L10n-swift/Extension |
|
|
|
L10n-swift/IBInspectable |
|
|
CocoaPods
pod 'L10n-swift', '~> 5.9'
Carthage
github "Decybel07/L10n-swift", ~> 5.9
Swift Package Manager
.Package(url: "https://github.com/Decybel07/L10n-swift.git", majorVersion: 5)
π
Usage
Import L10n_swift at the top of each Swift file that will use framework.
import L10n_swift
Get localized text
Add .l10()
following any String
object you want localized:
"hello.world".l10n()
Get localized number
Add .l10()
following number you want localized. Using the number format for the current language:
12.l10n()
24.l10n(minIntegerDigits: 4)
1.61803.l10n()
2.71828.l10n(fractionDigits: 2)
3.14.l10n { formatter in
formatter.numberStyle = .currency
}
Get localized date
Add .l10()
following any Date
object you want localized using the date format for the current language:
Date().l10n()
Date().l10n { formatter in
formatter.dateStyle = .medium
}
Get plural
Add .l10nPlural(CVarArg...)
following any String
object you want translated with plurals:
"numberOfApples".l10nPlural(2)
More about plurals, you can read on wiki
Observe language changed
Add observer for notification L10nLanguageChanged
. This notification is called when language has been changed.
NotificationCenter.default.addObserver(
self, selector: #selector(self.yourFunction), name: .L10nLanguageChanged, object: nil
)
Set language
L10n.shared.language = "en"
L10n.shared.language = "en-GB"
At runtime, you can switch the language at any time by setting the language property.
Get current language
L10n.shared.language
Get locale for current language
L10n.shared.locale
Get list of supported languages
L10n.supportedLanguages
A list of all the languages contained in the main bundle.
Get preferred language
L10n.preferredLanguage
A preferred language contained in the main bundle.
Supported formats
.plist, .stringsdict
More about .plist format you can read on wiki.
More about .stringsdict format you can read on wiki.
.json
More about .json format you can read on wiki.
.strings
More about .strings format you can read on wiki.
π
FAQ
π€
Author
Adrian Bobrowski (Decybel07), [email protected]
π
License
L10n-swift is available under the MIT license. See the LICENSE file for more info.