CocoaPods trunk is moving to be read-only. Read more on the blog, there are 14 months to go.

WBLanguage 2.0.0

WBLanguage 2.0.0

×

TestsTested ✗
LangLanguage SwiftSwift
License MIT
ReleasedLast Release Nov 2021
SPMSupports SPM ✗

Maintained by JsonBin.

WBLanguage 2.0.0

  • By
  • JsonBin

WBLanguage

Build Status Pod version Carthage Compatible Platform info

gif

What

WBLanguage is a high level LanguageKit. It provides a High Level API set international language for your app.

Features

  • Less time to switch the language
  • Set the language more convenient
  • Supported languages: English/French/Italian/German/Russian/Chinese-Hans/Chinese-Hant
  • Subsequent can add more national languages

Installation

WBLanguage supports multiple methods for installing the library in a project.

CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like WBAlamofire in your projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.2.0+ is required to build WBLanguage.

Podfile

To integrate WBLanguage into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

target 'TargetName' do
use_frameworks!

pod 'WBLanguage'

end

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate WBLanguage into your Xcode project using Carthage, specify it in your Cartfile:

github "JsonBin/WBLanguage"

Run carthage to build the framework and drag the built WBLanguage.framework into your Xcode project.

Requirements

  • iOS 9+
  • Xcode 10.0+
  • Swift 5.0+
WBLanguage Version Minimum iOS Target Note
1.x iOS 8 Xcode 9+ is required.
2.x iOS 9 Xcode 10+ is required.

you can create a Language.bundle resources in your project to hold the international language. otherwise, it will search from the main.bundle resources.

Usage

WBLanguageManager class

We can set WBLanguageManager's property at the beggining of app launching, the sample is below:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        WBLanguageManager.shared.startup()
        WBLanguageManager.shared.duration = 2.0
        return true
    }

if you want to set a new language, you can use updateLanguage(_:) to update the UI. And it will automatically save the language of your choice.

WBLanguageManager.shared.updateLanguage(type)

you can use localizedString(_:, place:) to get the local text from *.lproj.

let string = WBLanguageManager.shared.localizedString("key")

WBLanguage class

WBLanguage supports serializing and deserializing any custom type as long as it conforms to the WBLanguageProtocol protocol.

public extension WBLanguageProtocol {
    public var lt: WBLanguage<Self> {
        return WBLanguage(self)
    }
}

extension `yourCustom` : WBLanguageProtocol {}

Note: WBLanguageProtocol is a protocol that WBLanguage uses internally to directly. So you need to complete the language setting.

For example:

private func setLanguagePicker(
    _ object: NSObject,
    selector: Selector,
    picker: WBLanguagePicker?
) {
    object.pickers[selector] = picker
    object.performLanguage(selector, picker: picker)
}

extension WBLanguage where T : UILabel {
    public var picker: WBLanguageTextPicker? {
        set {
            let selector = #selector(setter: T.text)
            setLanguagePicker(value, selector: selector, picker: newValue)
        }
        get {
            let selector = #selector(setter: T.text)
            return getLanguagePicker(value, selector: selector) as? WBLanguageTextPicker
        }
    }
    
    public var attributedPicker: WBLanguageDictionaryPicker? {
        set {
            let selector = #selector(setter: T.attributedText)
            setLanguagePicker(value, selector: selector, picker: newValue)
        }
        get {
            let selector = #selector(setter: T.attributedText)
            return getLanguagePicker(value, selector: selector) as? WBLanguageDictionaryPicker
        }
    }
    
    public func setPicker(_ picker: WBLanguageTextPicker?) {
        let selector = #selector(setter: T.text)
        setLanguagePicker(value, selector: selector, picker: picker)
    }
    
    public func setAttributedPicker(_ picker: WBLanguageDictionaryPicker?) {
        let selector = #selector(setter: T.attributedText)
        setLanguagePicker(value, selector: selector, picker: picker)
    }
}

UIKit

UILabel

let label = UILabel()
label.lt.picker = "Label"

UILabel can use *.lt.picker or *.lt.setPicker(_:) to load text.

Of course, if you want to add attributes to the font, you can use WBLanguageDictionaryPicker or WBLanguageManager.shared.localizedString("key")

to take out the text first and then add attributes.

use WBLanguageDictionaryPicker:

label.lt.attributedPicker = WBLanguageDictionaryPicker(["picker": "Label", NSAttributedStringKey.foregroundColor: UIColor.black, NSAttributedStringKey.font: UIFont.boldSystemFont(ofSize: 17)])

another:

if let text = WBLanguageManager.shared.localizedString("Label") {
    let att = NSAttributedString(string: text, attributes: [.font: UIFont.boldSystemFont(ofSize: 17), .foregroundColor: UIColor.black])
    label.attributedText = att
}

UITextField

The use of the UITextField and UILabel is same, just more placeholder:

let textfield = UITextField()
textfield.lt.placeHolderPicker = "Label"

attribute picker:

textfield.lt.attributedPlaceHolderPicker = WBLanguageDictionaryPicker(["picker": "Label", NSAttributedStringKey.foregroundColor: UIColor.black, NSAttributedStringKey.font: UIFont.boldSystemFont(ofSize: 17)])

UIButton

let button = UIButton(type: .system)
button.lt.setPicker("Button", forState: .normal)

attribute text:

let picker = WBLanguageDictionaryPicker(["picker": "Button", NSAttributedStringKey.foregroundColor: UIColor.black, NSAttributedStringKey.font: UIFont.boldSystemFont(ofSize: 17), NSAttributedStringKey.strikethroughStyle:NSUnderlineStyle.styleDouble.rawValue])
button.lt.setAttributedPicker(picker, forState: .normal)

UISegmentedControl

let segment = UISegmentedControl(items: ["","","","",""])
segment.lt.setPicker("English", forSegmentAt: 0)
segment.lt.setPicker("Russian", forSegmentAt: 1)
segment.lt.setPicker("French", forSegmentAt: 2)
segment.lt.setPicker("Italian", forSegmentAt: 3)
segment.lt.setPicker("German", forSegmentAt: 4)

UISegmentedControl just has one method to set text picker.

License

WBLanguage is available under the MIT License. See the LICENSE file for more info.