Latest 1.2.3
Homepage https://github.com/YTech/CascadeKit
License MIT
Platforms ios 9.0
Authors ,

CascadeKit is a library to apply styles to UIKit text controls based on the content language (to be precise, to the content script).

You can read more about this library on our Company Medium Blog.

Build Status

Branch Status
Master BuddyBuild

Table of Contents

  1. How to use CascadeKit
  2. How to install CascadeKit
  3. How to contribute
  4. License and Credits

How to use CascadeKit

CascadeKit let you to easily apply UI customizations based on text content. Let’s say you want to apply a blue color to Latin characters and a red color to Russian ones:

let mutAttrString = NSMutableAttributedString(string: text, attributes: originalAttributes)

let newAttr = mutAttrString.addAttributes(for: [.latin, .russian, .russianSupplementary], including: [.whiteSpace]) { (fallback) -> [Attribute] in

    switch fallback.type {
        case .latin:
            return [
                Attribute(key: .foregroundColor, value: UIColor.blue, range: fallback.range)]
        case .russian, .russianSupplementary:
            return [Attribute(key: .foregroundColor, value: red, range: fallback.range)]
        default:
            return []
    }
}

textView.attributedText = newAttr

Easy, right?

We can enhance the example, applying more and more customisations to the Attributed String like

  1. Greek :
    • foreground color = blue
    • font = Helvetica Neue, 15
  2. Russian:
    • background color = red
    • foreground color = white
    • font = Courier, 18
let mutAttrString = NSMutableAttributedString(string: text, attributes: originalAttributes)

let newAttr = mutAttrString.addAttributes(for: [.greek, .greekExtended, .russian, .russianSupplementary], including: [.whiteSpace]) { (fallback) -> [Attribute] in

    switch fallback.type {
        case .greek, .greekExtended:
            return [
                Attribute(key: .foregroundColor, value: UIColor.blue, range: fallback.range),
                Attribute(key: .font, value: UIFont(name: "Helvetica Neue", size: 15), range: fallback.range)]
        case .russian, .russianSupplementary:
            return [
                Attribute(key: .backgroundColor, value: UIColor.red, range: fallback.range),
                Attribute(key: .foregroundColor, value: UIColor.white, range: fallback.range),
                Attribute(key: .font, value: UIFont(name: "Courier", size: 18), range: fallback.range)]
        default:
            return []
    }
}

textView.attributedText = newAttr

So the steps to setup your custom rules are:

  • define the list of alphabets your UI needs to focus on, i.e.
    let myAlphabets = [.greek, .greekExtended, .russian, .russianSupplementary]
  • implement your custom rules into the addAttributes callback

Your beautifully crafted content is ready to be diplayed in each language of the world! ☺️

How to install CascadeKit

CocoaPods

Add CascadeKit to your Podfile

use_frameworks!
target 'MyTarget' do
pod 'CascadeKit', '~> 1.2.3'
end
$ pod install

Add CascadeKit source code to your project

Add CascadeKit folder to your project.

How to contribute

Contributions are greatly welcome 🙌 If you’d like to improve this projects, just open an issue or raise a PR from the current develop branch.

For any information or request feel free open an ISSUE.

License and Credits

License:

CascadeKit is available under the MIT license. See the LICENSE file for more info.

CascadeKit on the Web:

Latest podspec

{
    "name": "CascadeKit",
    "version": "1.2.3",
    "summary": "Kit to manage Cascade Styles on UIKit text controls",
    "swift_version": "4.0",
    "description": "Kit to manage Cascade Styles on UIKit text controls",
    "homepage": "https://github.com/YTech/CascadeKit",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Daniele Bogo": "[email protected]",
        "Ennio Masi": "[email protected]"
    },
    "source": {
        "git": "https://github.com/YTech/CascadeKit",
        "tag": "1.2.3"
    },
    "platforms": {
        "ios": "9.0"
    },
    "source_files": "CascadeKit/Source/**/*"
}

Pin It on Pinterest

Share This