OS中支持HTML文本的标签控件——MDHTMLLabel

一、引言

在iOS开发中对HTML的处理很多时候除了使用WebView外，还需要原生的控件对其进行渲染，例如将HTML字符串渲染为图文混排的View视图。Git上有很多轻量级的HTML渲染框架，列举一些如下：

RTLabel：基于UIView的HTML文本渲染控件，git地址：https://github.com/honcheng/RTLabel。

RCLabel：与RTLabel思路相同，基于RCLabel之上，也是UIView的子类，支持了对HTML中的本地图片标签进行渲染。git地址：https://github.com/Janak-Nirmal/RichContentLabel。

MDHTMLLabel：与RTLabel和RCLabel不同的是，其是UILabel的子类，更加轻量级，不能支持图片标签。git地址：https://github.com/mattdonnelly/MDHTMLLabel。

关于RCLabel对图片便签的支持，其只能支持本地的图片，不能支持远程URL图片链接，这在开发中将十分局限，以前我曾加RCLabel做了改造，加了支持远程图片URL的方法，我把它集成在了一个基础框架中，需要的伙伴可以参考下，git地址：https://github.com/ZYHshao/YHBaseFoundationTest。配套的讲解博客地址如下：http://my.oschina.net/u/2340880/blog/499311。

本篇博客主要讨论MDHTMLLabel的使用。

二、MDHTMLLabel的创建与设置

MDHTMLLabel框架十分小巧，其中只有两个文件，总计2000余行代码。通过HTML字符串来创建一个MDHTMLLabel控件示例代码如下：

    NSString * kDemoText=@"<a href='http://github.com/mattdonnelly/MDHTMLLabel'>MDHTMLLabel</a> is a lightweight, easy to use replacement for <b>UILabel</b> which allows you to fully <font face='Didot-Italic' size='19'>customize</font> the appearence of the text using HTML (with a few added features thanks to <b>CoreText</b>), as well letting you handle whenever a user taps or holds down on link and automatically detects ones not wrapped in anchor tags/>";
    MDHTMLLabel *htmlLabel=[[MDHTMLLabel alloc] initWithFrame:self.view.frame];
    htmlLabel.numberOfLines=0;
    htmlLabel.htmlText=kDemoText;
    [self.view addSubview:htmlLabel];

效果如下图所示：

MDHTMLLabel中可以设置的一些属性解析如下：

//设置超链接文字的属性字典 和设置AttributeString方法一致
@property (nonatomic, strong) NSDictionary *linkAttributes;
//设置超链接文字激活时的属性字典
@property (nonatomic, strong) NSDictionary *activeLinkAttributes;
//设置超链接非激活时的属性字典
@property (nonatomic, strong) NSDictionary *inactiveLinkAttributes;
//设置超链接文字触发长按事件的最小按下时间
@property (nonatomic, assign) NSTimeInterval minimumPressDuration;
//设置label文件阴影的模糊半径
@property (nonatomic, assign) CGFloat shadowRadius;
//设置label在高亮状态下的文字模糊半径 注：非高亮状态的由原生UILabel的属性设置
@property (nonatomic, assign) CGFloat highlightedShadowRadius;
//设置label在高亮状态下的文字阴影偏移 注：非高亮状态的由原生UILabel的属性设置
@property (nonatomic, assign) CGSize highlightedShadowOffset;
//设置在label高亮状态下的文字阴影颜色 注：非高亮状态的由原生UILabel的属性设置
@property (nonatomic, strong) UIColor *highlightedShadowColor;
//设置首行文字的缩进距离
@property (nonatomic, assign) CGFloat firstLineIndent;
//设置文字的行间距
@property (nonatomic, assign) CGFloat leading;
//设置行高的倍数
@property (nonatomic, assign) CGFloat lineHeightMultiple;
//设置文字内容的边距
@property (nonatomic, assign) UIEdgeInsets textInsets;
//设置文字垂直方向的对其模式 默认为居中对其 MDHTMLLabelVerticalAlignment枚举意义如下:
/*
typedef NS_ENUM(NSUInteger, MDHTMLLabelVerticalAlignment) {
    MDHTMLLabelVerticalAlignmentCenter=0, //居中对其
    MDHTMLLabelVerticalAlignmentTop=1, //顶部对其
    MDHTMLLabelVerticalAlignmentBottom=2, //底部对其
};
*/
@property (nonatomic, assign) MDHTMLLabelVerticalAlignment verticalAlignment;
//设置文字的截断模式
@property (nonatomic, strong) NSString *truncationTokenString;
//根据内容获取控件尺寸
+ (CGFloat)sizeThatFitsHTMLString:(NSString *)htmlString
 withFont:(UIFont *)font
 constraints:(CGSize)size
 limitedToNumberOfLines:(NSUInteger)numberOfLines;

关于HTML数据中的超链接的相应，MDHTMLLabel是通过代理回调的方式处理的，如下：

esium.knock能够使Cesium球体监听html控件，从而根据控件的值实时改变一些场景属性。

添加html控件

<div id="toolbar" class="param-container tool-bar">
		<table>
			<tbody>
  			<tr>
					<td>亮度</td>
					<td>
						<input type="range" min="0" max="2" step="0.02" data-bind="value: brightness, valueUpdate: 'input'">
					</td>
				</tr>
			</tbody>
	</table>
</div>

使用knockout双向绑定数据