-
2 |
- aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa aaa
3 |
-
4 |
- bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb 5 |
7 |
Custom Subviews
2 |Hyperlinks are implemented via attaching a custom button over glyph runs that make up a hyperlink. Multiple glyph runs in the same line are merged for one single subview. A hyperlink wrapping over several lines are multiple buttons which are linked via a GUID so that they highlight together
3 |Here's an example involving multiple gylph runs resulting from Chinese characters:
4 | Here are some chinese Glyphs #草原牧马# 草原 making up a hyperlink that also wraps over two lines bla bla bla bla bla bla bla bla bla bla bla bla
Follow @cocoanetics on Twitter
6 | -------------------------------------------------------------------------------- /Core/Source/NSScanner+HTML.h: -------------------------------------------------------------------------------- 1 | // 2 | // NSScanner+HTML.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/12/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | //#import "DTColor+HTML.h" 10 | 11 | @class DTColor; 12 | 13 | @interface NSScanner (HTML) 14 | 15 | - (BOOL)scanHTMLTag:(NSString **)tagName attributes:(NSDictionary **)attributes isOpen:(BOOL *)isOpen isClosed:(BOOL *)isClosed; 16 | - (BOOL)scanDOCTYPE:(NSString **)contents; 17 | - (BOOL)scanCSSAttribute:(NSString **)name value:(NSString **)value; 18 | - (BOOL)scanCSSURL:(NSString **)urlString; 19 | 20 | - (BOOL)scanHTMLColor:(DTColor **)color; 21 | 22 | - (void)logPosition; 23 | 24 | @end 25 | 26 | -------------------------------------------------------------------------------- /Core/Source/DTTextBlock.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTTextBlock.h 3 | // DTCoreText 4 | // 5 | // Created by Oliver Drobnik on 04.03.12. 6 | // Copyright (c) 2012 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "DTCompatibility.h" 10 | 11 | /** 12 | Class that represents a block of text with attributes like padding or a background color. 13 | */ 14 | @interface DTTextBlock : NSObject 15 | 16 | /** 17 | The space to be applied between the layouted text and the edges of the receiver 18 | */ 19 | @property (nonatomic, assign) DTEdgeInsets padding; 20 | 21 | 22 | /** 23 | The background color to paint behind the text in the receiver 24 | */ 25 | @property (nonatomic, strong) DTColor *backgroundColor; 26 | 27 | 28 | @end 29 | -------------------------------------------------------------------------------- /Core/Source/DTWebVideoView.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTWebVideoView.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 8/5/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | 10 | 11 | @class DTTextAttachment; 12 | @class DTWebVideoView; 13 | 14 | @protocol DTWebVideoViewDelegateCore Text Bugs
2 |Bold for Chinese Glyphs
3 |This is a bug that was present before iOS 6, the Chinese glyphs in the following line would be bold if the locale was set to Chinese due to an incorrect entry in the global font cascade table. Filed as rdar://11262229
4 |English and 中文 -- Chinese characters
5 | 6 |Italic for Chinese Glyphs in Fallback
7 |东方盖饭
8 |东方盖饭
9 | 10 |Extra space above lines with whitespace glyphs
11 |Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla
12 |Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla Bla bla
-------------------------------------------------------------------------------- /Demo/Source/CoreTextDemoAppDelegate.m: -------------------------------------------------------------------------------- 1 | // 2 | // DemoAppDelegate.m 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/9/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "CoreTextDemoAppDelegate.h" 10 | #import "DemoSnippetsViewController.h" 11 | 12 | @implementation CoreTextDemoAppDelegate 13 | 14 | @synthesize window = _window; 15 | 16 | - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 17 | { 18 | // Create window 19 | _window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]]; 20 | 21 | // Create the view controller 22 | DemoSnippetsViewController *snippetsViewController = [[DemoSnippetsViewController alloc] init]; 23 | _navigationController = [[UINavigationController alloc] initWithRootViewController:snippetsViewController]; 24 | 25 | // Display the window 26 | _window.rootViewController = _navigationController; 27 | [_window makeKeyAndVisible]; 28 | 29 | return YES; 30 | } 31 | 32 | 33 | 34 | @end 35 | -------------------------------------------------------------------------------- /Core/Source/DTImage+HTML.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTImage+HTML.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/9/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #if TARGET_OS_IPHONE 10 | 11 | /** 12 | Category used to have the same method available for unit testing on Mac on iOS. 13 | */ 14 | @interface UIImage (HTML) 15 | 16 | /** 17 | Retrieve the NSData representation of a UIImage. Used to encode UIImages in DTTextAttachments. 18 | 19 | @returns The NSData representation of the UIImage instance receiving this message. Convenience method for UIImagePNGRepresentation(). 20 | */ 21 | - (NSData *)dataForPNGRepresentation; 22 | 23 | @end 24 | 25 | #else 26 | 27 | /** 28 | Category used to have the same method available for unit testing on Mac on iOS. 29 | */ 30 | @interface NSImage (HTML) 31 | 32 | 33 | /** 34 | Retrieve the NSData representation of a NSImage. 35 | 36 | @returns The NSData representation of the NSImage instance receiving this message. 37 | */ 38 | - (NSData *)dataForPNGRepresentation; 39 | 40 | @end 41 | 42 | #endif 43 | -------------------------------------------------------------------------------- /Demo/DemoApp-Info.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 |Video
2 |HTML5 Video
3 |This demonstrates support for the HTML5 VIDEO (once it gets implemented)
4 | 7 | 8 | 9 |To Do
10 |-
11 |
- Add Rotation when video in fullscreen - there's a bug causing the navigation bar to shift under the status bar if Rotation is enabled 12 |
- Support for the different kinds of attributes to map to properties of media player 13 |
- Hide text contained in recognized tags 14 |
YouTube in IFRAME
17 | -------------------------------------------------------------------------------- /Demo/Resources/Objects.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 6 | 7 | 8 | 9 |Custom Objects
10 |This demonstrates usage of the <object> tag for embedding your own views
11 |12 | or
13 |These views are writting in HTML like this:
14 |<object style="display:inline;margin-bottom:1em;" someColorParameter="red" width=100 height=20></object>15 |
You provide your own custom view in the -attributedTextContentView:viewForAttachment:frame: method.
16 |if (attachment.contentType == DTTextAttachmentTypeObject)
17 | {
18 | // somecolorparameter has a HTML color
19 | UIColor *someColor = [UIColor colorWithHTMLName:[attachment.attributes objectForKey:@"somecolorparameter"]];
20 |
21 | UIView *someView = [[UIView alloc] initWithFrame:frame];
22 | someView.backgroundColor = someColor;
23 | someView.layer.borderWidth = 1;
24 | someView.layer.borderColor = [UIColor blackColor].CGColor;
25 |
26 | return someView;
27 | }
28 |
--------------------------------------------------------------------------------
/DTCoreText.podspec:
--------------------------------------------------------------------------------
1 | Pod::Spec.new do |spec|
2 | spec.name = 'DTCoreText'
3 | spec.version = '1.0.2'
4 | spec.platform = :ios
5 | spec.license = 'BSD'
6 | spec.source = { :git => 'https://github.com/Cocoanetics/DTCoreText.git', :tag => '1.0.2' }
7 | spec.source_files = 'Core/Source/*.{h,m,c}'
8 | spec.frameworks = 'MediaPlayer', 'QuartzCore', 'CoreText', 'CoreGraphics', 'ImageIO'
9 | spec.requires_arc = true
10 | spec.homepage = 'https://github.com/Cocoanetics/DTCoreText'
11 | spec.summary = 'Methods to allow using HTML code with CoreText.'
12 | spec.author = { 'Oliver Drobnik' => 'oliver@drobnik.com' }
13 | spec.library = 'xml2'
14 | spec.xcconfig = { 'HEADER_SEARCH_PATHS' => '"$(SDKROOT)/usr/include/libxml2"' }
15 | def spec.post_install(target)
16 | prefix_header = config.project_pods_root + target.prefix_header_filename
17 | prefix_header.open('a') do |file|
18 | file.puts(%{#ifdef __OBJC__\n#import Newline Spaces and BaseURL Handling
2 |This HTML has text beginning after ending tags on new lines. These need to turn into spaces. Also the HTML links are relative links, this tests if they get turned into links relative to the supplied BaseURL
3 |The remarkable view 5 | follows the locations of this galaxy's 6 | once and future stars. 8 | 9 | In reddish hues, image data from the large 10 | Herschel infrared 11 | observatory traces enormous lanes of dust, 12 | warmed by stars, sweeping along Andromeda's spiral arms. 13 | 14 | The dust, in conjunction with the galaxy's interstellar gas, 15 | comprises the raw material for future 16 | star formation. 17 | 18 | X-ray data from the XMM-Newton 19 | observatory in blue 20 | pinpoint Andromeda's X-ray binary 21 | star systems. 22 | 23 | These systems likely contain neutron stars or stellar mass 24 | black holes that represent final stages in stellar evolution. 25 | 26 | More than twice the size of our own Milky Way, 27 | the Andromeda Galaxy is over 200,000 light-years across.
-------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Copyright (c) 2011, Oliver Drobnik All rights reserved. 2 | 3 | Redistribution and use in source and binary forms, with or without 4 | modification, are permitted provided that the following conditions are met: 5 | 6 | - Redistributions of source code must retain the above copyright notice, this 7 | list of conditions and the following disclaimer. 8 | 9 | - Redistributions in binary form must reproduce the above copyright notice, 10 | this list of conditions and the following disclaimer in the documentation 11 | and/or other materials provided with the distribution. 12 | 13 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 14 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 16 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 17 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 19 | SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 20 | CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 21 | OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 22 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 23 | -------------------------------------------------------------------------------- /Core/Source/DTCompatibility.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTCompatibility.h 3 | // DTCoreText 4 | // 5 | // Created by Oliver Letterer on 09.04.12. 6 | // Copyright (c) 2012 Drobnik.com. All rights reserved. 7 | // 8 | 9 | // DTColor is UIColor on iOS, NSColor on Mac 10 | #if TARGET_OS_IPHONE 11 | @compatibility_alias DTColor UIColor; 12 | #else 13 | @compatibility_alias DTColor NSColor; 14 | #endif 15 | 16 | // DTImage is UIImage on iOS, NSImage on Mac 17 | #if TARGET_OS_IPHONE 18 | @compatibility_alias DTImage UIImage; 19 | #else 20 | @compatibility_alias DTImage NSImage; 21 | #endif 22 | 23 | // DTEdgeInsets is UIEdgeInsets on iOS, NSEdgeInsets on Mac 24 | #if TARGET_OS_IPHONE 25 | #define DTEdgeInsets UIEdgeInsets 26 | #define DTEdgeInsetsMake(a, b, c, d) UIEdgeInsetsMake(a, b, c, d) 27 | #else 28 | #define DTEdgeInsets NSEdgeInsets 29 | #define DTEdgeInsetsMake(a, b, c, d) NSEdgeInsetsMake(a, b, c, d) 30 | 31 | // These may be out of place here. Feel free to move them! 32 | // Sourced from https://github.com/andrep/RMModelObject 33 | static inline NSString* NSStringFromCGRect(const CGRect rect) 34 | { 35 | return NSStringFromRect(NSRectFromCGRect(rect)); 36 | } 37 | 38 | static inline NSString* NSStringFromCGSize(const CGSize size) 39 | { 40 | return NSStringFromSize(NSSizeFromCGSize(size)); 41 | } 42 | 43 | static inline NSString* NSStringFromCGPoint(const CGPoint point) 44 | { 45 | return NSStringFromPoint(NSPointFromCGPoint(point)); 46 | } 47 | #endif 48 | -------------------------------------------------------------------------------- /Core/Source/DTLinkButton.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTLinkButton.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/16/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | /** 10 | Constant for highlighting notification 11 | */ 12 | 13 | extern NSString *DTLinkButtonDidHighlightNotification; 14 | 15 | /** 16 | A button that corresponds to a hyperlink. 17 | 18 | Multiple parts of the same hyperlink synchronize their looks through the guid. 19 | */ 20 | @interface DTLinkButton : UIButton 21 | 22 | 23 | /** 24 | The URL that this button corresponds to. 25 | */ 26 | @property (nonatomic, copy) NSURL *URL; 27 | 28 | 29 | /** 30 | The unique identifier (GUID) that all parts of the same hyperlink have in common. 31 | */ 32 | @property (nonatomic, copy) NSString *GUID; 33 | 34 | 35 | /** 36 | The minimum size that the receiver should respond on hits with. Adjusts the bounds if they are smaller than the passed size. 37 | */ 38 | @property (nonatomic, assign) CGSize minimumHitSize; 39 | 40 | 41 | /** 42 | A Boolean value that determines whether tapping the button causes it to show a gray rounded rectangle. Default is YES. 43 | */ 44 | @property(nonatomic) BOOL showsTouchWhenHighlighted; 45 | 46 | /** 47 | The attributed string to be drawn for the link button. 48 | */ 49 | @property (nonatomic, retain) NSAttributedString *attributedString; 50 | 51 | 52 | /** 53 | The attributed string to be drawn for the link button while it is highlighted. 54 | */ 55 | @property (nonatomic, retain) NSAttributedString *highlightedAttributedString; 56 | 57 | @end 58 | -------------------------------------------------------------------------------- /Core/Source/NSString+Paragraphs.m: -------------------------------------------------------------------------------- 1 | // 2 | // NSString+Paragraphs.m 3 | // DTRichTextEditor 4 | // 5 | // Created by Oliver Drobnik on 11/11/11. 6 | // Copyright (c) 2011 Cocoanetics. All rights reserved. 7 | // 8 | 9 | #import "NSString+Paragraphs.h" 10 | 11 | @implementation NSString (Paragraphs) 12 | 13 | - (NSRange)rangeOfParagraphsContainingRange:(NSRange)range parBegIndex:(NSUInteger *)parBegIndex parEndIndex:(NSUInteger *)parEndIndex 14 | { 15 | // get beginning and end of paragraph containing the replaced range 16 | CFIndex beginIndex; 17 | CFIndex endIndex; 18 | 19 | CFStringGetParagraphBounds((__bridge CFStringRef)self, CFRangeMake(range.location, range.length), &beginIndex, &endIndex, NULL); 20 | 21 | if (parBegIndex) 22 | { 23 | *parBegIndex = beginIndex; 24 | } 25 | 26 | if (parEndIndex) 27 | { 28 | *parEndIndex = endIndex; 29 | } 30 | 31 | return NSMakeRange(beginIndex, endIndex - beginIndex); 32 | } 33 | 34 | - (BOOL)indexIsAtBeginningOfParagraph:(NSUInteger)index 35 | { 36 | // index zero is beginning of first paragraph 37 | if (!index) 38 | { 39 | return YES; 40 | } 41 | 42 | // beginning of any other paragraph is after NL 43 | if ([self characterAtIndex:index-1] == '\n') 44 | { 45 | return YES; 46 | } 47 | 48 | // no beginning 49 | return NO; 50 | } 51 | 52 | - (NSRange)rangeOfParagraphAtIndex:(NSUInteger)index 53 | { 54 | NSUInteger start; 55 | NSUInteger end; 56 | 57 | [self rangeOfParagraphsContainingRange:NSMakeRange(index, 1) parBegIndex:&start parEndIndex:&end]; 58 | 59 | return NSMakeRange(start, end-start); 60 | } 61 | 62 | @end 63 | -------------------------------------------------------------------------------- /Core/Source/DTCoreTextGlyphRun.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTCoreTextGlyphRun.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/25/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | 10 | 11 | #if TARGET_OS_IPHONE 12 | #importText Boxes
2 |Block-Level tags (like P or DIV) can have a padding and background color.
3 |Note: Only one level of boxing is properly supported. This is a crude workaround as CoreText does not support NSTextBlock on iOS.
4 |<p style="background-color:yellow;padding:20px;">...</p>5 |
By default the background is rectangle drawn for the entire width of the content view. There is a delegate method which you can override to do your own drawing. For example a stretchable UIImage. Or a rounded rectangle as shown here.
6 |7 | Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 8 |
9 |Some test cases
10 |Before the list with 10px padding
11 |-
12 |
- These items
- have a fixed line height of 50px
- Note: The line-height becomes the ascender. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
After the list with 25 px padding
14 | -------------------------------------------------------------------------------- /Core/Source/DTCoreText.h: -------------------------------------------------------------------------------- 1 | #if TARGET_OS_IPHONE 2 | #importLine Height
2 |This demonstrates setting of different line heights. Note: Internally this is achieved by setting the minimum and maximum line height in the paragraph style. The paragraph style line height multiplier is ignored.
3 |Relative Line Heights
4 |Font Size 25px; Line Height: normal
5 |Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg
6 |Font Size 25px; Line Height: 150%
7 |Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg
8 |Font Size 25px; Line Height: 2
9 |Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg
10 | 11 |Absolut Line Heights
12 | 13 |Font Size 25px; Line Height: 15px
14 |Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg
15 |Font Size 25px; Line Height: 25px
16 |Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg
17 |Font Size 25px; Line Height: 40px
18 |Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg Xg
19 | -------------------------------------------------------------------------------- /Core/Source/NSAttributedString+HTML.m: -------------------------------------------------------------------------------- 1 | // 2 | // NSAttributedString+HTML.m 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/9/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #if TARGET_OS_IPHONE 10 | #importSupported are all text alignment options via CSS text-align or the center tag.
3 |text-align: left, right, center, justify, inherit
4 | 5 |Examples
6 | 7 |Right
Left
8 | 9 |Non-Justified
10 |This is normal text, naturally aligned
11 |Proin lectus nisl, volutpat non aliquet id, suscipit sed est. Maecenas vitae metus eget nulla mattis bibendum a a dolor. Fusce vestibulum velit hendrerit nunc egestas non ullamcorper ipsum sagittis. Praesent dui sapien, egestas sed tincidunt vitae, posuere eu neque. Donec faucibus felis sed magna cursus in faucibus odio aliquam. Curabitur elit urna, ullamcorper ut placerat vitae, posuere sed nisl. Maecenas ac tellus nulla, a commodo purus. Suspendisse porta vulputate volutpat. Integer sodales turpis vitae ante sodales tempor. Cras iaculis accumsan ante, sed interdum sem faucibus vel. Aenean tincidunt eleifend elit at porta. Aenean sodales lacus quis lacus gravida consectetur. Sed at ligula ut diam porta auctor. Nunc libero mauris, feugiat id gravida sed, blandit non neque. Suspendisse ac mauris urna. Vivamus lacus ipsum, tincidunt nec laoreet quis, convallis id purus. Ut vehicula lobortis erat in viverra. Ut ut tellus eget ipsum malesuada dignissim. Donec quis dolor erat, id adipiscing ipsum. Donec vitae sagittis turpis. 12 |
13 | 14 |Justified
15 |Justified Text is ideal for articles and books because the left and right border appears visually the same
16 | 17 |Proin lectus nisl, volutpat non aliquet id, suscipit sed est. Maecenas vitae metus eget nulla mattis bibendum a a dolor. Fusce vestibulum velit hendrerit nunc egestas non ullamcorper ipsum sagittis. Praesent dui sapien, egestas sed tincidunt vitae, posuere eu neque. Donec faucibus felis sed magna cursus in faucibus odio aliquam. Curabitur elit urna, ullamcorper ut placerat vitae, posuere sed nisl. Maecenas ac tellus nulla, a commodo purus. Suspendisse porta vulputate volutpat. Integer sodales turpis vitae ante sodales tempor. Cras iaculis accumsan ante, sed interdum sem faucibus vel. Aenean tincidunt eleifend elit at porta. Aenean sodales lacus quis lacus gravida consectetur. Sed at ligula ut diam porta auctor. Nunc libero mauris, feugiat id gravida sed, blandit non neque. Suspendisse ac mauris urna. Vivamus lacus ipsum, tincidunt nec laoreet quis, convallis id purus. Ut vehicula lobortis erat in viverra. Ut ut tellus eget ipsum malesuada dignissim. Donec quis dolor erat, id adipiscing ipsum. Donec vitae sagittis turpis. 18 |
19 | -------------------------------------------------------------------------------- /Core/Source/NSAttributedString+SmallCaps.m: -------------------------------------------------------------------------------- 1 | // 2 | // NSAttributedString+SmallCaps.m 3 | // DTCoreText 4 | // 5 | // Created by Oliver Drobnik on 31.01.12. 6 | // Copyright (c) 2012 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "NSAttributedString+SmallCaps.h" 10 | #import "DTCoreText.h" 11 | 12 | @implementation NSAttributedString (SmallCaps) 13 | 14 | + (NSAttributedString *)synthesizedSmallCapsAttributedStringWithText:(NSString *)text attributes:(NSDictionary *)attributes 15 | { 16 | id normalFont = [attributes objectForKey:(id)kCTFontAttributeName]; 17 | 18 | DTCoreTextFontDescriptor *smallerFontDesc = nil; 19 | 20 | if ([normalFont isKindOfClass:[UIFont class]]) 21 | { 22 | // UIKit Font 23 | UIFont *font = normalFont; 24 | 25 | CTFontRef ctFont = CTFontCreateWithName((__bridge CFStringRef)font.fontName, font.pointSize, NULL); 26 | 27 | smallerFontDesc = [DTCoreTextFontDescriptor fontDescriptorForCTFont:ctFont]; 28 | 29 | CFRelease(ctFont); 30 | } 31 | else 32 | { 33 | // CTFontRef 34 | smallerFontDesc = [DTCoreTextFontDescriptor fontDescriptorForCTFont:(__bridge CTFontRef)normalFont]; 35 | } 36 | 37 | smallerFontDesc.pointSize *= 0.7; 38 | CTFontRef smallerFont = [smallerFontDesc newMatchingFont]; 39 | 40 | NSMutableDictionary *smallAttributes = [attributes mutableCopy]; 41 | 42 | if (___useiOS6Attributes) 43 | { 44 | UIFont *uiFont = [UIFont fontWithCTFont:smallerFont]; 45 | 46 | [smallAttributes setObject:uiFont forKey:NSFontAttributeName]; 47 | 48 | CFRelease(smallerFont); 49 | } 50 | else 51 | { 52 | [smallAttributes setObject:CFBridgingRelease(smallerFont) forKey:(id)kCTFontAttributeName]; 53 | } 54 | 55 | NSMutableAttributedString *tmpString = [[NSMutableAttributedString alloc] init]; 56 | NSScanner *scanner = [NSScanner scannerWithString:text]; 57 | [scanner setCharactersToBeSkipped:nil]; 58 | 59 | NSCharacterSet *lowerCaseChars = [NSCharacterSet lowercaseLetterCharacterSet]; 60 | 61 | while (![scanner isAtEnd]) 62 | { 63 | NSString *part; 64 | 65 | if ([scanner scanCharactersFromSet:lowerCaseChars intoString:&part]) 66 | { 67 | part = [part uppercaseString]; 68 | NSAttributedString *partString = [[NSAttributedString alloc] initWithString:part attributes:smallAttributes]; 69 | [tmpString appendAttributedString:partString]; 70 | } 71 | 72 | if ([scanner scanUpToCharactersFromSet:lowerCaseChars intoString:&part]) 73 | { 74 | NSAttributedString *partString = [[NSAttributedString alloc] initWithString:part attributes:attributes]; 75 | [tmpString appendAttributedString:partString]; 76 | } 77 | } 78 | 79 | return tmpString; 80 | } 81 | 82 | @end 83 | -------------------------------------------------------------------------------- /Core/Source/DTCoreTextLayoutLine.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTCoreTextLayoutLine.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/24/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | 10 | #if TARGET_OS_IPHONE 11 | #importNSAttributedString HTML Additions
2 |Introduction
3 |This project aims to duplicate the methods present on Mac OSX which allow creation of NSAttributedString from HTML code. 4 | This is useful for drawing simple rich text - like this document - without having to use a UIWebView.
5 |
Hi! I'm Oliver and I appreciate your help!
7 |Features
8 |At present the following tags are supported:
9 |- Headers H1 - H6
- Paragraphs: P
- Bold: B, STRONG
- Italic: I, EM 10 |
- Underline U 11 |
- Superscript SUP and Subscript SUB, e.g. e = mc2 12 |
- Strike Out DEL, e.g.
Something Removedor STRIKE e.g.Something Striked
13 | - FONT (face,color and size 1-7) 14 |
- Horizontal Rule HR (coloring via background-color style, simplified) 15 |
- Hyperlinks A (Formatting only, clickable as custom view) 16 |
- Unordered Lists LI 17 |
- Ordered Lists OL
Currently attributes are inherited from enclosed tags via brute force. I don't know if this is accurate.
19 |Known Differences
20 |In many aspects DTCoreText is superior to the Mac version of generating NSAttributedStrings from HTML. These become apparent in the MacUnitTest where the output from both is directly compared. I am summarizing them here for references.
21 |In the following "Mac" means the initWithHTML: methods there, "DTCoreText" means DTCoreText's initWithHTML and/or DTHTMLAttributedStringBuilder
22 |-
23 |
- Mac does not support the video tag, DTCoreText does. 24 |
- DTCoreText is able to synthesize small caps by putting all characters in upper case and using a second smaller font for lowercase characters. 25 |
- I suspect that Mac makes use of the -webkit-margin-* CSS styles for spacing the paragraphs, DTCoreText only uses the -webkit-margin-bottom and margin-bottom at present. 26 |
- Mac supports CSS following addresses, e.g. "ul ul" to change the list style for stacked lists. DTCoreText does not support that and so list bullets stay the same for multiple levels. 27 |
Please Help!
30 |If you find brief test cases where the created NSAttributedString differs from the version on OSX please send them to us!
31 |Also there are many small things that you could help this project with. You can either implement these yourself or sponsor their development.
32 |Follow @cocoanetics on Twitter
33 |This code is covered by a BSD License. © 2011 Oliver Drobnik
-------------------------------------------------------------------------------- /Core/Source/NSString+HTML.h: -------------------------------------------------------------------------------- 1 | // 2 | // NSString+HTML.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/9/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | /** 10 | Methods for making HTML strings easier and quicker to handle. 11 | */ 12 | @interface NSString (HTML) 13 | 14 | /** 15 | Extract the numbers from this string and return them as an NSUInteger. 16 | @returns An NSUInteger of the number characters in this string. 17 | */ 18 | - (NSUInteger)integerValueFromHex; 19 | 20 | 21 | /** 22 | Test whether or not this string is numeric only. 23 | @returns If this string consists only of numeric characters 0-9. 24 | */ 25 | - (BOOL)isNumeric; 26 | 27 | 28 | /** 29 | Read through this string and store the numbers included, then divide them by 100 giving a percentage. 30 | @returns The numbers contained in this string, as a percentage. 31 | */ 32 | - (float)percentValue; 33 | 34 | 35 | /** 36 | Return a copy of this string with all whitespace characters replaced by space characters. 37 | @returns A copy of this string with only space characters for whitespace. 38 | */ 39 | - (NSString *)stringByNormalizingWhitespace; 40 | 41 | 42 | /** 43 | Determines if the first character of this string is in the parameter characterSet. 44 | @param characterSet The character set to compare the first character of this string against. 45 | @returns If the first character of this string is in character set. 46 | */ 47 | - (BOOL)hasPrefixCharacterFromSet:(NSCharacterSet *)characterSet; 48 | 49 | 50 | /** 51 | Determines if the last character of this string is in the parameter characterSet. 52 | @param characterSet The character set to compare the last character of this string against. 53 | @returns If the last character of this string is in the character set. 54 | */ 55 | - (BOOL)hasSuffixCharacterFromSet:(NSCharacterSet *)characterSet; 56 | 57 | 58 | /** 59 | Convert a string into a proper HTML string by converting special characters into HTML entities. For example: an ellipsis `…` is represented by the entity `…` in order to display it correctly across text encodings. 60 | @returns A string containing HTML that now uses proper HTML entities. 61 | */ 62 | - (NSString *)stringByAddingHTMLEntities; 63 | 64 | 65 | /** 66 | Convert a string from HTML entities into correct character representations using UTF8 encoding. For example: an ellipsis entity representy by `…` is converted into `…`. 67 | @returns A string without HTML entities, instead having the actual characters formerly represented by HTML entities. 68 | */ 69 | - (NSString *)stringByReplacingHTMLEntities; 70 | 71 | 72 | /** 73 | Create a globally unique identifier to uniquely identify something. Used to create a GUID, store it in a dictionary or other data structure and retrieve it to uniquely identifiy something. In DTLinkButton multiple parts of the same hyperlink synchronize their looks through the GUID. 74 | @returns GUID assigned to this string to easily and uniquely identify it.. 75 | */ 76 | + (NSString *)guid; 77 | 78 | @end 79 | -------------------------------------------------------------------------------- /Core/Source/DTHTMLElement.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTHTMLElement.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 4/14/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | @class DTCoreTextParagraphStyle; 10 | @class DTCoreTextFontDescriptor; 11 | @class DTTextAttachment; 12 | @class DTCSSListStyle; 13 | @class DTColor; 14 | 15 | typedef enum 16 | { 17 | DTHTMLElementDisplayStyleInline = 0, // default 18 | DTHTMLElementDisplayStyleNone, 19 | DTHTMLElementDisplayStyleBlock, 20 | DTHTMLElementDisplayStyleListItem, 21 | DTHTMLElementDisplayStyleTable, 22 | } DTHTMLElementDisplayStyle; 23 | 24 | typedef enum 25 | { 26 | DTHTMLElementFloatStyleNone = 0, 27 | DTHTMLElementFloatStyleLeft, 28 | DTHTMLElementFloatStyleRight 29 | } DTHTMLElementFloatStyle; 30 | 31 | typedef enum 32 | { 33 | DTHTMLElementFontVariantInherit = 0, 34 | DTHTMLElementFontVariantNormal, 35 | DTHTMLElementFontVariantSmallCaps 36 | } DTHTMLElementFontVariant; 37 | 38 | @interface DTHTMLElement : NSObjectImage Handling
2 |Some basic image handling has been implemented
3 |Inline
4 |So far 
images work inline, sitting on the line's baseline. There is a workaround in place that if an image is more than twice as high as the surrounding text it will be treated as it's own block.
Block
6 |There is a known issue with images as blocks, outside of p tags.
7 |
8 | An Image outside of P is treated as a paragraph
9 |The previous image has float style. As a Workaround a newline is added after it until we can support floating in the layouting. This is done if the inline image is more than 5 times as large as the current font pixel size. This should allow small inline images, like smileys to stay in line, while most float images would probably be larger than this.
Supported Attributes
11 |-
12 |
- width, height in pixels 13 |
- src with a local file path relative to the app bundle 14 |
Supported Image Formats
16 |According to Apple the following image formats are supported for use with UIImage:
17 |-
18 |
- png 19 |
- tif, tiff 20 |
- jpeg, jpg 21 |
- gif 22 |
- bmp, bmpf 23 |
- ico 24 |
- cur 25 |
- xbm 26 |
Vertical Alignment
28 |Limited support for the CSS vertical-align tag exists
29 |Baseline:
text-top:
text-bottom:
middle:
Data Source
34 |Base64 encoded data SRC is supported, for example this red dot: 
Another example:
41 |
42 | Remote Images
43 |Images can also be loaded from remote URLs, even without specifying a size in the HTML. The code demonstrates how to update the DTTextAttachment's display size after download and triggering a re-layout.
44 |
45 |
--------------------------------------------------------------------------------
/Core/Source/DTWebVideoView.m:
--------------------------------------------------------------------------------
1 | //
2 | // DTWebVideoView.m
3 | // CoreTextExtensions
4 | //
5 | // Created by Oliver Drobnik on 8/5/11.
6 | // Copyright 2011 Drobnik.com. All rights reserved.
7 | //
8 |
9 | #import "DTWebVideoView.h"
10 | #import "DTTextAttachment.h"
11 |
12 |
13 | @interface DTWebVideoView ()
14 |
15 | - (void)disableScrolling;
16 |
17 | @end
18 |
19 |
20 | @implementation DTWebVideoView
21 | {
22 | DTTextAttachment *_attachment;
23 |
24 | __unsafe_unretained id CSS Styles Support
2 |Currently CSS styling is supported inline in tags, and via simple rules.
3 |For example:
4 |<p style="color:red; font-size: 30px;text-decoration:underline;">Some fancy text</p>
5 |Some fancy text
6 |This way you can affect the way hyperlinks are decorated: @cocoanetics versus @cocoanetics
7 | 8 |CSS Rules
9 | 10 |One or more style blocks are merged into a style sheet. Multiple matching styles are combined in this order, later styles overriding earlier ones.
11 |-
12 |
- Tag Name 13 |
- Class Name (multiple classes possible) 14 |
- Class Name + Tag Name 15 |
- Tag ID 16 |
- Local Style attribute of Tag 17 |
Not yet implemented are pseudo-selectors (first child).
19 | 20 |Supported Attributes
21 |-
22 |
- color - names (red) or hex (#FF0000) or rbg rgb(255, 0, 0); 23 |
- decoration - underline, line-through 24 |
- font-size - specified in pixels (12px) 25 |
- font-family - to specify the postscript name of a family like Courier 26 |
- font-style - normal, inherit, italic, oblique 27 |
- font-weight - normal, bold 28 |
Font Families
31 |
32 |
38 | serif
33 |sans-serif
34 |monospace
35 |cursive
36 |fantasy
37 |Text Shadows
39 |The text-shadow property is supported.
40 |Text with Shadow
41 |Embossed
42 |Glowing
43 |Multiple Shadows
46 |Text with Shadow
47 |OUTLINE
48 | 49 |To Do
50 |-
51 |
- More robust mapping of font family to available fonts, support for fallback 52 |
- text-decoration - blink, overline 53 |
- font-variant - to support smallcaps
UITextView (iOS 6)
3 |You can generate attributed strings that work in UIKit, primarily UITextView and UILabel. You have to pass the DTUseiOS6Attributes option to the initWithHTMLData: method to enable iOS 6 compatible attributes. Note that these will only be used if actually running on a device with iOS 6 or higher.
4 |In the demo app the first tap displays the attributed string with the traditional CoreText and custom attributes in a DTCoreTextAttributedTextView. The new "iOS 6" tab on the right (only visible on iOS 6 or higher) displays the attributed string with iOS 6 compatible attributes in a UITextView." 5 | 6 |
Working Features
7 |
Normal Text, Strike Out, Underlined, Bold, Italic, SmallCapps
Setting a background color or changing the text color.
9 |The text-shadow property is supported. Only a single shadow is supported. If multiple shadows are set via CSS then only the first is used.
10 |Text with Shadow
11 |Embossed
12 |Glowing
13 |Multiple Shadows
16 |Lists work partially, because we have no access to the private tab stops property of NSParagraphStyle. This is causing some trouble on aligning "hanging" lines.
17 |-
18 |
- First item 19 |
- Second item 20 |
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed pulvinar sollicitudin tellus, vitae congue arcu condimentum ut. Fusce sagittis iaculis sem ut bibendum. Sed a ipsum purus, sit amet elementum diam. Fusce sapien sapien, cursus sit amet auctor sit amet, ultricies et lorem. 21 | 22 |
- You can also nest lists
23 |
-
24 |
- First nested item 25 |
- Second nested item 26 |
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed pulvinar sollicitudin tellus, vitae congue arcu condimentum ut. Fusce sagittis iaculis sem ut bibendum. Sed a ipsum purus, sit amet elementum diam. Fusce sapien sapien, cursus sit amet auctor sit amet, ultricies et lorem. 27 |
29 |
Known Issues
31 |Support for changing the line height is broken in iOS 6. As soon as you have more than one font in the attributed string the minimum and maximum line height attributes of the paragraph style are being ignored.
32 | 33 |Not Supported
34 |Hyperlinks are not supported. UITextView does not have the NSLink attribute Mac has and there is no delegate protocol to deal with clicking on links.
35 |Since there is no way to reserve extra space on a glyph there is no way to display custom views or inline images
36 |Horizontal Rule (hr) is not supported.
37 |Native lists and text boxes are private to NSParagraphStyle
38 |The tab stops list is also private in NSParagraphStyle, lists only work by using the first standard tab stop as list indent.
39 | 40 | -------------------------------------------------------------------------------- /Demo/Source/DemoSnippetsViewController.m: -------------------------------------------------------------------------------- 1 | // 2 | // DemoSnippetsViewController.m 3 | // CoreTextExtensions 4 | // 5 | // Created by Sam Soffes on 1/14/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "DemoSnippetsViewController.h" 10 | #import "DemoTextViewController.h" 11 | 12 | @implementation DemoSnippetsViewController 13 | 14 | #pragma mark NSObject 15 | 16 | - (id)init { 17 | if ((self = [super initWithStyle:UITableViewStyleGrouped])) { 18 | self.title = @"Snippets"; 19 | self.tabBarItem.image = [UIImage imageNamed:@"snippets.png"]; 20 | } 21 | return self; 22 | } 23 | 24 | #pragma mark UIViewController 25 | 26 | - (void)viewDidLoad { 27 | [super viewDidLoad]; 28 | 29 | // Load snippets from plist 30 | NSString *plistPath = [[NSBundle mainBundle] pathForResource:@"Snippets" ofType:@"plist"]; 31 | _snippets = [[NSArray alloc] initWithContentsOfFile:plistPath]; 32 | } 33 | 34 | 35 | - (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation { 36 | return YES; 37 | } 38 | 39 | #pragma mark UITableViewDataSource 40 | 41 | - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { 42 | return 1; 43 | } 44 | 45 | - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { 46 | return [_snippets count]; 47 | } 48 | 49 | - (void)configureCell:(DTAttributedTextCell *)cell forIndexPath:(NSIndexPath *)indexPath 50 | { 51 | NSDictionary *snippet = [_snippets objectAtIndex:indexPath.row]; 52 | 53 | NSString *title = [snippet objectForKey:@"Title"]; 54 | NSString *description = [snippet objectForKey:@"Description"]; 55 | 56 | NSString *html = [NSString stringWithFormat:@"%@
%@
", title, description]; 57 | 58 | [cell setHTMLString:html]; 59 | 60 | cell.attributedTextContextView.shouldDrawImages = YES; 61 | } 62 | 63 | - (DTAttributedTextCell *)tableView:(UITableView *)tableView preparedCellForIndexPath:(NSIndexPath *)indexPath 64 | { 65 | static NSString *cellIdentifier = @"cellIdentifier"; 66 | 67 | if (!cellCache) 68 | { 69 | cellCache = [[NSCache alloc] init]; 70 | } 71 | 72 | // workaround for iOS 5 bug 73 | NSString *key = [NSString stringWithFormat:@"%d-%d", indexPath.section, indexPath.row]; 74 | 75 | DTAttributedTextCell *cell = [cellCache objectForKey:key]; 76 | 77 | if (!cell) 78 | { 79 | // reuse does not work for variable height 80 | //cell = (DTAttributedTextCell *)[tableView dequeueReusableCellWithIdentifier:cellIdentifier]; 81 | 82 | if (!cell) 83 | { 84 | cell = [[DTAttributedTextCell alloc] initWithReuseIdentifier:cellIdentifier accessoryType:UITableViewCellAccessoryDisclosureIndicator]; 85 | } 86 | 87 | // cache it 88 | [cellCache setObject:cell forKey:key]; 89 | } 90 | 91 | [self configureCell:cell forIndexPath:indexPath]; 92 | 93 | return cell; 94 | } 95 | 96 | // disable this method to get static height = better performance 97 | - (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath 98 | { 99 | DTAttributedTextCell *cell = (DTAttributedTextCell *)[self tableView:tableView preparedCellForIndexPath:indexPath]; 100 | 101 | return [cell requiredRowHeightInTableView:tableView]; 102 | } 103 | 104 | - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath 105 | { 106 | DTAttributedTextCell *cell = (DTAttributedTextCell *)[self tableView:tableView preparedCellForIndexPath:indexPath]; 107 | 108 | return cell; 109 | } 110 | 111 | #pragma mark UITableViewDelegate 112 | 113 | - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath 114 | { 115 | NSDictionary *rowSnippet = [_snippets objectAtIndex:indexPath.row]; 116 | 117 | DemoTextViewController *viewController = [[DemoTextViewController alloc] init]; 118 | viewController.fileName = [rowSnippet objectForKey:@"File"]; 119 | viewController.baseURL = [NSURL URLWithString:[rowSnippet objectForKey:@"BaseURL"]]; 120 | 121 | [self.navigationController pushViewController:viewController animated:YES]; 122 | } 123 | 124 | @end 125 | -------------------------------------------------------------------------------- /Core/Source/DTCSSListStyle.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTCSSListStyle.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 8/11/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | /** 10 | List Styles 11 | */ 12 | 13 | typedef enum 14 | { 15 | DTCSSListStyleTypeInherit = 0, 16 | DTCSSListStyleTypeNone, 17 | DTCSSListStyleTypeCircle, 18 | DTCSSListStyleTypeDecimal, 19 | DTCSSListStyleTypeDecimalLeadingZero, 20 | DTCSSListStyleTypeDisc, 21 | DTCSSListStyleTypeSquare, 22 | DTCSSListStyleTypeUpperAlpha, 23 | DTCSSListStyleTypeUpperLatin, 24 | DTCSSListStyleTypeLowerAlpha, 25 | DTCSSListStyleTypeLowerLatin, 26 | DTCSSListStyleTypePlus, 27 | DTCSSListStyleTypeUnderscore, 28 | DTCSSListStyleTypeImage, 29 | DTCSSListStyleTypeInvalid = NSIntegerMax 30 | } DTCSSListStyleType; 31 | 32 | /** 33 | List Marker Positions 34 | */ 35 | typedef enum 36 | { 37 | DTCSSListStylePositionInherit = 0, 38 | DTCSSListStylePositionInside, 39 | DTCSSListStylePositionOutside, 40 | DTCSSListStylePositionInvalid = NSIntegerMax 41 | } DTCSSListStylePosition; 42 | 43 | 44 | /** 45 | This class is the equivalent of `NSTextList` on Mac with the added handling of the marker position. 46 | */ 47 | @interface DTCSSListStyle : NSObject 48 | 49 | 50 | /** 51 | @name Getting Types from Strings 52 | */ 53 | 54 | /** 55 | Convert a string into a list style type. 56 | 57 | @param string The string to convert 58 | */ 59 | + (DTCSSListStyleType)listStyleTypeFromString:(NSString *)string; 60 | 61 | 62 | /** 63 | Convert a string into a marker position. 64 | 65 | @param string The string to convert 66 | */ 67 | + (DTCSSListStylePosition)listStylePositionFromString:(NSString *)string; 68 | 69 | /** 70 | @name Creating List Styles 71 | */ 72 | 73 | /** 74 | Creates a list style from the passed CSS style dictionary 75 | 76 | @param styles A CSS style dictionary from which the construct a suitable list style 77 | */ 78 | - (id)initWithStyles:(NSDictionary *)styles; 79 | 80 | /** 81 | @name Working with CSS Styles 82 | */ 83 | 84 | /** 85 | Update the receiver from the CSS styles dictionary passed 86 | 87 | @param styles A dictionary of CSS styles. 88 | */ 89 | - (void)updateFromStyleDictionary:(NSDictionary *)styles; 90 | 91 | 92 | /** 93 | @name Working with Prefixes 94 | */ 95 | 96 | 97 | /** 98 | Returns the prefix for lists of the receiver's settings. 99 | 100 | @param counter The counter value to use for ordered lists. 101 | @returns The prefix string to prepend to list items. 102 | */ 103 | - (NSString *)prefixWithCounter:(NSInteger)counter; 104 | 105 | 106 | /** 107 | @name Managing Item Numbering 108 | */ 109 | 110 | 111 | /** 112 | Sets the starting item number for the text list. 113 | 114 | The default value is `1`. This value will be used only for ordered lists, and ignored in other cases. 115 | 116 | @param itemNum The item number. 117 | */ 118 | - (void)setStartingItemNumber:(NSInteger)itemNum; 119 | 120 | 121 | /** 122 | Returns the starting item number for the text list. 123 | 124 | The default value is `1`. This value will be used only for ordered lists, and ignored in other cases. 125 | @returns The item number. 126 | */ 127 | - (NSInteger)startingItemNumber; 128 | 129 | 130 | /** 131 | @name Getting Information about Lists 132 | */ 133 | 134 | /** 135 | Returns if the receiver is an ordered or unordered list 136 | 137 | @returns `YES` if the receiver is ordered, `NO` if it is unordered 138 | */ 139 | - (BOOL)isOrdered; 140 | 141 | 142 | /** 143 | If the list style is inherited. 144 | 145 | @warn This is not implemented. 146 | */ 147 | @property (nonatomic, assign) BOOL inherit; 148 | 149 | 150 | /** 151 | The type of the text list 152 | */ 153 | @property (nonatomic, assign) DTCSSListStyleType type; 154 | 155 | 156 | /** 157 | The position of the marker in the prefix. 158 | */ 159 | @property (nonatomic, assign) DTCSSListStylePosition position; 160 | 161 | 162 | /** 163 | The image name to use for the marker 164 | */ 165 | @property (nonatomic, copy) NSString *imageName; 166 | 167 | 168 | @end 169 | -------------------------------------------------------------------------------- /Core/Source/DTAttributedTextCell.m: -------------------------------------------------------------------------------- 1 | // 2 | // DTAttributedTextCell.m 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 8/4/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "DTCoreText.h" 10 | #import "DTAttributedTextCell.h" 11 | #import "DTCSSStylesheet.h" 12 | 13 | @implementation DTAttributedTextCell 14 | { 15 | NSAttributedString *_attributedString; 16 | DTAttributedTextContentView *_attributedTextContextView; 17 | 18 | NSUInteger _htmlHash; // preserved hash to avoid relayouting for same HTML 19 | } 20 | 21 | - (id)initWithReuseIdentifier:(NSString *)reuseIdentifier accessoryType:(UITableViewCellAccessoryType)accessoryType 22 | { 23 | self = [super initWithStyle:UITableViewCellStyleDefault reuseIdentifier:reuseIdentifier]; 24 | if (self) 25 | { 26 | // don't know size jetzt because there's no string in it 27 | _attributedTextContextView = [[DTAttributedTextContentView alloc] initWithFrame:CGRectZero]; 28 | _attributedTextContextView.edgeInsets = UIEdgeInsetsMake(5, 5, 5, 5); 29 | [self.contentView addSubview:_attributedTextContextView]; 30 | } 31 | return self; 32 | } 33 | 34 | 35 | - (void)layoutSubviews 36 | { 37 | [super layoutSubviews]; 38 | 39 | CGFloat neededContentHeight = [self requiredRowHeightInTableView:(UITableView *)self.superview]; 40 | 41 | // after the first call here the content view size is correct 42 | CGRect frame = CGRectMake(0, 0, self.contentView.bounds.size.width, neededContentHeight); 43 | 44 | // only change frame if width has changed to avoid extra layouting 45 | if (_attributedTextContextView.frame.size.width != frame.size.width) 46 | { 47 | _attributedTextContextView.frame = frame; 48 | } 49 | } 50 | 51 | - (void)willMoveToSuperview:(UIView *)newSuperview 52 | { 53 | UITableView *tableView = (UITableView *)newSuperview; 54 | 55 | if (tableView.style == UITableViewStyleGrouped) 56 | { 57 | // need no background because otherwise this would overlap the rounded corners 58 | _attributedTextContextView.backgroundColor = [DTColor clearColor]; 59 | } 60 | 61 | [super willMoveToSuperview:newSuperview]; 62 | } 63 | 64 | - (CGFloat)requiredRowHeightInTableView:(UITableView *)tableView 65 | { 66 | 67 | CGFloat contentWidth = tableView.frame.size.width; 68 | 69 | // reduce width for accessories 70 | switch (self.accessoryType) 71 | { 72 | case UITableViewCellAccessoryDisclosureIndicator: 73 | case UITableViewCellAccessoryCheckmark: 74 | contentWidth -= 20.0f; 75 | break; 76 | case UITableViewCellAccessoryDetailDisclosureButton: 77 | contentWidth -= 33.0f; 78 | break; 79 | case UITableViewCellAccessoryNone: 80 | break; 81 | } 82 | 83 | // reduce width for grouped table views 84 | if (tableView.style == UITableViewStyleGrouped) 85 | { 86 | contentWidth -= 19; 87 | } 88 | 89 | CGSize neededSize = [_attributedTextContextView suggestedFrameSizeToFitEntireStringConstraintedToWidth:contentWidth]; 90 | 91 | // note: non-integer row heights caused trouble < iOS 5.0 92 | return neededSize.height; 93 | } 94 | 95 | #pragma mark Properties 96 | 97 | 98 | - (void)setSelected:(BOOL)selected animated:(BOOL)animated 99 | { 100 | [super setSelected:selected animated:animated]; 101 | 102 | // Configure the view for the selected state 103 | } 104 | 105 | - (void)setHTMLString:(NSString *)html 106 | { 107 | // we don't preserve the html but compare it's hash 108 | NSUInteger newHash = [html hash]; 109 | 110 | if (newHash == _htmlHash) 111 | { 112 | return; 113 | } 114 | 115 | _htmlHash = newHash; 116 | 117 | NSData *data = [html dataUsingEncoding:NSUTF8StringEncoding]; 118 | NSAttributedString *string = [[NSAttributedString alloc] initWithHTMLData:data documentAttributes:NULL]; 119 | self.attributedString = string; 120 | } 121 | 122 | - (void)setAttributedString:(NSAttributedString *)attributedString 123 | { 124 | if (_attributedString != attributedString) 125 | { 126 | _attributedString = attributedString; 127 | 128 | // passthrough 129 | _attributedTextContextView.attributedString = _attributedString; 130 | } 131 | } 132 | 133 | @synthesize attributedString = _attributedString; 134 | @synthesize attributedTextContextView = _attributedTextContextView; 135 | 136 | @end 137 | -------------------------------------------------------------------------------- /Core/Source/DTCoreTextLayouter.m: -------------------------------------------------------------------------------- 1 | // 2 | // DTCoreTextLayouter.m 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/24/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "DTCoreTextLayouter.h" 10 | 11 | @interface DTCoreTextLayouter () 12 | 13 | @property (nonatomic, strong) NSMutableArray *frames; 14 | @property (nonatomic, assign) dispatch_semaphore_t selfLock; 15 | 16 | - (CTFramesetterRef)framesetter; 17 | - (void)discardFramesetter; 18 | 19 | @end 20 | 21 | #define SYNCHRONIZE_START(obj) dispatch_semaphore_wait(selfLock, DISPATCH_TIME_FOREVER); 22 | #define SYNCHRONIZE_END(obj) dispatch_semaphore_signal(selfLock); 23 | 24 | @implementation DTCoreTextLayouter 25 | { 26 | CTFramesetterRef _framesetter; 27 | 28 | NSAttributedString *_attributedString; 29 | 30 | NSMutableArray *frames; 31 | } 32 | @synthesize selfLock; 33 | 34 | - (id)initWithAttributedString:(NSAttributedString *)attributedString 35 | { 36 | if ((self = [super init])) 37 | { 38 | if (!attributedString) 39 | { 40 | return nil; 41 | } 42 | 43 | selfLock = dispatch_semaphore_create(1); 44 | self.attributedString = attributedString; 45 | } 46 | 47 | return self; 48 | } 49 | 50 | - (void)dealloc 51 | { 52 | SYNCHRONIZE_START(self) // just to be sure 53 | [self discardFramesetter]; 54 | SYNCHRONIZE_END(self) 55 | 56 | dispatch_release(selfLock); 57 | } 58 | 59 | - (NSString *)description 60 | { 61 | return [self.frames description]; 62 | } 63 | 64 | - (NSInteger)numberOfFrames 65 | { 66 | return [self.frames count]; 67 | } 68 | 69 | - (CGSize)suggestedFrameSizeToFitEntireStringConstraintedToWidth:(CGFloat)width 70 | { 71 | // Note: this returns an unreliable measure prior to 4.2 for very long documents 72 | CGSize neededSize = CTFramesetterSuggestFrameSizeWithConstraints(self.framesetter, CFRangeMake(0, 0), NULL, 73 | CGSizeMake(width, CGFLOAT_MAX), 74 | NULL); 75 | 76 | // round up because generally we don't want non-integer view sizes 77 | neededSize.width = ceilf(neededSize.width); 78 | neededSize.height = ceilf(neededSize.height); 79 | 80 | return neededSize; 81 | } 82 | 83 | 84 | // a temporary frame 85 | - (DTCoreTextLayoutFrame *)layoutFrameWithRect:(CGRect)frame range:(NSRange)range 86 | { 87 | DTCoreTextLayoutFrame *newFrame; 88 | @autoreleasepool { 89 | newFrame = [[DTCoreTextLayoutFrame alloc] initWithFrame:frame layouter:self range:range]; 90 | }; 91 | return newFrame; 92 | } 93 | 94 | // reusable frame 95 | - (void)addTextFrameWithFrame:(CGRect)frame 96 | { 97 | DTCoreTextLayoutFrame *newFrame = [self layoutFrameWithRect:frame range:NSMakeRange(0, 0)]; 98 | [self.frames addObject:newFrame]; 99 | } 100 | 101 | - (DTCoreTextLayoutFrame *)layoutFrameAtIndex:(NSInteger)index 102 | { 103 | return [self.frames objectAtIndex:index]; 104 | 105 | } 106 | 107 | #pragma mark Properties 108 | - (CTFramesetterRef)framesetter 109 | { 110 | if (!_framesetter) // Race condition, could be null now but set when we get into the SYNCHRONIZE block - so do the test twice 111 | { 112 | SYNCHRONIZE_START(self) 113 | { 114 | if (!_framesetter) 115 | { 116 | _framesetter = CTFramesetterCreateWithAttributedString((__bridge CFAttributedStringRef)self.attributedString); 117 | } 118 | } 119 | SYNCHRONIZE_END(self) 120 | } 121 | return _framesetter; 122 | } 123 | 124 | 125 | - (void)discardFramesetter 126 | { 127 | { 128 | // framesetter needs to go 129 | if (_framesetter) 130 | { 131 | CFRelease(_framesetter); 132 | _framesetter = NULL; 133 | } 134 | } 135 | } 136 | 137 | - (void)setAttributedString:(NSAttributedString *)attributedString 138 | { 139 | SYNCHRONIZE_START(self) 140 | { 141 | if (_attributedString != attributedString) 142 | { 143 | _attributedString = attributedString; 144 | 145 | [self discardFramesetter]; 146 | } 147 | } 148 | SYNCHRONIZE_END(self) 149 | } 150 | 151 | - (NSAttributedString *)attributedString 152 | { 153 | return _attributedString; 154 | } 155 | 156 | - (NSMutableArray *)frames 157 | { 158 | if (!frames) 159 | { 160 | frames = [[NSMutableArray alloc] init]; 161 | } 162 | 163 | return frames; 164 | } 165 | 166 | 167 | 168 | @synthesize attributedString = _attributedString; 169 | @synthesize frames = _frames; 170 | @synthesize framesetter = _framesetter; 171 | 172 | @end 173 | -------------------------------------------------------------------------------- /Core/Source/default.css: -------------------------------------------------------------------------------- 1 | /* this file is processed with xxd via a build rule and embedded in library */ 2 | 3 | /* these styles come from Safari */ 4 | 5 | /* note that comments are only permitted before selectors and before the styles */ 6 | 7 | /* DO NOT fiddle with this file if you want to have your own styles, 8 | pass your own stylesheet via the option parameter to override these defaults */ 9 | 10 | html 11 | { 12 | /* bla */ 13 | display:block; 14 | } 15 | 16 | head 17 | { 18 | display:none; 19 | } 20 | 21 | title 22 | { 23 | display:none; 24 | } 25 | 26 | style 27 | { 28 | display:none; 29 | } 30 | 31 | body 32 | { 33 | /* safari has a 8 px margin here */ 34 | display:block; 35 | } 36 | 37 | article,aside,footer,header,hgroup,nav,section 38 | { 39 | display:block; 40 | } 41 | 42 | p 43 | { 44 | display:block; 45 | -webkit-margin-before:1em; 46 | -webkit-margin-after:1em; 47 | -webkit-margin-start:0; 48 | -webkit-margin-end:0; 49 | } 50 | 51 | ul,menu,dir 52 | { 53 | display:block; 54 | list-style-type:disc; 55 | -webkit-margin-before:1em; 56 | -webkit-margin-after:1em; 57 | -webkit-margin-start:0; 58 | -webkit-margin-end:0; 59 | -webkit-padding-start:27px; 60 | } 61 | 62 | li 63 | { 64 | display:list-item; 65 | } 66 | 67 | ol 68 | { 69 | display:block; 70 | list-style-type:decimal; 71 | -webkit-margin-before:1em; 72 | -webkit-margin-after:1em; 73 | -webkit-margin-start:0; 74 | -webkit-margin-end:0; 75 | -webkit-padding-start:27px; 76 | } 77 | 78 | ul ul, ol ul 79 | { 80 | list-style-type: circle; 81 | } 82 | 83 | ol ol ul, ol ul ul, ul ol ul, ul ul ul 84 | { 85 | list-style-type: square; 86 | } 87 | 88 | code 89 | { 90 | font-family:Courier; 91 | } 92 | 93 | pre 94 | { 95 | font-family:Courier; 96 | } 97 | 98 | /* color:-webkit-link */ 99 | a 100 | { 101 | color:#0000EE; 102 | text-decoration:underline; 103 | } 104 | 105 | center 106 | { 107 | text-align:center; 108 | display:block; 109 | } 110 | 111 | strong,b 112 | { 113 | font-weight:bolder; 114 | } 115 | 116 | i,em 117 | { 118 | font-style:italic; 119 | } 120 | 121 | u 122 | { 123 | text-decoration:underline; 124 | } 125 | 126 | big 127 | { 128 | font-size:bigger; 129 | } 130 | 131 | small 132 | { 133 | font-size:smaller; 134 | } 135 | 136 | sub 137 | { 138 | font-size:smaller; 139 | vertical-align:sub; 140 | } 141 | 142 | sup 143 | { 144 | font-size:smaller; 145 | vertical-align:super; 146 | } 147 | 148 | s,strike,del 149 | { 150 | text-decoration:line-through; 151 | } 152 | 153 | tt,code,kbd,samp 154 | { 155 | font-family:monospace; 156 | } 157 | 158 | pre,xmp,plaintext,listing 159 | { 160 | display:block; 161 | font-family:monospace; 162 | white-space:pre; 163 | margin-top:1em; 164 | margin-right:0; 165 | margin-bottom:1em; 166 | margin-left:0; 167 | } 168 | 169 | h1 170 | { 171 | display:block; 172 | font-size:2em; 173 | -webkit-margin-before:.67em; 174 | -webkit-margin-after:.67em; 175 | -webkit-margin-start:0; 176 | -webkit-margin-end:0; 177 | font-weight:bold; 178 | } 179 | 180 | h2 181 | { 182 | display:block; 183 | font-size:1.5em; 184 | -webkit-margin-before:.83em; 185 | -webkit-margin-after:.83em; 186 | -webkit-margin-start:0; 187 | -webkit-margin-end:0; 188 | font-weight:bold; 189 | } 190 | 191 | h3 192 | { 193 | display:block; 194 | font-size:1.17em; 195 | -webkit-margin-before:1em; 196 | -webkit-margin-after:1em; 197 | -webkit-margin-start:0; 198 | -webkit-margin-end:0; 199 | font-weight:bold; 200 | } 201 | 202 | h4 203 | { 204 | display:block; 205 | -webkit-margin-before:1.33em; 206 | -webkit-margin-after:1.33em; 207 | -webkit-margin-start:0; 208 | -webkit-margin-end:0; 209 | font-weight:bold; 210 | } 211 | 212 | h5 213 | { 214 | display:block; 215 | font-size:.83em; 216 | -webkit-margin-before:1.67em; 217 | -webkit-margin-after:1.67em; 218 | -webkit-margin-start:0; 219 | -webkit-margin-end:0; 220 | font-weight:bold; 221 | } 222 | 223 | h6 224 | { 225 | display:block; 226 | font-size:.67em; 227 | -webkit-margin-before:2.33em; 228 | -webkit-margin-after:2.33em; 229 | -webkit-margin-start:0; 230 | -webkit-margin-end:0; 231 | font-weight:bold; 232 | } 233 | 234 | div { 235 | display: block; 236 | } 237 | 238 | link { 239 | display: none; 240 | } 241 | 242 | meta { 243 | display: none; 244 | } 245 | 246 | script { 247 | display: none; 248 | } 249 | 250 | hr { 251 | display: block; 252 | -webkit-margin-before: 0.5em; 253 | -webkit-margin-after: 0.5em; 254 | -webkit-margin-start: auto; 255 | -webkit-margin-end: auto; 256 | border-style: inset; 257 | border-width: 1px; 258 | } 259 | 260 | table { 261 | display: table; 262 | border-collapse: separate; 263 | border-spacing: 2px; 264 | border-color: gray; 265 | } -------------------------------------------------------------------------------- /Core/Source/DTCoreTextFontCollection.m: -------------------------------------------------------------------------------- 1 | // 2 | // DTCoreTextFontCollection.m 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 5/23/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import "DTCoreTextFontCollection.h" 10 | #import "DTCoreTextFontDescriptor.h" 11 | 12 | #if TARGET_OS_IPHONE 13 | #importOne\ntwo\n
three
New Paragraph
Suffix"; 29 | NSAttributedString *string = [self attributedStringFromHTML:html]; 30 | 31 | NSData *dump = [[string string] dataUsingEncoding:NSUTF8StringEncoding]; 32 | NSString *resultOnIOS = [dump description]; 33 | 34 | NSString *resultOnMac = @"<50726566 69780a4f 6e652074 776f20e2 80a87468 7265650a 4e657720 50617261 67726170 680a5375 66666978>"; 35 | 36 | STAssertEqualObjects(resultOnIOS, resultOnMac, @"Output on Paragraph Test differs"); 37 | } 38 | 39 | 40 | - (void)testHeaderParagraphs 41 | { 42 | NSString *html = @"PrefixOne
One
One
One
One
New Paragraph
Suffix"; 43 | NSAttributedString *string = [self attributedStringFromHTML:html]; 44 | 45 | NSData *dump = [[string string] dataUsingEncoding:NSUTF8StringEncoding]; 46 | NSString *resultOnIOS = [dump description]; 47 | 48 | NSString *resultOnMac = @"<50726566 69780a4f 6e650a4f 6e650a4f 6e650a4f 6e650a4f 6e650a4e 65772050 61726167 72617068 0a537566 666978>"; 49 | 50 | STAssertEqualObjects(resultOnIOS, resultOnMac, @"Output on Paragraph Test differs"); 51 | } 52 | 53 | 54 | - (void)testListParagraphs 55 | { 56 | NSString *html = @"Before
- One
- Two
After
"; 57 | NSAttributedString *string = [self attributedStringFromHTML:html]; 58 | 59 | NSData *dump = [[string string] dataUsingEncoding:NSUTF8StringEncoding]; 60 | NSString *resultOnIOS = [dump description]; 61 | 62 | NSString *resultOnMac = @"<4265666f 72650a09 e280a209 4f6e650a 09e280a2 0954776f 0a416674 65720a>"; 63 | 64 | STAssertEqualObjects(resultOnIOS, resultOnMac, @"Output on List Test differs"); 65 | } 66 | 67 | - (void)testImageParagraphs 68 | { 69 | NSString *html = @"Before
![](\"Oliver.jpg\")
Header
after
Some inline text.
Now there is some bold\ntext and spaces\n should be normalized.
"; 83 | NSAttributedString *string = [self attributedStringFromHTML:html]; 84 | 85 | NSData *dump = [[string string] dataUsingEncoding:NSUTF8StringEncoding]; 86 | NSString *resultOnIOS = [dump description]; 87 | 88 | NSString *resultOnMac = @"<4e6f7720 74686572 65206973 20736f6d 6520626f 6c642074 65787420 616e6420 73706163 65732073 686f756c 64206265 206e6f72 6d616c69 7a65642e 0a>"; 89 | 90 | STAssertEqualObjects(resultOnIOS, resultOnMac, @"Output on List Test differs"); 91 | } 92 | 93 | - (void)testSpaceAndNewlines 94 | { 95 | NSString *html = @"bla\nfollows\nNSString *str = @\"The Quick Brown Fox Brown\";"; 96 | NSAttributedString *string = [self attributedStringFromHTML:html]; 97 | 98 | NSData *dump = [[string string] dataUsingEncoding:NSUTF8StringEncoding]; 99 | NSString *resultOnIOS = [dump description]; 100 | 101 | NSString *resultOnMac = @"<626c6120 666f6c6c 6f777320 4e535374 72696e67 202a7374 72203d20 40225468 65205175 69636b20 42726f77 6e20466f 78204272 6f776e22 3b>"; 102 | 103 | STAssertEqualObjects(resultOnIOS, resultOnMac, @"Output on List Test differs"); 104 | } 105 | 106 | - (void)testMissingClosingTagAndSpacing 107 | { 108 | NSString *html = @"image \n last"; 109 | NSAttributedString *string = [self attributedStringFromHTML:html]; 110 | 111 | NSData *dump = [[string string] dataUsingEncoding:NSUTF8StringEncoding]; 112 | NSString *resultOnIOS = [dump description]; 113 | 114 | NSString *resultOnMac = @"<696d6167 65206c61 7374>"; 115 | 116 | STAssertEqualObjects(resultOnIOS, resultOnMac, @"Output on Invalid Tag Test differs"); 117 | 118 | } 119 | 120 | 121 | - (void)testAttributedStringColorToHTML 122 | { 123 | NSMutableAttributedString *string = [[NSMutableAttributedString alloc]initWithString: @"test"]; 124 | 125 | UIColor *color = [ UIColor colorWithRed: 1.0 green: 0.0 blue: 0.0 alpha: 1.0 ]; 126 | 127 | [ string setAttributes: [ NSDictionary dictionaryWithObject: (id)color.CGColor forKey: (id)kCTForegroundColorAttributeName ] range: NSMakeRange(0, 2) ]; 128 | 129 | NSString *expected = @"test\n"; 130 | 131 | STAssertEqualObjects([ string htmlString ], expected, @"Output on HTML string color test differs"); 132 | } 133 | 134 | @end 135 | -------------------------------------------------------------------------------- /Core/Source/DTColor+HTML.h: -------------------------------------------------------------------------------- 1 | // 2 | // DTColor+HTML.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/9/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #if TARGET_OS_IPHONE 10 | 11 | /** 12 | Methods used to work with HTML representations of colors. 13 | */ 14 | @interface UIColor (HTML) 15 | 16 | /** 17 | Takes a CSS color string ('333', 'F9FFF9'), determines the RGB values used, and returns a UIColor object of that color. 18 | For each part of the RGB color those numbers for that color are converted to a number using a category on NSString. Then that number is divided by the maximum value, 15 for 3 character strings and 255 for 6 character strings, making the color a percentage and within the range 0.0 and 1.0 that UIColor uses. 19 | @param hex A CSS hexadecimal color string of length 6 or 3. 20 | @returns A UIColor object generated from the hexadecimal color string with alpha 1.0. 21 | */ 22 | + (UIColor *)colorWithHexString:(NSString *)hex; 23 | 24 | /** 25 | Takes an English string representing a color and maps it to a numeric RGB value as declared by the HTML and CSS specifications (see http://www.w3schools.com/html/html_colornames.asp). Also accepts CSS `#` hexadecimal colors, `rgba`, and `rgb` and does the right thing returning a corresponding UIColor. 26 | If a color begins with a `#` we know that it is a hexadecimal color and send it to colorWithHexString:. If the string is an `rgba()` color declaration the comma delimited r, g, b, and a values are made into percentages and then made into a UIColor which is returned. If the string is an `rgb()` color declaration the same process happens except with an alpha of 1.0. 27 | The last case is that the color string is not a numeric declaration `#`, nor a `rgba` or `rgb` declaration so the CSS color value matching the English string is found in a lookup dictionary and then passed to colorWithHexString: which will make a UIColor out of the hexadecimal string. 28 | @param name The CSS color string that we want to map from a name into an RGB color. 29 | @returns A UIColor object representing the name parameter as numeric values declared by the HTML and CSS specifications, a `rgba()` color, or a `rgb()` color. 30 | */ 31 | + (UIColor *)colorWithHTMLName:(NSString *)name; 32 | 33 | /** 34 | Return a string hexadecimal representation of this UIColor. Splits the color into components with CGColor methods, re-maps them from percentages to the range 0-255, and depending on the number of components returns a grayscale (repeating string of two characters) or color RGB (alpha is stripped) six character string. In the event of a non-2 or non-4 component color nil is returned as it is from an unsupported color space. 35 | @returns A CSS hexadecimal NSString specifying this UIColor. 36 | */ 37 | - (NSString *)htmlHexString; 38 | 39 | 40 | /** 41 | A quick method to return the alpha component of this UIColor by using the CGColorGetAlpha method. 42 | @returns The floating point alpha value of this UIColor. 43 | */ 44 | - (CGFloat)alphaComponent; 45 | 46 | @end 47 | 48 | #else 49 | 50 | /** 51 | Methods used to work with HTML representations of colors. 52 | */ 53 | @interface NSColor (HTML) 54 | 55 | 56 | /** 57 | Takes a CSS color string ('333', 'F9FFF9'), determines the RGB values used, and returns an NSColor object of that color. 58 | For each part of the RGB color those numbers for that color are converted to a number using a category on NSString. Then that number is divided by the maximum value, 15 for 3 character strings and 255 for 6 character strings, making the color a percentage and within the range 0.0 and 1.0 that NSColor uses. 59 | @param hex A CSS hexadecimal color string of length 6 or 3. 60 | @returns An NSColor object generated from the hexadecimal color string with alpha 1.0. 61 | */ 62 | + (NSColor *)colorWithHexString:(NSString *)hex; 63 | 64 | 65 | /** 66 | Takes an English string representing a color and maps it to a numeric RGB value as declared by the HTML and CSS specifications (see http://www.w3schools.com/html/html_colornames.asp). Also accepts CSS `#` hexadecimal colors, `rgba`, and `rgb` and does the right thing returning a corresponding NSColor. 67 | If a color begins with a `#` we know that it is a hexadecimal color and send it to colorWithHexString:. If the string is an `rgba()` color declaration the comma delimited r, g, b, and a values are made into percentages and then made into an NSColor which is returned. If the string is an `rgb()` color declaration the same process happens except with an alpha of 1.0. 68 | The last case is that the color string is not a numeric declaration `#`, nor a `rgba` or `rgb` declaration so the CSS color value matching the English string is found in a lookup dictionary and then passed to colorWithHexString: which will make an NSColor out of the hexadecimal string. 69 | @param name The CSS color string that we want to map from a name into an RGB color. 70 | @returns An NSColor object representing the name parameter as numeric values declared by the HTML and CSS specifications, a `rgba()` color, or a `rgb()` color. 71 | */ 72 | + (NSColor *)colorWithHTMLName:(NSString *)name; 73 | 74 | 75 | /** 76 | Return a string hexadecimal representation of this NSColor. Splits the color into components with CGColor methods, re-maps them from percentages in the range 0-255, and returns the RGB color (alpha is stripped) in a six character string. 77 | @returns A CSS hexadecimal NSString specifying this NSColor. 78 | */ 79 | - (NSString *)htmlHexString; 80 | 81 | #if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_7 82 | /** 83 | Converts a CGColorRef into an NSColor by placing each component into an NSColor and pending on the component count to return a grayscale or rgb color. If there are not 2 (grayscale) or 4 (rgba) components the color is from an unsupported color space and nil is returned. 84 | @param cgColor The CGColorRef to convert 85 | @returns An NSColor of this CGColorRef 86 | */ 87 | + (NSColor *)colorWithCGColor:(CGColorRef)cgColor; 88 | 89 | /** 90 | Converts an NSColor into a CGColorRef. 91 | @returns A CGColorRef of this NSColor 92 | */ 93 | - (CGColorRef)CGColor; 94 | #endif 95 | 96 | @end 97 | 98 | #endif 99 | -------------------------------------------------------------------------------- /Core/Source/DTAttributedTextContentView.h: -------------------------------------------------------------------------------- 1 | // 2 | // TextView.h 3 | // CoreTextExtensions 4 | // 5 | // Created by Oliver Drobnik on 1/9/11. 6 | // Copyright 2011 Drobnik.com. All rights reserved. 7 | // 8 | 9 | #import![last](\"http://sv.wikipedia.org/wiki/Fil:V%C3%A4dersoltavlan_cropped.JPG\"\n){kind=link}
10 |
11 |
12 | The project covers two broad areas:
13 |
14 | 1. Layouting - Interfacing with CoreText, generating NSAttributedString instances from HTML code
15 | 2. UI - several UI-related classes render these objects
16 |
17 | This is useful for drawing simple rich text like any HTML document without having to use a `UIWebView`.
18 |
19 | Please read the [Q&A](http://www.cocoanetics.com/2011/08/nsattributedstringhtml-qa/).
20 |
21 | Your help is much appreciated. Please send pull requests for useful additions you make or ask me what work is required.
22 |
23 | If you find brief test cases where the created `NSAttributedString` differs from the version on OSX please send them to us!
24 |
25 | Follow [@cocoanetics](http://twitter.com/cocoanetics) on Twitter.
26 |
27 | License
28 | -------
29 |
30 | It is open source and covered by a standard BSD license. That means you have to mention *Cocoanetics* as the original author of this code. You can purchase a Non-Attribution-License from us.
31 |
32 | Documentation
33 | -------------
34 |
35 | Documentation can be [browsed online](http://cocoanetics.github.com/DTCoreText) or installed in your Xcode Organizer via the [Atom Feed URL](http://cocoanetics.github.com/DTCoreText/DTCoreText.atom).
36 |
37 | Requirements
38 | ------------
39 |
40 | DTCoreText needs a minimum iOS deployment target of iOS 4.2 because of:
41 |
42 | - NSCache
43 | - GCD-based threading and locking
44 | - Blocks
45 | - ARC
46 |
47 | DTCoreText is designed to be included as static library from a subproject, it embeds several classes from the DTFoundation project. If you want to use DTFoundation as well in your project you need to use the "Static Library (no DTFoundation)" target to avoid duplicate symbols.
48 |
49 | Setup
50 | -----
51 |
52 | The best way to use DTCoreText is to add it in Xcode as a subproject of your project with the following steps.
53 |
54 | 1. Make DTCoreText a git submodule of your project
55 |
56 | `git submodule add https://github.com/Cocoanetics/DTCoreText.git Externals/DTCoreText`
57 |
58 | 2. DTCoreText uses DTHTMLParser and DTVersion from DTFoundation which is set up as a git submodule in Core/Externals/DTFoundation, so you need to get these files as well
59 |
60 | `git submodule update --init --recursive`
61 |
62 | 3. Open the destination project and create an "Externals" group.
63 |
64 | 4. Add files… or drag `DTCoreText.xcodeproj` to the Externals group
65 |
66 | 5. In your application target's Build Phases: Target Dependencies add the `Static Library` from the DTCoreText sub project
67 |
68 | 6. In your application target's Build Phases: Link Binary With Libraries phase add the following:
69 |
70 | libDTCoreText.a (target from the DTCoreText sub-project)
71 | libxml2.dylib
72 | ImageIO.framework
73 | QuartzCore.framework
74 | CoreText.framework
75 | MobileCoreServices.framework
76 |
77 | 7. Go to File: Project Settings… and change the derived data location to project-relative.
78 |
79 | 8. Add the DerivedData folder to your git ignore.
80 |
81 | 9. In your application's target Build Settings:
82 | - Add `$(PROJECT_DIR)` to `User Header Search Paths`, set to `recursive`
83 | - Set `Always Search User Paths` to `Yes`.
84 | - Add the `-ObjC` flag to your app target's `Other Linker Flags`
85 |
86 | OPTIONAL LINKER SETTINGS:
87 | - If you find that your app crashes with an unrecognized selector from one of this library's categories, you might also need the `-all_load linker` flag. Alternatively you can use `-force-load` with the full path to the static library. This causes the linker to load all categories from the static library.
88 | - If your app does not use ARC yet (but DTCoreText does) then you also need the `-fobjc-arc` linker flag.
89 |
90 | Known Issues
91 | ------------
92 |
93 | CoreText has a problem prior to iOS 5 where it takes around a second on device to initialize its internal font lookup table. You have two workarounds available:
94 |
95 | - trigger the loading on a background thread like shown in http://www.cocoanetics.com/2011/04/coretext-loading-performance/
96 | - if you only use certain fonts then add the variants to the DTCoreTextFontOverrides.plist, this speeds up the finding of a specific font face from the font family
97 |
98 | Some combinations of fonts and unusual list types cause an extra space to appear. e.g. 20 px Courier + Circle
99 |
100 | In many aspects DTCoreText is superior to the Mac version of generating NSAttributedStrings from HTML. These become apparent in the MacUnitTest where the output from both is directly compared. I am summarizing them here for references.
101 |
102 | In the following "Mac" means the initWithHTML: methods there, "DTCoreText" means DTCoreText's initWithHTML and/or DTHTMLAttributedStringBuilder.
103 |
104 | - Mac does not support the video tag, DTCoreText does.
105 | - DTCoreText is able to synthesize small caps by putting all characters in upper case and using a second smaller font for lowercase characters.
106 | - I suspect that Mac makes use of the -webkit-margin-* CSS styles for spacing the paragraphs, DTCoreText only uses the -webkit-margin-bottom and margin-bottom at present.
107 | - Mac supports CSS following addresses, e.g. "ul ul" to change the list style for stacked lists. DTCoreText does not support that and so list bullets stay the same for multiple levels.
108 | - Mac outputs newlines in PRE tags as \n, iOS replaces these with Unicode Line Feed characters so that the paragraph spacing is applied at the end of the PRE tag, not after each line. (iOS wraps code lines when layouting)
109 | - Mac does not properly encode a double list start. iOS prints the empty list prefix.
110 | - Mac seems to ignore list-style-position:outside, iOS does the right thing.
111 |
112 | If you find an issue then you are welcome to fix it and contribute your fix via a GitHub pull request.
113 |
--------------------------------------------------------------------------------
/Core/Source/DTAttributedTextView.m:
--------------------------------------------------------------------------------
1 | //
2 | // DTAttributedTextView.m
3 | // CoreTextExtensions
4 | //
5 | // Created by Oliver Drobnik on 1/12/11.
6 | // Copyright 2011 Drobnik.com. All rights reserved.
7 | //
8 |
9 | #import "DTAttributedTextView.h"
10 | #import "DTCoreText.h"
11 |
12 | @interface DTAttributedTextView ()
13 |
14 | - (void)setup;
15 |
16 | @end
17 |
18 |
19 |
20 | @implementation DTAttributedTextView
21 |
22 | - (id)initWithFrame:(CGRect)frame
23 | {
24 | self = [super initWithFrame:frame];
25 |
26 | if (self)
27 | {
28 | [self setup];
29 | }
30 |
31 | return self;
32 | }
33 |
34 | - (void)dealloc
35 | {
36 | contentView.delegate = nil;
37 | [contentView removeObserver:self forKeyPath:@"frame"];
38 | }
39 |
40 | - (void)layoutSubviews
41 | {
42 | [super layoutSubviews];
43 |
44 | [self contentView];
45 |
46 | // layout custom subviews for visible area
47 | [contentView layoutSubviewsInRect:self.bounds];
48 | }
49 |
50 | - (void)awakeFromNib
51 | {
52 | [self setup];
53 | }
54 |
55 | // default
56 | - (void)setup
57 | {
58 | if (!self.backgroundColor)
59 | {
60 | self.backgroundColor = [DTColor whiteColor];
61 | self.opaque = YES;
62 | return;
63 | }
64 |
65 | CGFloat alpha = [self.backgroundColor alphaComponent];
66 |
67 | if (alpha < 1.0)
68 | {
69 | self.opaque = NO;
70 | self.contentView.opaque = NO;
71 | }
72 | else
73 | {
74 | self.opaque = YES;
75 | self.contentView.opaque = YES;
76 | }
77 |
78 | self.autoresizesSubviews = YES;
79 | self.clipsToBounds = YES;
80 | }
81 |
82 | // override class e.g. for mutable content view
83 | - (Class)classForContentView
84 | {
85 | return [DTAttributedTextContentView class];
86 | }
87 |
88 | #pragma mark External Methods
89 | - (void)scrollToAnchorNamed:(NSString *)anchorName animated:(BOOL)animated
90 | {
91 | NSRange range = [self.contentView.attributedString rangeOfAnchorNamed:anchorName];
92 |
93 | if (range.length != NSNotFound)
94 | {
95 | // get the line of the first index of the anchor range
96 | DTCoreTextLayoutLine *line = [self.contentView.layoutFrame lineContainingIndex:range.location];
97 |
98 | // make sure we don't scroll too far
99 | CGFloat maxScrollPos = self.contentSize.height - self.bounds.size.height + self.contentInset.bottom + self.contentInset.top;
100 | CGFloat scrollPos = MIN(line.frame.origin.y, maxScrollPos);
101 |
102 | // scroll
103 | [self setContentOffset:CGPointMake(0, scrollPos) animated:animated];
104 | }
105 | }
106 |
107 | #pragma mark Notifications
108 | - (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context
109 | {
110 | if (object == contentView && [keyPath isEqualToString:@"frame"])
111 | {
112 | CGRect newFrame = [[change objectForKey:NSKeyValueChangeNewKey] CGRectValue];
113 | self.contentSize = newFrame.size;
114 | }
115 | }
116 |
117 | #pragma mark Properties
118 | - (DTAttributedTextContentView *)contentView
119 | {
120 | if (!contentView)
121 | {
122 | // subclasses can specify a DTAttributedTextContentView subclass instead
123 | Class classToUse = [self classForContentView];
124 |
125 | contentView = [[classToUse alloc] initWithFrame:self.bounds];
126 | contentView.userInteractionEnabled = YES;
127 | contentView.backgroundColor = self.backgroundColor;
128 | contentView.shouldLayoutCustomSubviews = NO; // we call layout when scrolling
129 |
130 | // we want to know if the frame changes so that we can adjust the scrollview content size
131 | [contentView addObserver:self forKeyPath:@"frame" options:NSKeyValueObservingOptionNew context:nil];
132 |
133 | [self addSubview:contentView];
134 | }
135 |
136 | return contentView;
137 | }
138 |
139 | - (void)setBackgroundColor:(DTColor *)newColor
140 | {
141 | if ([newColor alphaComponent]<1.0)
142 | {
143 | super.backgroundColor = newColor;
144 | contentView.backgroundColor = [DTColor clearColor];
145 | self.opaque = NO;
146 | }
147 | else
148 | {
149 | super.backgroundColor = newColor;
150 |
151 | if (contentView.opaque)
152 | {
153 | contentView.backgroundColor = newColor;
154 | }
155 | }
156 | }
157 |
158 | - (UIView *)backgroundView
159 | {
160 | if (!backgroundView)
161 | {
162 | backgroundView = [[UIView alloc] initWithFrame:self.bounds];
163 | backgroundView.backgroundColor = [DTColor whiteColor];
164 |
165 | // default is no interaction because background should have no interaction
166 | backgroundView.userInteractionEnabled = NO;
167 |
168 | [self insertSubview:backgroundView belowSubview:self.contentView];
169 |
170 | // make content transparent so that we see the background
171 | contentView.backgroundColor = [DTColor clearColor];
172 | contentView.opaque = NO;
173 | }
174 |
175 | return backgroundView;
176 | }
177 |
178 | - (void)setBackgroundView:(UIView *)newBackgroundView
179 | {
180 | if (backgroundView != newBackgroundView)
181 | {
182 | [backgroundView removeFromSuperview];
183 | backgroundView = newBackgroundView;
184 |
185 | [self insertSubview:backgroundView belowSubview:self.contentView];
186 |
187 | if (backgroundView)
188 | {
189 | // make content transparent so that we see the background
190 | contentView.backgroundColor = [DTColor clearColor];
191 | contentView.opaque = NO;
192 | }
193 | else
194 | {
195 | contentView.backgroundColor = [DTColor whiteColor];
196 | contentView.opaque = YES;
197 | }
198 | }
199 | }
200 |
201 | - (void)setAttributedString:(NSAttributedString *)string
202 | {
203 | self.contentView.attributedString = string;
204 |
205 | // might need layout for visible custom views
206 | [self setNeedsLayout];
207 |
208 | // adjust content size right away
209 | self.contentSize = self.contentView.frame.size;
210 | }
211 |
212 | - (NSAttributedString *)attributedString
213 | {
214 | return self.contentView.attributedString;
215 | }
216 |
217 |
218 | - (void)setFrame:(CGRect)frame
219 | {
220 | if (!CGRectEqualToRect(self.frame, frame))
221 | {
222 | if (self.frame.size.width != frame.size.width)
223 | {
224 | contentView.frame = CGRectMake(0,0,frame.size.width, frame.size.height);
225 | }
226 | [super setFrame:frame];
227 | }
228 | }
229 |
230 | - (void)setTextDelegate:(idFonts
2 |A font can either be specified directly via its face or via CSS styles. In CSS the font is never specified directly but instead via the font-family and various attributes.
3 |Standard Fonts
4 |The Standard font family to be used is 'Times New Roman', 12 px.
5 |These are the fonts where all 4 basic faces are available: Regular, Bold, Italic and Bold/Italic.
6 | 7 |Arial
8 |-
9 |
- Regular:
ArialMT
10 | - Bold:
Arial-BoldMT
11 | - Italic:
Arial-ItalicMT
12 | - Bold/Italic:
Arial-BoldItalicMT
13 |
Baskerville
15 |-
16 |
- Regular:
Baskerville
17 | - Bold:
Baskerville-SemiBold
18 | - Italic:
Baskerville-Italic
19 | - Bold/Italic:
Baskerville-SemiBoldItalic
20 |
Cochin
22 |-
23 |
- Regular:
Cochin
24 | - Bold:
Cochin-Bold
25 | - Italic:
Cochin-Italic
26 | - Bold/Italic:
Cochin-BoldItalic
27 |
Courier
29 |-
30 |
- Regular:
Courier
31 | - Bold:
Courier-Bold
32 | - Italic:
Courier-Oblique
33 | - Bold/Italic:
Courier-BoldOblique
34 |
Courier New
36 |-
37 |
- Regular:
CourierNewPSMT
38 | - Bold:
CourierNewPS-BoldMT
39 | - Italic:
CourierNewPS-ItalicMT
40 | - Bold/Italic:
CourierNewPS-BoldItalicMT
41 |
Georgia
43 |-
44 |
- Regular:
Georgia
45 | - Bold:
Georgia-Bold
46 | - Italic:
Georgia-Italic
47 | - Bold/Italic:
Georgia-BoldItalic
48 |
Helvetica
50 |-
51 |
- Regular:
Helvetica
52 | - Bold:
Helvetica-Bold
53 | - Italic:
Helvetica-Oblique
54 | - Bold/Italic:
Helvetica-BoldOblique
55 |
Helvetica Neue
57 |-
58 |
- Regular:
HelveticaNeue
59 | - Bold:
HelveticaNeue-Bold
60 | - Italic:
HelveticaNeue-Italic
61 | - Bold/Italic:
HelveticaNeue-BoldItalic
62 |
Palatino
64 |-
65 |
- Regular:
Palatino-Roman
66 | - Bold:
Palatino-Bold
67 | - Italic:
Palatino-Italic
68 | - Bold/Italic:
Palatino-BoldItalic
69 |
Times New Roman
71 |-
72 |
- Regular:
TimesNewRomanPSMT
73 | - Bold:
TimesNewRomanPS-BoldMT
74 | - Italic:
TimesNewRomanPS-ItalicMT
75 | - Bold/Italic:
TimesNewRomanPS-BoldItalicMT
76 |
Trebuchet MS
78 |-
79 |
- Regular:
TrebuchetMS
80 | - Bold:
TrebuchetMS-Bold
81 | - Italic:
TrebuchetMS-Italic
82 | - Bold/Italic:
Trebuchet-BoldItalic
83 |
Verdana
85 |-
86 |
- Regular:
Verdana
87 | - Bold:
Verdana-Bold
88 | - Italic:
Verdana-Italic
89 | - Bold/Italic:
Verdana-BoldItalic
90 |
92 |
Custom Fonts
93 |Usage of custom fonts is supported. You have to register these in the info.plist.
94 |Note: For some fonts you might have to bundle the normal as well as the bold variant for CTFontDescriptor to find the normal font.
95 |Core Text automatically display Right-to-Left Text as such if only RTL characters are used 96 |
XB Niloofar:
97 |بِسْمِ اللّٰهِ
98 |American Typewriter:
99 |AmericanTypewriter
American Typewriter Bold:
101 |AmericanTypewriter
104 |
Font Variants
105 |The font variant 'Small Caps' is supported by synthesizing an attributed string that has the lower case characters in the same font as the upper case ones, but 30% smaller.
106 |Helvetica (synthesized):
The Quick Brown Fox Jumps ...
HoeflerText (native, iPad only):
The Quick Brown Fox Jumps ...
Supported values for the style font-variant:
108 |- inherit
- normal
- small-caps
List Styles
2 |A variety of list styles are supported.
3 |-
4 |
- First 5 |
- Second 6 |
- Third 7 |
Nesting
10 |Nesting is supported.
11 | 12 |Unordered Lists
13 |-
14 |
- First item 15 |
- Second item
16 |
-
17 |
- Nested unordered lists 18 |
- Nested line 2 19 |
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed pulvinar sollicitudin tellus, vitae congue arcu condimentum ut. Fusce sagittis iaculis sem ut bibendum. Sed a ipsum purus, sit amet elementum diam. Fusce sapien sapien, cursus sit amet auctor sit amet, ultricies et lorem. Pellentesque dignissim gravida nunc, id porta felis dapibus nec. Proin ultrices, dui vel tempor imperdiet, mi libero congue orci, at auctor ante quam et lorem. Mauris imperdiet molestie leo at pellentesque. Maecenas nec nulla sed felis tristique sagittis. Suspendisse sit amet lectus vitae felis ultrices interdum vel nec ipsum. Proin elementum lectus sed nisi varius id euismod mauris lobortis. Phasellus eget purus ut nunc vulputate tincidunt sed ac purus. Aenean iaculis eros sed odio faucibus commodo. Morbi eu metus risus, ut convallis urna. Cras aliquet urna non diam rhoncus posuere. Aliquam est risus, ullamcorper ac malesuada eget, molestie vitae mauris. Nam volutpat, eros at scelerisque gravida, neque lorem interdum sapien, sed sollicitudin odio neque condimentum lacus. Curabitur congue tortor quis quam mattis lobortis. Quisque a ligula ipsum, eget hendrerit elit. Ut nec nibh nisi. Donec sit amet tortor massa. 20 |
-
21 |
-
22 |
- Nested list the third. 23 |
- Nested list the third. 24 |
26 |
28 | - Last item 29 |
Ordered Lists
33 |-
34 |
- First item 35 |
- Second item
36 |
-
37 |
- Nested unordered lists 38 |
- Nested line 2 39 |
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed pulvinar sollicitudin tellus, vitae congue arcu condimentum ut. Fusce sagittis iaculis sem ut bibendum. Sed a ipsum purus, sit amet elementum diam. Fusce sapien sapien, cursus sit amet auctor sit amet, ultricies et lorem. Pellentesque dignissim gravida nunc, id porta felis dapibus nec. Proin ultrices, dui vel tempor imperdiet, mi libero congue orci, at auctor ante quam et lorem. Mauris imperdiet molestie leo at pellentesque. Maecenas nec nulla sed felis tristique sagittis. Suspendisse sit amet lectus vitae felis ultrices interdum vel nec ipsum. Proin elementum lectus sed nisi varius id euismod mauris lobortis. Phasellus eget purus ut nunc vulputate tincidunt sed ac purus. Aenean iaculis eros sed odio faucibus commodo. Morbi eu metus risus, ut convallis urna. Cras aliquet urna non diam rhoncus posuere. Aliquam est risus, ullamcorper ac malesuada eget, molestie vitae mauris. Nam volutpat, eros at scelerisque gravida, neque lorem interdum sapien, sed sollicitudin odio neque condimentum lacus. Curabitur congue tortor quis quam mattis lobortis. Quisque a ligula ipsum, eget hendrerit elit. Ut nec nibh nisi. Donec sit amet tortor massa. 40 |
-
41 |
-
42 |
- Nested list the third. 43 |
- Nested list the third. 44 |
46 |
48 | - Last item 49 |
Mixed Lists
52 |-
53 |
- First item 54 |
- Second item
55 |
-
56 |
- Nested unordered lists 57 |
- Nested line 2 58 |
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed pulvinar sollicitudin tellus, vitae congue arcu condimentum ut. Fusce sagittis iaculis sem ut bibendum. Sed a ipsum purus, sit amet elementum diam. Fusce sapien sapien, cursus sit amet auctor sit amet, ultricies et lorem. Pellentesque dignissim gravida nunc, id porta felis dapibus nec. Proin ultrices, dui vel tempor imperdiet, mi libero congue orci, at auctor ante quam et lorem. Mauris imperdiet molestie leo at pellentesque. Maecenas nec nulla sed felis tristique sagittis. Suspendisse sit amet lectus vitae felis ultrices interdum vel nec ipsum. Proin elementum lectus sed nisi varius id euismod mauris lobortis. Phasellus eget purus ut nunc vulputate tincidunt sed ac purus. Aenean iaculis eros sed odio faucibus commodo. Morbi eu metus risus, ut convallis urna. Cras aliquet urna non diam rhoncus posuere. Aliquam est risus, ullamcorper ac malesuada eget, molestie vitae mauris. Nam volutpat, eros at scelerisque gravida, neque lorem interdum sapien, sed sollicitudin odio neque condimentum lacus. Curabitur congue tortor quis quam mattis lobortis. Quisque a ligula ipsum, eget hendrerit elit. Ut nec nibh nisi. Donec sit amet tortor massa. 59 |
-
60 |
-
61 |
- Nested list the third. 62 |
- Nested list the third. 63 |
65 |
67 | - Last item 68 |
-
71 |
- First item 72 |
- Second item
73 |
-
74 |
- Nested unordered lists 75 |
- Nested line 2 76 |
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed pulvinar sollicitudin tellus, vitae congue arcu condimentum ut. Fusce sagittis iaculis sem ut bibendum. Sed a ipsum purus, sit amet elementum diam. Fusce sapien sapien, cursus sit amet auctor sit amet, ultricies et lorem. Pellentesque dignissim gravida nunc, id porta felis dapibus nec. Proin ultrices, dui vel tempor imperdiet, mi libero congue orci, at auctor ante quam et lorem. Mauris imperdiet molestie leo at pellentesque. Maecenas nec nulla sed felis tristique sagittis. Suspendisse sit amet lectus vitae felis ultrices interdum vel nec ipsum. Proin elementum lectus sed nisi varius id euismod mauris lobortis. Phasellus eget purus ut nunc vulputate tincidunt sed ac purus. Aenean iaculis eros sed odio faucibus commodo. Morbi eu metus risus, ut convallis urna. Cras aliquet urna non diam rhoncus posuere. Aliquam est risus, ullamcorper ac malesuada eget, molestie vitae mauris. Nam volutpat, eros at scelerisque gravida, neque lorem interdum sapien, sed sollicitudin odio neque condimentum lacus. Curabitur congue tortor quis quam mattis lobortis. Quisque a ligula ipsum, eget hendrerit elit. Ut nec nibh nisi. Donec sit amet tortor massa. 77 |
-
78 |
-
79 |
- Nested list the third. 80 |
- Nested list the third. 81 |
83 |
85 | - Last item 86 |