Session 222 - Introduction to Attributed Strings for iOS

Transcript

1. These are confidential sessions—please refrain from streaming, blogging, or taking pictures Session 222 Introduction to Attributed Strings for iOS Aki “I ⍰ Unicode” Inoue Cocoa Engineer Drawing strings with dramatic expression
2. Multi-style String Drawing in UIKit in UIKit
3. Multi-style String Drawing in UIKit You can take it off the wishlist now! in UIKit
4. in UIKit NSAttributedString
5. •Attributed string essentials •Drawing with basic attributes •UIKit adoption Agenda
6. •Attributed string essentials •Drawing with basic attributes •UIKit adoption Agenda •Attributed string essentials
7. •Attributed string essentials •Drawing with basic attributes •UIKit adoption Agenda •Drawing with basic attributes
8. •Attributed string essentials •Drawing with basic attributes •UIKit adoption Agenda •UIKit adoption
9. Attributed String Essentials
10. Displaying Strings I’m a string Using UIStringDrawing
11. Displaying Strings NSString Using UIStringDrawing @”I’m a string”
12. Displaying Strings I’m a string Using UIStringDrawing
13. Displaying Strings I’m a string Using UIStringDrawing Helvetica Neue
14. Displaying Strings I’m a string Using UIStringDrawing Helvetica Neue Bold
15. Displaying Strings I’m a string Using UIStringDrawing Helvetica Neue Bold Red
16. What Is an Attributed String ? Associating attributes to characters I’m an attributed string
17. What Is an Attributed String ? Associating attributes to characters I’m an attributed string Helvetica Neue
18. What Is an Attributed String ? Associating attributes to characters I’m an attributed string Helvetica Neue
19. What Is an Attributed String ? Associating attributes to characters Helvetica Neue Helvetica Neue Helvetica Neue + Yellow I’m an attributed string
20. What Is an Attributed String ? Associating attributes to characters Times New Roman + Underline Helvetica Neue Helvetica Neue + Yellow I’m an attributed string Helvetica Neue Italic
21. What Can You Do with It? Multi-style text An Apple Engineer Abducted by An Alien Spacecraft A spacecraft landed at the Cuperti… TheNews - 6/13/12 at 3:18 PM An Apple Engineer Abducted by An Alien Spacecraft A spacecraft landed at the Cupert… TheNews - 6/13/12 at 3:18 PM
22. What Can You Do with It? Multi-style text An Apple Engineer Abducted by An Alien Spacecraft A spacecraft landed at the Cuperti… TheNews - 6/13/12 at 3:18 PM An Apple Engineer Abducted by An Alien Spacecraft A spacecraft landed at the Cupert… TheNews - 6/13/12 at 3:18 PM
23. What Can You Do with It? Multi-style text An Apple Engineer Abducted by An Alien Spacecraft A spacecraft landed at the Cuperti… TheNews - 6/13/12 at 3:18 PM An Apple Engineer Abducted by An Alien Spacecraft A spacecraft landed at the Cupert… TheNews - 6/13/12 at 3:18 PM
24. What Can You Do with It? More expressive layout options
25. What Can You Do with It? More expressive layout options
26. What Can You Do with It? Graphics effects as text styles
27. - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; •An attribute dictionary per character NSAttributedString
28. - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; •An attribute dictionary per character NSAttributedString
29. •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; •Instantiating with a string and attributes dictionary NSAttributedString - (id)initWithString:(NSString *)string attributes:(NSDictionary *)attrs;
30. •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; •Instantiating with a string and attributes dictionary NSAttributedString - (id)initWithString:(NSString *)string attributes:(NSDictionary *)attrs;
31. Specifying a font Instantiating an Attributed String •Using NSFontAttributeName NSAttributedString *string = [[NSAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }];
32. Specifying a font Instantiating an Attributed String Hello World!! •Using NSFontAttributeName NSAttributedString *string = [[NSAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }];
33. •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; •Instantiating with a string and attributes dictionary - (id)initWithString:(NSString *)string attributes:(NSDictionary *)attrs; NSAttributedString
34. •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; •Instantiating with a string and attributes dictionary - (id)initWithString:(NSString *)string attributes:(NSDictionary *)attrs; •No attribute for an empty string NSAttributedString
35. NSMutableAttributedString •Changing attributes •Modifying string contents
36. NSMutableAttributedString •Changing attributes •Modifying string contents
37. •Mutable methods for attributes - (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range; Changing attributes NSMutableAttributedString
38. •Mutable methods for attributes - (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range; - (void)addAttributes:(NSDictionary *)attrs range:(NSRange)range; - (void)addAttribute:(NSString *)key value:(id)value range:(NSRange)range; - (void)removeAttribute:(NSString *)key range:(NSRange)range; Changing attributes NSMutableAttributedString
39. •Mutable methods for attributes - (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range; - (void)addAttributes:(NSDictionary *)attrs range:(NSRange)range; - (void)addAttribute:(NSString *)key value:(id)value range:(NSRange)range; - (void)removeAttribute:(NSString *)key range:(NSRange)range; •Modifying existing attributes •Creating multi-style string Changing attributes NSMutableAttributedString
40. Emphasizing a range Creating Multi-style String •Using NSForegroundColorAttributeName NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Dentist at 9:15am.” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; [string addAttribute:NSForegroundColorAttributeName ! ! value:[UIColor redColor] ! ! range:NSMakeRange(11, 6)]; // Change the time, 9:15am, to red
41. Emphasizing a range Creating Multi-style String •Using NSForegroundColorAttributeName NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Dentist at 9:15am.” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; [string addAttribute:NSForegroundColorAttributeName ! ! value:[UIColor redColor] ! ! range:NSMakeRange(11, 6)]; // Change the time, 9:15am, to red Dentist at 9:15am.
42. Emphasizing a range Creating Multi-style String •Using NSForegroundColorAttributeName NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Dentist at 9:15am.” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; [string addAttribute:NSForegroundColorAttributeName ! ! value:[UIColor redColor] ! ! range:NSMakeRange(11, 6)]; // Change the time, 9:15am, to red Dentist at 9:15am. •Using NSForegroundColorAttributeName NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Dentist at 9:15am.” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; [string addAttribute:NSForegroundColorAttributeName ! ! value:[UIColor redColor] ! ! range:NSMakeRange(11, 6)]; // Change the time, 9:15am, to red
43. Emphasizing a range Creating Multi-style String •Using NSForegroundColorAttributeName NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Dentist at 9:15am.” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; [string addAttribute:NSForegroundColorAttributeName ! ! value:[UIColor redColor] ! ! range:NSMakeRange(11, 6)]; // Change the time, 9:15am, to red Dentist at 9:15am.
44. NSMutableAttributedString •Changing attributes •Modifying string contents
45. •Mutable methods for string contents - (void)replaceCharactersInRange:(NSRange)range withString:(NSString *)str; Modifying string contents NSMutableAttributedString
46. •Mutable methods for string contents - (void)replaceCharactersInRange:(NSRange)range withString:(NSString *)str; - (void)replaceCharactersInRange:(NSRange)range ! ! ! ! withAttributedString:(NSAttributedString *)attributedString; - (void)insertAttributedString:(NSAttributedString *)attributedString ! ! ! ! ! ! ! atIndex:(NSUInteger)location; - (void)appendAttributedString:(NSAttributedString *)attributedString; - (void)deleteCharactersInRange:(NSRange)range; Modifying string contents NSMutableAttributedString
47. •Mutable methods for string contents - (void)replaceCharactersInRange:(NSRange)range withString:(NSString *)str; - (void)replaceCharactersInRange:(NSRange)range ! ! ! ! withAttributedString:(NSAttributedString *)attributedString; - (void)insertAttributedString:(NSAttributedString *)attributedString ! ! ! ! ! ! ! atIndex:(NSUInteger)location; - (void)appendAttributedString:(NSAttributedString *)attributedString; - (void)deleteCharactersInRange:(NSRange)range; Modifying string contents NSMutableAttributedString
48. - (void)replaceCharactersInRange:(NSRange)range ! ! ! ! withAttributedString:(NSAttributedString *)attributedString; - (void)insertAttributedString:(NSAttributedString *)attributedString ! ! ! ! ! ! ! atIndex:(NSUInteger)location; - (void)appendAttributedString:(NSAttributedString *)attributedString; - (void)deleteCharactersInRange:(NSRange)range; Modifying string contents NSMutableAttributedString •Mutable methods for string contents - (void)replaceCharactersInRange:(NSRange)range withString:(NSString *)str;
49. •Moving the appointment time 1 hour early NSMutableAttributedString *string; // a mutable string [string replaceCharactersInRange:NSMakeRange(11, 6) withString:@”8:15am”]; Modifying String Contents
50. •Moving the appointment time 1 hour early NSMutableAttributedString *string; // a mutable string [string replaceCharactersInRange:NSMakeRange(11, 6) withString:@”8:15am”]; Dentist at 9:15am. Modifying String Contents
51. •Moving the appointment time 1 hour early NSMutableAttributedString *string; // a mutable string [string replaceCharactersInRange:NSMakeRange(11, 6) withString:@”8:15am”]; Modifying String Contents Dentist at 8:15am.
52. •Moving the appointment time 1 hour early NSMutableAttributedString *string; // a mutable string [string replaceCharactersInRange:NSMakeRange(11, 6) withString:@”8:15am”]; Modifying String Contents Dentist at 8:15am.
53. Modifying String Contents Dentist at 8:15am. •Moving the appointment time 1 hour early NSMutableAttributedString *string; // a mutable string [string replaceCharactersInRange:NSMakeRange(11, 6) withString:@”8:15am”];
54. Modifying String Contents Dentist at 8:15am. •Moving the appointment time 1 hour early NSMutableAttributedString *string; // a mutable string [string replaceCharactersInRange:NSMakeRange(11, 6) withString:@”8:15am”];
55. Attributes Preserved
56. •Attributes are preserved during string content replacement Attributes Preserved
57. •Attributes are preserved during string content replacement •Three rules to remember Attributes Preserved
58. •Attributes are preserved during string content replacement •Three rules to remember 1. When replacing, the new characters inherit attributes from the first character of the range being replaced Attributes Preserved 1. When replacing, the new characters inherit attributes from the first character of the range being replaced
59. •Attributes are preserved during string content replacement •Three rules to remember 1. When replacing, the new characters inherit attributes from the first character of the range being replaced 2. When inserting, the incoming string inherit from the previous character Attributes Preserved 2. When inserting, the incoming string inherit from the previous character
60. •Attributes are preserved during string content replacement •Three rules to remember 1. When replacing, the new characters inherit attributes from the first character of the range being replaced 2. When inserting, the incoming string inherit from the previous character 3. When inserting at the beginning, the attributes at index 0 are used Attributes Preserved 3. When inserting at the beginning, the attributes at index 0 are used
61. •Attributes are preserved during string content replacement •Three rules to remember 1. When replacing, the new characters inherit attributes from the first character of the range being replaced 2. When inserting, the incoming string inherit from the previous character 3. When inserting at the beginning, the attributes at index 0 are used NOTE: Remember the “no character, no attributes” rule Attributes Preserved
62. •Insertion [string replaceCharactersInRange:NSMakeRange(3, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents defghi •Insertion [string replaceCharactersInRange:NSMakeRange(3, 0) withString:@”ABC”]; abc
63. •Insertion [string replaceCharactersInRange:NSMakeRange(3, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents defghi •Insertion [string replaceCharactersInRange:NSMakeRange(3, 0) withString:@”ABC”]; ABC abc
64. •Insertion [string replaceCharactersInRange:NSMakeRange(3, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents defghi •Insertion [string replaceCharactersInRange:NSMakeRange(3, 0) withString:@”ABC”]; abcABC
65. •Insertion at the beginning [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents defghi abc
66. •Insertion at the beginning [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents ABC defghi abc
67. •Insertion at the beginning [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents defghi abc ABC
68. •Cross-run replacement [string replaceCharactersInRange:NSMakeRange(2, 3) withString:@”ABC”]; Replacement rule samples Modifying String Contents ab de c fghi
69. •Cross-run replacement [string replaceCharactersInRange:NSMakeRange(2, 3) withString:@”ABC”]; Replacement rule samples Modifying String Contents ABC ab de c fghi
70. •Cross-run replacement [string replaceCharactersInRange:NSMakeRange(2, 3) withString:@”ABC”]; Replacement rule samples Modifying String Contents abABCfghi
71. •No character, no attributes [string deleteCharactersInRange:NSMakeRange(0, 9)]; [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents abcdefghi
72. •No character, no attributes [string deleteCharactersInRange:NSMakeRange(0, 9)]; [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents abcdefghi •No character, no attributes [string deleteCharactersInRange:NSMakeRange(0, 9)]; [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”];
73. •No character, no attributes [string deleteCharactersInRange:NSMakeRange(0, 9)]; [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents
74. •No character, no attributes [string deleteCharactersInRange:NSMakeRange(0, 9)]; [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”]; Replacement rule samples Modifying String Contents ABC [string replaceCharactersInRange:NSMakeRange(0, 0) withString:@”ABC”];
75. Querying Attributes •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range;
76. Querying Attributes •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range;
77. Querying Attributes •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range;
78. Querying Attributes Not guaranteed to return the maximum range •An attribute dictionary per character - (NSString *)string - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range;
79. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; Querying Attributes abcdefghi
80. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; Querying Attributes abcdefghi
81. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; Querying Attributes abcdefghi NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range];
82. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; Querying Attributes abcdefghi
83. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; Querying Attributes abcdefghi &range
84. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; Querying Attributes abcdefghi &range {3, 3}
85. •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; Querying Attributes abcdefghi &range {4, 2}
86. NSRange range; NSDictionary *dict = [string attributesAtIndex:4 effectiveRange:&range]; •An attribute dictionary per character - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range; Querying Attributes abcdefghi &range {4, 1}
87. Using longest effective range methods Getting Contiguous Run Range •Variants of attribute query methods - (NSDictionary *)attributesAtIndex:(NSUInteger)location ! ! ! ! longestEffectiveRange:(NSRangePointer)range inRange:(NSRange)maximumRange; - (id)attribute:(NSString)attribute atIndex:(NSUInteger)location ! ! ! ! longestEffectiveRange:(NSRangePointer)range inRange:(NSRange)maximumRange;
88. Using longest effective range methods Getting Contiguous Run Range •Getting the contiguous range for attributes abcdefghi
89. Using longest effective range methods Getting Contiguous Run Range •Getting the contiguous range for attributes abcdefghi
90. •Getting the contiguous range for attributes abcdefghi Using longest effective range methods Getting Contiguous Run Range
91. •Getting the contiguous range for attributes abcdefghi Using longest effective range methods Getting Contiguous Run Range Helvetica Neue Red
92. •Getting the contiguous range for attributes abcdefghi Using longest effective range methods Getting Contiguous Run Range Helvetica Neue Blue
93. •Getting the contiguous range for attributes abcdefghi Using longest effective range methods Getting Contiguous Run Range Helvetica Neue Italic Blue
94. abcdefghi •Getting the contiguous range for attributes Using longest effective range methods Getting Contiguous Run Range Helvetica Neue Italic Green
95. abcdefghi •Getting the contiguous range for NSFontAttributeName Using longest effective range methods Getting Contiguous Run Range
96. abcdefghi •Getting the contiguous range for NSFontAttributeName Using longest effective range methods Getting Contiguous Run Range Helvetica Neue
97. abcdefghi •Getting the contiguous range for NSFontAttributeName Using longest effective range methods Getting Contiguous Run Range Helvetica Neue Italic
98. abcdefghi •Getting the contiguous range for NSForegroundColorAttributeName Using longest effective range methods Getting Contiguous Run Range
99. abcdefghi •Getting the contiguous range for NSForegroundColorAttributeName Using longest effective range methods Getting Contiguous Run Range Red
100. abcdefghi •Getting the contiguous range for NSForegroundColorAttributeName Using longest effective range methods Getting Contiguous Run Range Blue
101. abcdefghi •Getting the contiguous range for NSForegroundColorAttributeName Using longest effective range methods Getting Contiguous Run Range Green
102. Querying Attributes
103. •Enumeration methods -enumerateAttributesInRange:options:usingBlock: -enumerateAttribute:inRange:options:usingBlock: Querying Attributes
104. •Enumeration methods -enumerateAttributesInRange:options:usingBlock: -enumerateAttribute:inRange:options:usingBlock: •Changing attributes based on existing attributes Querying Attributes
105. •Enumeration methods -enumerateAttributesInRange:options:usingBlock: -enumerateAttribute:inRange:options:usingBlock: •Changing attributes based on existing attributes •Modifying string contents while preserving the attributes Querying Attributes
106. •Enumeration methods -enumerateAttributesInRange:options:usingBlock: -enumerateAttribute:inRange:options:usingBlock: •Changing attributes based on existing attributes •Modifying string contents while preserving the attributes •Modifying string contents while preserving the attributes Querying Attributes
107. Uppercase while preserving attributes Enumerating for Modification NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; abcdefghi abcdefghi
108. Uppercase while preserving attributes Enumerating for Modification NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; abcdefghi abcdefghi
109. Uppercase while preserving attributes Enumerating for Modification NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; abcdefghi abcdefghi
110. Uppercase while preserving attributes Enumerating for Modification NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; abcdefghi abcdefghi
111. Uppercase while preserving attributes Enumerating for Modification NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; uppercaseStringWithLocale: abcdefghi abcdefghi
112. Uppercase while preserving attributes Enumerating for Modification NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; abcdefghi abcdefghi
113. NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; Uppercase while preserving attributes Enumerating for Modification ABCdefghi
114. NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; Uppercase while preserving attributes Enumerating for Modification ABCDEfghi
115. NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; Uppercase while preserving attributes Enumerating for Modification ABCDEFghi
116. NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; Uppercase while preserving attributes Enumerating for Modification ABCDEFGHI
117. NSMutableAttributedString *attrString; NSLocale *locale = [NSLocale currentLocale]; [attrString enumerateAttributesInRange:NSMakeRange(0, [attrString length]) ! options:0 ! usingBlock:^(NSDictionary *attrs, NSRange range, BOOL *stop) { ! ! NSString *string = [[attrString string] substringWithRange:range]; ! ! [attrString replaceCharactersInRange:range ! ! ! ! ! withString:[string uppercaseStringWithLocale:locale]]; }]; Uppercase while preserving attributes Enumerating for Modification ABCDEFGHI
118. Drawing Attributed Strings
119. NSAttributedString *string = [[NSAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; Drawing an Attributed String
120. NSAttributedString *string = [[NSAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSFontAttributeName : [UIFont systemFontOfSize:12.0f }]; Drawing an Attributed String [string drawAtPoint:NSMakePoint(10.0f, 10.0f)]; // rendering at 10,10
121. NSStringDrawing API •Simple drawing/sizing methods - (void)drawInRect:(CGRect)rect; - (void)drawAtPoint:(CGPoint)point; - (CGSize)size; •Extended drawing/sizing methods - (void)drawWithRect:(CGRect)rect ! options:(NSStringDrawingOptions)options ! context:(NSStringDrawingContext *)context; - (CGRect)boundingRectWithSize:(CGSize)size ! options:(NSStringDrawingOptions)options ! context:(NSStringDrawingContext *)context;
122. NSStringDrawing API •Simple drawing/sizing methods - (void)drawAtPoint:(CGPoint)point; - (CGSize)size; - (void)drawInRect:(CGRect)rect;
123. NSStringDrawing API •Simple drawing/sizing methods - (void)drawAtPoint:(CGPoint)point; - (CGSize)size; - (void)drawInRect:(CGRect)rect;
124. NSStringDrawing API •Simple drawing/sizing methods - (void)drawInRect:(CGRect)rect; ! -drawInRect:withFont:lineBreakMode:alignment: - (void)drawAtPoint:(CGPoint)point; - (CGSize)size;
125. NSStringDrawing API •Simple drawing/sizing methods - (void)drawInRect:(CGRect)rect; - (void)drawAtPoint:(CGPoint)point; ! -drawAtPoint:withFont: - (CGSize)size;
126. NSStringDrawing API •Simple drawing/sizing methods - (void)drawInRect:(CGRect)rect; - (void)drawAtPoint:(CGPoint)point; - (CGSize)size; ! -sizeWithFont:
127. Available Attributes •Font •Text color •Paragraph style •Text background color •Ligature, kerning, and baseline offset •Underline and strike-through •Stroke width and color •Shadow
128. Available Attributes •Font •Text color •Paragraph style •Text background color •Ligature, kerning, and baseline offset •Underline and strike-through •Stroke width and color •Shadow
129. •Font NSFontAttributeName (UIFont) •Text color! ! ! ! NSForegroundColorAttributeName (UIColor) •Paragraph style NSParagraphStyleAttributeName (NSParagraphStyle) Available Attributes
130. •Font NSFontAttributeName (UIFont) •Text color! ! ! ! NSForegroundColorAttributeName (UIColor) •Paragraph style NSParagraphStyleAttributeName (NSParagraphStyle) Available Attributes A missing attribute implies its default value.
131. Attribute default value Available Attributes •Font [UIFont systemFontOfSize:[UIFont systemFontSize]] •Text color! ! ! ! [UIColor blackColor] •Paragraph style [NSParagraphStyle defaultParagraphStyle]
132. Quartz graphics state independent Missing Attributes NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point];
133. Quartz graphics state independent Missing Attributes NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point];
134. Quartz graphics state independent Missing Attributes NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point]; NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point];
135. Quartz graphics state independent Missing Attributes NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point];
136. Quartz graphics state independent Missing Attributes NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point];
137. Quartz graphics state independent Missing Attributes NSAttributedString *string; // No attribute specified string = [[NSAttributedString alloc] initWithString:@”Hello World!!”]; // Leaving CGContext color properties with red color [[UIColor redColor] set]; UIRectFill(rect); [string drawAtPoint:point]; Hello World!! // Renders with system font in black
138. Available Attributes •Font NSFontAttributeName (UIFont) •Text color! ! ! ! NSForegroundColorAttributeName (UIColor) •Paragraph style NSParagraphStyleAttributeName (NSParagraphStyle)
139. Available Attributes •Font NSFontAttributeName (UIFont) •Text color! ! ! ! NSForegroundColorAttributeName (UIColor) •Paragraph style NSParagraphStyleAttributeName (NSParagraphStyle)
140. NSParagraphStyle Layout Text Like Pages Documents
141. NSParagraphStyle Layout Text Like Pages Documents •Encapsulates various paragraph-wide style attributes
142. NSParagraphStyle Layout Text Like Pages Documents •Encapsulates various paragraph-wide style attributes •Allows richer word processor like text formatting
143. NSParagraphStyle Layout Text Like Pages Documents •Encapsulates various paragraph-wide style attributes •Allows richer word processor like text formatting •The paragraph style for the first character is used for the rest of paragraph
144. NSParagraphStyle Layout Text Like Pages Documents •Encapsulates various paragraph-wide style attributes •Allows richer word processor like text formatting •The paragraph style for the first character is used for the rest of paragraph
145. NSParagraphStyle •Line break mode •Alignment •Spacings •Indentation •Line height control •Hyphenation •Base writing direction
146. NSParagraphStyle •Line break mode •Alignment •Spacings •Indentation •Line height control •Hyphenation •Base writing direction
147. Line break mode NSParagraphStyle •Very similar to UILineBreakMode @property NSLineBreakMode lineBreakMode; NSMutableParagraphStyle *style = [[NSMutableParagraphStyle alloc] init]; style.lineBreakMode = NSLineBreakByTruncatingTail; NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSParagraphStyleAttributeName : style }];
148. Line break mode NSParagraphStyle •Very similar to UILineBreakMode @property NSLineBreakMode lineBreakMode; NSMutableParagraphStyle *style = [[NSMutableParagraphStyle alloc] init]; style.lineBreakMode = NSLineBreakByTruncatingTail; NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSParagraphStyleAttributeName : style }];
149. Line break mode NSParagraphStyle •Very similar to UILineBreakMode @property NSLineBreakMode lineBreakMode; NSMutableParagraphStyle *style = [[NSMutableParagraphStyle alloc] init]; style.lineBreakMode = NSLineBreakByTruncatingTail; NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSParagraphStyleAttributeName : style }];
150. Line break mode NSParagraphStyle •Very similar to UILineBreakMode @property NSLineBreakMode lineBreakMode; NSMutableParagraphStyle *style = [[NSMutableParagraphStyle alloc] init]; style.lineBreakMode = NSLineBreakByTruncatingTail; NSMutableAttributedString *string = [[NSMutableAttributedString alloc] ! ! initWithString:@”Hello World!!” ! ! attributes:@{ NSParagraphStyleAttributeName : style }]; Hello Wor…
151. •Additional alignments introduced @property NSTextAlignment alignment; NSTextAlignmentLeft Alignment NSParagraphStyle Hello World!!
152. •Additional alignments introduced @property NSTextAlignment alignment; NSTextAlignmentLeft NSTextAlignmentCenter Alignment NSParagraphStyle Hello World!!
153. •Additional alignments introduced @property NSTextAlignment alignment; NSTextAlignmentLeft NSTextAlignmentCenter NSTextAlignmentRight Alignment NSParagraphStyle Hello World!!
154. •Additional alignments introduced @property NSTextAlignment alignment; NSTextAlignmentLeft NSTextAlignmentCenter NSTextAlignmentRight NSTextAlignmentJustified Alignment NSParagraphStyle This paragraph shows the new alignment mode, justification.
155. •Additional alignments introduced @property NSTextAlignment alignment; NSTextAlignmentLeft NSTextAlignmentCenter NSTextAlignmentRight NSTextAlignmentJustified NSTextAlignmentNatural Alignment NSParagraphStyle Hello World!!
156. •Additional alignments introduced @property NSTextAlignment alignment; NSTextAlignmentLeft NSTextAlignmentCenter NSTextAlignmentRight NSTextAlignmentJustified NSTextAlignmentNatural Alignment NSParagraphStyle !!!"#$"ا #&'()
157. Rest of drawing options Drawing Attributed Strings •Extended NSStringDrawing methods •Advanced attributes •…and more
158. Rest of drawing options Drawing Attributed Strings •Extended NSStringDrawing methods •Advanced attributes •…and more Advanced Attributed Strings for iOS Mission Thursday 10:15am
159. How do I get this stuff in my labels? Attributed Strings in UIKit Ian Baird Label Engineer
160. Attributed Strings in UIKit UILabel is the nexus of power
161. Attributed Strings in UIKit UILabel is the nexus of power I’m a UILabel with a title.
162. Attributed Strings in UIKit UILabel is the nexus of power I’m a UILabel with an attributed title.
163. UILabel Attributed Strings in UIKit •Existing properties
164. UILabel Attributed Strings in UIKit •Existing properties text Big red dog.
165. UILabel Attributed Strings in UIKit •Existing properties text font Big red dog.
166. UILabel Attributed Strings in UIKit •Existing properties text font textColor Big red dog.
167. UILabel Attributed Strings in UIKit •Existing properties text font textColor textAlignment Big red dog.
168. UILabel Attributed Strings in UIKit •Existing properties text font textColor textAlignment lineBreakMode Big red dog.
169. UILabel Attributed Strings in UIKit •Existing properties text font textColor textAlignment lineBreakMode shadowColor Big red dog.
170. UILabel Attributed Strings in UIKit •Existing properties text font textColor textAlignment lineBreakMode shadowColor shadowOffset Big red dog.
171. UILabel Attributed Strings in UIKit •New properties: attributedText minimumScaleFactor adjustsLetterSpacingToFitWidth
172. UILabel Attributed Strings in UIKit •New properties: attributedText minimumScaleFactor adjustsLetterSpacingToFitWidth Big red dog.
173. UILabel Attributed Strings in UIKit •New properties: attributedText Big red dog.
174. UILabel Attributed Strings in UIKit •New properties: attributedText minimumScaleFactor Big red …
175. UILabel Attributed Strings in UIKit •New properties: attributedText minimumScaleFactor adjustsLetterSpacingToFitWidth Big red dog.
176. UILabel Attributed Strings in UIKit •Deprecated property
177. UILabel Attributed Strings in UIKit •Deprecated property minimumFontSize
178. UILabel Attributed Strings in UIKit •Deprecated property minimumFontSize •Instead use
179. UILabel Attributed Strings in UIKit •Deprecated property minimumFontSize •Instead use minimumScaleFactor
180. UILabel Attributed Strings in UIKit
181. UILabel Attributed Strings in UIKit •Style properties apply style to entire attributed string, for example Big red dog.
182. UILabel Attributed Strings in UIKit •Style properties apply style to entire attributed string, for example font font: Helvetica Neue Big red dog.
183. UILabel Attributed Strings in UIKit •Style properties apply style to entire attributed string, for example font textColor Big red dog. textColor: red
184. UIButton Attributed Strings in UIKit •Existing method
185. UIButton Attributed Strings in UIKit •Existing method setTitle:forControlState: Touch Me
186. UIButton Attributed Strings in UIKit •Existing method setTitle:forControlState: •New method Touch Me
187. UIButton Attributed Strings in UIKit •Existing method setTitle:forControlState: •New method setAttributedTitle:forControlState: Touch Me
188. UIButton Attributed Strings in UIKit •Existing method setTitle:forControlState: •New method setAttributedTitle:forControlState: •Attributed title takes precedence Touch Me
189. Attributed Strings in UIKit UIPickerView
190. Attributed Strings in UIKit UIPickerView pickerView:titleForRow:forComponent:
191. Attributed Strings in UIKit UIPickerView pickerView:attributedTitleForRow:forComponent:
192. •Added properties UITextView Attributed Strings in UIKit
193. •Added properties attributedText UITextView Attributed Strings in UIKit
194. •Added properties attributedText allowsEditingTextAttributes UITextView Attributed Strings in UIKit
195. UITableView Attributed Strings in UIKit
196. UITableView Attributed Strings in UIKit •No new properties or methods
197. UITableView Attributed Strings in UIKit •No new properties or methods Just set attributedText on the cell or header view’s textLabel.
198. Demo Johannes Fortmann UIKit Engineer
199. Demo summary Attributed Strings in UIKit •Drawing text using attributed string drawInRect: •Enhancing existing labels NSMutableAttributedString, addAttribute:value:range: •Formatting paragraphs NSMutableParagraphStyle
200. Summary
201. Summary •Attributed string essentials
202. Summary •Attributed string essentials •Drawing and use
203. Summary •Attributed string essentials •Drawing and use •UIKit adoption
204. More information Jake Behrens UI Frameworks Evangelist behrens@apple.com Documentation UIKit Documentation https://developer.apple.com/library/ios Apple Developer Forums http://devforums.apple.com
205. Related Sessions Advanced Attributed Strings for iOS Mission Thursday 10:15am Keyboard Input in iOS Russian Hill Wednesday 2:00PM Core Text and Fonts Russian Hill Wednesday 4:30PM
206. Labs Attributed Strings & Text Lab Essentials Lab A Thursday 11:30AM
208. The last 3 slides after the logo are intentionally left blank for all presentations.
209. The last 3 slides after the logo are intentionally left blank for all presentations.
210. The last 3 slides after the logo are intentionally left blank for all presentations.