CuteAttribute
CuteAttribute
===
An elegant way to deal with attributed string in swift. It’s convenient to create attributed string by .cute, whatever from String, NSString, NSAttributedString or NSMutableAttributedString. It’s so amazing that almost all methods support chaining. I create this project just because I met Typeset serveral days ago. But I found it’s so hard to use by swift. So I made this.
Support
Swift 3.0 & iOS 8+
Installation
Swift Package Manager
- add it to your Xcode project.
- Import the header file in your project.
import CuteAttribute
CocoaPods
- add it to your Podfile.
pod 'CuteAttribute'
- Then run the command.
pod install
- Import the header file in your project.
import CuteAttribute
Carthage
- Add CuteAttribute to your Cartfile.
github "qiuncheng/CuteAttribute"
- Run the command
carthage update --platform ios
-
Follow the rest of the standard Carthage installation instructions to add CuteAttribute to your project.
-
Import the header file in your project.
import CuteAttribute
Manually
- Download the full file.
- Drag the CuteAttribute folder to your project.
Usage
Comparison
attribute name | result | NSAttributedString | CuteAttribute
— | — | — | —
color | 
| NSMutableAttributedString(string: “hello world”, attributes: [.foregroundColor: UIColor.red]) | “hello world”.cute.matchAll().color(.red)
baselineOffset | 
| NSMutableAttributedString(string: “hello world”, attributes: [.baselineOffset: 10]) | “hello world”.cute.matchAll().baseline(10)
underline | 
| NSMutableAttributedString(string: “hello world”, attributes: [.underlineColor: UIColor.red, .underlineStyle: NSUnderlineStyle.styleSingle.rawValue]) | “hello world”.cute.matchAll().underline(.styleSingle).underlineColor(.red)
font | 
| NSMutableAttributedString(string: “hello world”, attributes: [NSAttributedStringKey.font: UIFont.systemFont(ofSize: 20)]) | “hello world”.cute.matchAll().font(UIFont.systemFont(ofSize: 20))
strikethrough | 
| NSMutableAttributedString(string: “hello world”, attributes: [.strikethroughStyle: NSUnderlineStyle.styleSingle.rawValue, .strikethroughColor: UIColor.red]) | “hello world”.cute.matchAll().strikeThrough(.styleSingle).strokeColor(.red)
link | 
| NSMutableAttributedString(string: “hello world”, attributes: [.link: “https://blog.vsccw.com”]) | “hello world”.cute.matchAll().link(“https://blog.vsccw.com”)
ligature | 
| NSMutableAttributedString(string: “hello world”, attributes: [.ligature: 1]) | “hello world”.cute.matchAll().ligature(1)
kern | 
| NSMutableAttributedString(string: “hello world”, attributes: [.kern: 10]) | “hello world”.cute.matchAll().kern(10)
stroke | 
| NSMutableAttributedString(string: “hello world”, attributes: [.strokeColor: UIColor.red, .strokeWidth: 10]) | “hello world”.cute.matchAll().strokeColor(.red).strokeWidth(10)
shadow | let shadow = NSShadow(); shadow.shadowColor = UIColor.red; shadow.shadowOffset = CGSize(width: 4, height: 4); shadow.shadowBlurRadius = 10; 
| NSMutableAttributedString(string: “hello world”, attributes: [.shadow: shadow]) | “hello world”.cute.matchAll().shadow(shadow)
textEffect | 
| “hello world”.cute.matchAll().textEffect(“NSTextEffectLetterpressStyle”) | “hello world”.cute.matchAll().textEffect(“NSTextEffectLetterpressStyle”)
obliqueness | 
| NSMutableAttributedString(string: “hello world”, attributes: [.obliqueness: 10]) | “hello world”.cute.matchAll().obliqueness(10)
expansion | 
| NSMutableAttributedString(string: “hello world”, attributes: [.expansion: 10]) | “hello world”.cute.matchAll().expansion(10)
textAttachment | let attachment = NSTextAttachment(); attachment.image = UIImage(named: "hello.png"); 
| NSMutableAttributedString(string: “hello world”, attributes: [.attachment: attachment]) | “hello world”.cute.matchAll().textAttachment(attachment)
TODO
- Documented.
- Example.
- Test.
- More convenience.
Thanks
Typeset : Deal with AttributedString efficiently in Objective-C.
LICENCE
Under MIT License