kiarashvosough1999 / cocoattributedstringbuilder Goto Github PK

CocoAttributedStringBuilder: Elegant and Easy AttributedStringBuilder in Swift

• Features
• Requirements
• Installation
• SampleProjects
• Usage
• Contributors
• License

• Use resultBuilder to create attributes
• Support NSShadow Attributes
• Support NSTextAttachment Attributes
• Support NSParagraphStyle Attributes
• Support NSParagraphStyle's NextTabs
• Specify range for each attribute
• Support if-statement on builders
• Provide operator to define an attribute

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate CocoAttributedStringBuilder into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'CocoAttributedStringBuilder'

I have provided one sample project in the repository. To use it clone the repo, Source files for these are in the CocoAttributedStringBuilderExamples directory in project navigator. Have fun!

Using Coco is so easy, It is inspired by SwiftUI and the very useful PropertyWrapper @resultBuilder in swift.

You just need to annotate the functions or properties which return NSAttributedString to use Coco provided builders.

import CocoAttributedStringBuilder

@CocoAttributedStringBuilder
var builder: NSAttributedString { }

@CocoAttributedStringBuilder
func build() -> NSAttributedString { }

In order to create an AttributedString on Coco, you should use CocoString which takes a String and a builderBlock arguments.

String which was provided as an input argument is also available on the builderBlock to avoid outer variable or self capturing.

import CocoAttributedStringBuilder

@CocoAttributedStringBuilder
var builder: NSAttributedString {
    CocoString("Test Builder") { str in 
      // attributes comes here
    }
}

@CocoAttributedStringBuilder
func build() -> NSAttributedString {
    CocoString("Test Builder") { str in 
      // attributes comes here
    }
}

Coco supports four kind of Attributes.

Each attribute is normally added to whole string, unless you specify the range of string you demand.

Coco is not responsible for handling invalid ranges, so be more careful on specifying the ranges.

import CocoAttributedStringBuilder

@CocoAttributedStringBuilder
func build() -> NSAttributedString {
    CocoString("Test Builder") { str in
        CocoAttribute.foregroundColor(.red)
            .on(str.startIndex..<str.firstIndex(of: "r")!)

        TextAttachment {
            CocoAttachment.bounds(.infinite)
        }
        .within(str.startIndex..<str.firstIndex(of: "r")!)
        
        ParagrapghStyle {
            CocoParagraphStyle.lineHeightMultiple(8)
            CocoParagraphStyle.lineSpacing(2.3)
            TextTab {
                CocoTextTab.tab(textAlignment: .left, location: 5)
                CocoTextTab.tab(textAlignment: .center, location: 5)
            }
        }
        .within { str.startIndex..<str.firstIndex(of: "h")! }

        Shadow {
            CocoShadow.shadowOffset(.init(width: 1.5, height: 1))
            CocoShadow.shadowColor(UIColor.black)
        }
        .within(str.startIndex..<str.firstIndex(of: "d")!)
    }
}

Instead of Using Each Coco Enums to use its Attributes, you can use BuilderBlock with meta-type of Coco Enum provided for that Block.

import CocoAttributedStringBuilder

@CocoAttributedStringBuilder
func build() -> NSAttributedString {
CocoString("Test Builder") { str, a in
    a.foregroundColor(.red)
        .within(str.startIndex..<str.firstIndex(of: "r")!)

    TextAttachment { t in
        t.bounds(.infinite)
    }
}

I recommend you to use either meta-type provides block or Coco Enums, but there is another way with one special condition. you can use each attribute Concrete type directly in each block if and only if that type is unique on that Enum.

On this example Bounds input argument is Unique in CocoCocoAttachment, so we can use its input concrete type to add as attribute, CGRect which is defined is consided as b.bounds(.infinite)

import CocoAttributedStringBuilder

@CocoAttributedStringBuilder
func build() -> NSAttributedString {
CocoString("Test Builder") { str, a in

    TextAttachment { t in
        CGRect.infinite
    }
}

Feel free to share your ideas or any other problems. Pull requests are welcomed.

CocoAttributedStringBuilder is released under an MIT license. See LICENSE for more information.