[](https://travis-ci.org/Decybel07/L10n-swift)
[](http://cocoapods.org/pods/L10n-swift)
[](https://developer.apple.com/swift/)
[](https://swiftpackageindex.com/Decybel07/L10n-swift)
[](https://github.com/Decybel07/L10n-swift/blob/master/LICENSE)
[](#-installation)
[](https://github.com/matteocrippa/awesome-swift#localization)
L10n-swift is a simple framework that improves localization in swift app, providing cleaner syntax and in-app language switching.
## Overview
## 🌟 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`](https://github.com/Decybel07/L10n-swift/wiki/*.plist), [`*.json`](https://github.com/Decybel07/L10n-swift/wiki/*.json), [`*.stringsdict`](https://github.com/Decybel07/L10n-swift/wiki/*.stringsdict), [`*.strings`](https://github.com/Decybel07/L10n-swift/wiki/*.strings).
- [x] Support for grouping localization keys.
- [x] Support for [**plural**](https://github.com/Decybel07/L10n-swift/wiki/Plural) forms in any language with multiple arguments.
- [x] Support for pseudo-languages: `NonLocalized`, `DoubleLength`, `Accented`, `Bounded`, `ForcedRightToLeft`.
- [x] Use `.l10n()` to localize any string, date and numbers.
- [x] Use more than one language at the same time.
- [x] About 25 times faster than a native solution.
## 💻 Demo
```ruby
pod try L10n-swift
```
## ⚠️ Requirements
- iOS 9.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+
- Swift 4.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](http://cocoapods.org)
```ruby
pod 'L10n-swift', '~> 5.10'
```
### [Carthage](https://github.com/Carthage/Carthage)
```ogdl
github "Decybel07/L10n-swift", ~> 5.10
```
### [Swift Package Manager](https://swift.org/package-manager/)
```swift
.Package(url: "https://github.com/Decybel07/L10n-swift.git", majorVersion: 5)
```
## 📘 [Usage](http://cocoadocs.org/docsets/L10n-swift/)
Import L10n_swift at the top of each Swift file that will use framework.
```swift
import L10n_swift
```
### Get localized text
Add `.l10()` following any `String` object you want localized:
```swift
"hello.world".l10n()
```
### Get localized number
Add `.l10()` following number you want localized. Using the number format for the current language:
```swift
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:
```swift
Date().l10n()
Date().l10n { formatter in
formatter.dateStyle = .medium
}
```
### Get plural
Add `.l10nPlural(CVarArg...)` following any `String` object you want translated with plurals:
```swift
"numberOfApples".l10nPlural(2)
```
More about plurals, you can read on [**wiki**](https://github.com/Decybel07/L10n-swift/wiki/Plural)
### Observe language changed
Add observer for notification `L10nLanguageChanged`. This notification is called when language has been changed.
```swift
NotificationCenter.default.addObserver(
self, selector: #selector(self.yourFunction), name: .L10nLanguageChanged, object: nil
)
```
### Set language
```swift
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
```swift
L10n.shared.language
```
### Get locale for current language
```swift
L10n.shared.locale
```
### Get list of supported languages
```swift
L10n.supportedLanguages
```
A list of all the languages contained in the main bundle.
### Get preferred language
```swift
L10n.preferredLanguage
```
A preferred language contained in the main bundle.
### Supported formats
#### .plist, .stringsdict
More about **.plist** format you can read on [**wiki**](https://github.com/Decybel07/L10n-swift/wiki/*.plist).
More about **.stringsdict** format you can read on [**wiki**](https://github.com/Decybel07/L10n-swift/wiki/*.stringsdict).
#### .json
More about **.json** format you can read on [**wiki**](https://github.com/Decybel07/L10n-swift/wiki/*.json).
#### .strings
More about **.strings** format you can read on [**wiki**](https://github.com/Decybel07/L10n-swift/wiki/*.strings).
## 📙 [FAQ](https://github.com/Decybel07/L10n-swift/wiki/FAQ)
## 🤓 Author
Adrian Bobrowski ([Decybel07](https://github.com/Decybel07)), adrian071993@gmail.com
## 🔑 License
L10n-swift is available under the MIT license. See the [LICENSE](https://github.com/Decybel07/L10n-swift/blob/master/LICENSE) file for more info.
