Latest 0.0.2
Homepage https://github.com/willowtreeapps/WTATagStringBuilder
License MIT
Authors , ,

WTATagStringBuilder is a tool for building attributed strings using custom tags.

You do this using tags like "The sky is blue" and setting attributes for those tags.

Example

WTATagStringBuilder* tagString = [[WTTagStringBuilder alloc] initWithString:@"The quick brown fox <TAG>jumped</TAG>"];
[tagString addGlobalAttribute:NSFontAttributeName 
                        value:[UIFont fontWithName:@"Helvetica-Light" size:20]];
[tagString addAttribute:NSUnderlineStyleAttributeName
                  value:[NSNumber numberWithInt:NSUnderlineStyleSingle]
                    tag:@"TAG"];
self.label.attributeText = tagString.attributedString;

The example above would have "The quick brown fox jumped" all in Helvetica-Light, size 20 font and would have "jumped" underlined.

You can find list of attributes that iOS provides at https://developer.apple.com/library/ios/#documentation/uikit/reference/NSAttributedString_UIKit_Additions/Reference/Reference.html (search "Character Attributes").

Tasks

string property
attributedString property
– initWithString:
– addGlobalAttribute:value:
– addAttribute:value:tag:
– attributesForTag:

Properties

string

A copy of the character contents of the receiver (this MTTagString) as an NSString object
@property (nonatomic, copy) NSString *string;
Default: nil

attributedString

The character contents with string attributes as an NSAttributedString object
@property (nonatomic, readonly) NSAttributedString *attributedString;
Default: nil

Instance Methods

initWithString:

Returns an instance of the MTTagString with a given NSString object
- (void)addGlobalAttribute:(id)attribute value:(id)value;
Parameters
* string – the characters for the new object
Return Value
an instance of MTTagString with string as its string

addGlobalAttribute:value:

Adds an attribute to the entire string
- (void)addAttribute:(id)attribute value:(id)value tag:(NSString *)tag;
Parameters
* attribute – the name of the attribute
* value – the value of the attribute

addAttribute:value:tag:

Adds an attribute to all parts of the string from <tag> to </tag>
- (void)addAttribute:(id)attribute value:(id)value tag:(NSString *)tag;
Parameters
* attribute – the name of the attribute
* value – the value of the attribute
* tag – the tag that shows where to apply the attributes

attributesForTag:

Returns the all the attributes that are applied to parts of the strings from <tag> to </tag>
- (NSArray *)attributesForTag:(NSString *)tag;
Parameters
* tag – a string that determines where the attributes are applied
Returns
an array of all the attributes for tag

Latest podspec

{
    "name": "WTATagStringBuilder",
    "version": "0.0.2",
    "summary": "A tool for build attributed strings using custom tags.",
    "homepage": "https://github.com/willowtreeapps/WTATagStringBuilder",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": [
        "WillowTree Apps",
        "Andrew Carter",
        "Harang Ju"
    ],
    "source": {
        "git": "https://github.com/willowtreeapps/WTATagStringBuilder.git",
        "tag": "0.0.2"
    },
    "source_files": "Classes/**/*.{h,m}",
    "requires_arc": true
}

Pin It on Pinterest

Share This