Swiftpack.co - Package - Decybel07/L10n-swift


Build Status CocoaPods Version Language Swift3 CocoaPods Platform CocoaPods License Docs percent Pod method Compatible Codacy Badge codebeat badge Mentioned in Awesome-swift

L10n-swift is a simple framework that improves localization in swift app, providing cleaner syntax and in-app language switching.


Change language Simple translator Plurals

🌟 Features

  • [x] Change the language of your apps "on the fly".
  • [x] IBInspectable for Xcode Interface Builder (Cocoa - coming soon).
  • [x] Support for user-defined Localizable file names.
  • [x] Support for formats: *.plist, *.json, *.stringsdict, *.strings.
  • [x] Support for grouping localization keys.
  • [x] Support for plural forms in any language.
  • [x] Use .l10n() to localized any string, date, int and double.
  • [x] Use more than one languages at the same time.
  • [x] 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 | ✔️ | | ✔️ |


pod 'L10n-swift', '~> 5.0'


github "Decybel07/L10n-swift", ~> 5.0

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:


Get localized number

Add .l10() following any Int, Double or NSNumber object you want localized using the number format for the current language:

24.l10n(minIntegerDigits: 4)
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 number format for the current language:


Date().l10n { formatter in
    formatter.dateStyle = .medium

Get plural

Add .l10(arg: CVarArg) following any String object you want translated with plurals:

"numberOfApples".l10n(arg: 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

    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


Get locale for current language


Get list of supported languages


A list of all the languages contained in the main bundle.

Get preferred language


A preferred language contained in the main bundle

Supported formats

.plist, .stringsdict

Sample .plist and .stringsdict file

More about .plist format you can read on wiki

More about .stringsdict format you can read on wiki


Sample .json file

More about .json format you can read on wiki


Sample .strings file

More about .strings format you can read on wiki.


🤓 Author

Adrian Bobrowski (Decybel07), adrian071993@gmail.com

🔑 License

L10n-swift is available under the MIT license. See the LICENSE file for more info.


Stars: 47
Help us keep the lights on


Used By

Total: 0


5.0.0 - Nov 19, 2017

  • Support for json format.
  • Faster access to localization keys.
  • Plural only for one argument.
  • All formats support plural (zero, one, two, few, many, other and floating for floating point numbers).
  • Bugfix #10.
  • Improved README
  • Improved documentation.
  • Created wiki.

.plist, .stringsdict






4.2.0 - Oct 1, 2017

  • Migrate to Swift 4.0

4.1.3 - Oct 1, 2017

  • Created example for Right-to-Left

4.1.2 - Aug 31, 2017

  • Bugfix - missing @IBInspectable

4.1.1 - Aug 24, 2017

  • Implementation of the Localizable protocol for the L10n