【封装富文本API,采用block实现链式编程】(block 的妙用:结合block和方法的优点实现iOS的链式编程)

简介: 【封装富文本API,采用block实现链式编程】(block 的妙用:结合block和方法的优点实现iOS的链式编程)

文章目录

  • 前言

  • 核心思想
  • 具体的实现步骤
  • I 、使用方法
  • II、实现细节

  • 2.1 使用宏进行block属性的声明
  • 2.2 代码
  • see also


前言

block 的妙用:结合block和方法的优点实现iOS的链式编程

-【 完整pod 仓库源码GitHub】

主要针对段落样式NSMutableParagraphStyle和富文本NSMutableAttributedString进行封装

  • 代码效果
    xx.kn_addString(@"封装富文本API").kn_fontColor(UIColor.redColor).kn_addString(@"采用block实现链式编程").kn_fontColor(UIColor.blueColor).kn_addString(@"!");

image.png

image.png

核心思想

  • 实现步骤:方法的返回值是block,block必须有返回值(本身对象),block参数(需要操作的值)
  • 链式编程特点:将多个操作(多行代码)通过点号(.)链接在一起成为一句代码,使代码可读性好a(1).b(2).c(3)。

具体的实现步骤

  • 声明block属性
k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_addString)// 好处是Xcode的提示比较友好
//- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString// 不推荐直接声明getter方法,推荐上面的声明的block属性
  • 实现getter方法
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString{
    return ^id(NSString *str){
        NSMutableAttributedString *attStr = [[NSMutableAttributedString alloc]initWithString:str];
        self.leftStr = str;
        [self appendAttributedString:attStr];
        return self;
    };
}
1

I 、使用方法

  • Installation
pod 'ChainAttributedString'
  • 声明
//#import <ChainAttributedString/ChainAttributedString-umbrella.h>
#import <ChainAttributedString/NSMutableAttributedString+Chain.h>
  • demo
UILabel *x = [UILabel new];
    x.textAlignment = NSTextAlignmentCenter;
    [self.view addSubview:x];
    x.frame = self.view.frame;
    x.numberOfLines = 0;
    NSMutableAttributedString *xx  = [[NSMutableAttributedString alloc]init];
    xx.kn_addString(@"封装富文本API").kn_fontColor(UIColor.redColor).kn_addString(@"采用block实现链式编程").kn_fontColor(UIColor.blueColor).kn_addString(@"!");
    x.attributedText =xx;

II、实现细节

2.1 使用宏进行block属性的声明

#define k_PropertyStatement(propertyModifier,className, propertyPointerType, propertyName) \
@property (nonatomic, propertyModifier) className *(^propertyName)(propertyPointerType);
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString; 直接声明方法也行
#define k_methodStatement(returnClassName,paramPointerType, methodName) \
- (returnClassName * _Nonnull (^)(paramPointerType * _Nonnull))methodName;

2.2 代码

  • NSMutableAttributedString+Chain.h
// block 的妙用:结合block和方法的优点实现iOS的链式编程
//其他更多链式编程的例子:https://github.com/zhangkn/DKUsingblockImplementChainProgramming
/**
 核心思想
 */
//核心的实现步骤:方法的返回值是block,block必须有返回值(本身对象),block参数(需要操作的值)
//链式编程特点:将多个操作(多行代码)通过点号(.)链接在一起成为一句代码,使代码可读性好a(1).b(2).c(3)。
//##------ 实现链式编程的两种形式:本质都是一样的,就是执行(getter)方法之后,得到一个block,block必须有返回值(本身对象),block参数(需要操作的值)
//1、声明方法: 缺点就是 Xcode提示不太友好。不推荐 声明方法的返回值是block,block必须有返回值(本身对象),block参数(需要操作的值)
//p.run() <=> [p run]();//执行方法的同时之后,立即执行方法返回的block
//2、声明属性: 本质就是利用他的getter方法
//声明属性,属性的类型是block,block必须有返回值(本身对象),block参数(需要操作的值)
//---------##
#import "kConst.h"
#import <Foundation/Foundation.h>
/**
 用于动态新增属性
 */
#import <objc/runtime.h>
NS_ASSUME_NONNULL_BEGIN
/*
// NSUnderlineStyleNone 不设置下划线/删除线
// NSUnderlineStyleSingle 设置下划线/删除线为细的单线
// NSUnderlineStyleThick 设置下划线/删除线为粗的单线
// NSUnderlineStyleDouble 设置下划线/删除线为细的双线
// NSUnderlinePatternSolid 设置下划线/删除线样式为连续的实线
// NSUnderlinePatternDot 设置下划线/删除线样式为点,也就是虚线,比如这样:------
// NSUnderlinePatterDash 设置下划线/删除线样式为破折号,比如这样:—— —— ——
// NSUnderlinePatternDashDot 设置下划线/删除线样式为连续的破折号和点,比如这样:——-——-——-
// NSUnderlinePatternDashDotDot 设置下划线/删除线样式为连续的破折号、点、点,比如:——--——--——--
// NSUnderlineByWord 在有空格的地方不设置下划线/删除线
*/
static const char leftMutableAttributedStringKey;
@interface NSMutableAttributedString (Chain)
/**
 记录最近一次新添加的富文本对应的字符串,以便进行后续的其他操作
 */
@property (strong, nonatomic) NSString *leftStr;
//每次kn_addString就是一句新的富文本
//kn_addString方法的返回值是block,block必须有返回值(本身对象),block参数(需要操作的值)
//富文本的block属性,发返回值就是自己,block的参数类型propertyPointerType
//k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_addString)
k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_addString)
//- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString; 直接声明方法也行
// 字体颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_fontColor)
// 字体大小
k_PropertyStatement(strong, NSMutableAttributedString, UIFont*, kn_fontSize);
// 字体背景颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_fontBgColor);
// 字体间距
k_PropertyStatement(assign, NSMutableAttributedString, NSInteger, kn_fontSpacing);
// 删除线
k_PropertyStatement(assign, NSMutableAttributedString, NSUnderlineStyle, kn_strikethrough);
// 删除线颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_strikethroughColor);
// 下划线
k_PropertyStatement(assign, NSMutableAttributedString, NSUnderlineStyle, kn_underline);
// 下划线颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_underlineColor);
// 笔画宽度 正值中空 负值填充
k_PropertyStatement(assign, NSMutableAttributedString, NSInteger, kn_strokeWidth);
// 笔画颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_strokeColor);
// 倾斜 正值右倾,负值左倾
k_PropertyStatement(assign, NSMutableAttributedString, CGFloat, kn_obliqueness);
// 书写方向
//@(NSWritingDirectionRightToLeft|NSWritingDirectionOverride)倒着写
k_PropertyStatement(strong, NSMutableAttributedString, NSArray*, kn_direction);
// 跳转URL
k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_link);
// 图文混排等
k_PropertyStatement(strong, NSMutableAttributedString, NSTextAttachment*, kn_attachment);
// 段落属性
k_PropertyStatement(strong, NSMutableAttributedString, NSMutableParagraphStyle*, kn_paragraph);
@end
NS_ASSUME_NONNULL_END
1
2
  • NSMutableAttributedString+Chain.m
//
//  NSMutableAttributedString+Chain.m
//  ChainAttributedString
//
//  Created by mac on 2020/8/6.
//
#import "NSMutableAttributedString+Chain.h"
@implementation NSMutableAttributedString (Chain)
- (void)setLeftStr:(NSString *)leftStr{
    objc_setAssociatedObject(self, &leftMutableAttributedStringKey, leftStr, OBJC_ASSOCIATION_COPY);
}
- (NSString *)leftStr{
   return objc_getAssociatedObject(self, &leftMutableAttributedStringKey);
}
- (void)setKn_addString:(NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString{
}
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString{
    return ^id(NSString *str){
        NSMutableAttributedString *attStr = [[NSMutableAttributedString alloc]initWithString:str];
        self.leftStr = str;
        [self appendAttributedString:attStr];
        return self;
    };
}
- (void)setKn_fontColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontColor{}
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSForegroundColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSForegroundColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_fontSize:(NSMutableAttributedString * _Nonnull (^)(UIFont * _Nonnull))kn_fontSize{};
- (NSMutableAttributedString * _Nonnull (^)(UIFont * _Nonnull))kn_fontSize{
    return ^id(UIFont *size) {
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSFontAttributeName value:size range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSFontAttributeName value:size range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_fontBgColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontBgColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontBgColor{
    return ^id(UIColor *bgColor){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSBackgroundColorAttributeName value:bgColor range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSBackgroundColorAttributeName value:bgColor range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_fontSpacing:(NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_fontSpacing{};
- (NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_fontSpacing{
    return ^id(NSInteger spacing){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSKernAttributeName value:@(spacing) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSKernAttributeName value:@(spacing) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strikethrough:(NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_strikethrough{};
- (NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_strikethrough{
    return ^id(NSUnderlineStyle style){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrikethroughStyleAttributeName value:@(style) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrikethroughStyleAttributeName value:@(style) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strikethroughColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strikethroughColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strikethroughColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrikethroughColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrikethroughColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_underline:(NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_underline{};
- (NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_underline{
    return ^id(NSUnderlineStyle style){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSUnderlineStyleAttributeName value:@(style) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSUnderlineStyleAttributeName value:@(style) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_underlineColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_underlineColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_underlineColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSUnderlineColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSUnderlineColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strokeWidth:(NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_strokeWidth{};
- (NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_strokeWidth{
    return ^id(NSInteger width){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrokeWidthAttributeName value:@(width) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrokeWidthAttributeName value:@(width) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strokeColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strokeColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strokeColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrokeColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrokeColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_obliqueness:(NSMutableAttributedString * _Nonnull (^)(CGFloat))kn_obliqueness{};
- (NSMutableAttributedString * _Nonnull (^)(CGFloat))kn_obliqueness{
    return ^id(CGFloat obliqueness){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSObliquenessAttributeName value:@(obliqueness) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSObliquenessAttributeName value:@(obliqueness) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_direction:(NSMutableAttributedString * _Nonnull (^)(NSArray * _Nonnull))kn_direction{};
- (NSMutableAttributedString * _Nonnull (^)(NSArray * _Nonnull))kn_direction{
    return ^id(NSArray *direction){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSWritingDirectionAttributeName value:direction range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSWritingDirectionAttributeName value:direction range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_link:(NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_link{};
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_link{
    return ^id(NSString *link){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSLinkAttributeName value:[NSURL URLWithString:link] range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSLinkAttributeName value:[NSURL URLWithString:link] range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_attachment:(NSMutableAttributedString * _Nonnull (^)(NSTextAttachment * _Nonnull))kn_attachment{}
- (NSMutableAttributedString * _Nonnull (^)(NSTextAttachment * _Nonnull))kn_attachment{
    return ^id(NSTextAttachment *attachment){
        NSAttributedString * imageStr = [NSAttributedString attributedStringWithAttachment:attachment];
        [self appendAttributedString:imageStr];
        return self;
    };
}
- (void)setKn_paragraph:(NSMutableAttributedString * _Nonnull (^)(NSMutableParagraphStyle * _Nonnull))kn_paragraph{};
- (NSMutableAttributedString * _Nonnull (^)(NSMutableParagraphStyle * _Nonnull))kn_paragraph{
    return ^id(NSMutableParagraphStyle *paragraph){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSParagraphStyleAttributeName value:paragraph range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSParagraphStyleAttributeName value:paragraph range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
@end
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
目录
相关文章
|
2月前
|
存储 监控 iOS开发
iOS应用崩溃了,如何通过崩溃手机连接电脑查找日志方法
在iOS应用开发过程中,调试日志和奔溃日志是开发者必不可少的工具。当iOS手机崩溃时,我们可以连接电脑并使用Xcode Console等工具来查看日志。然而,这种方式可能不够方便,并且处理奔溃日志也相当繁琐。克魔助手的出现为开发者带来了极大的便利,本文将详细介绍其功能和使用方法。 克魔助手会提供两种日志,一种是实时的,一种的是崩溃的。(由于崩溃日志的环境很麻烦,目前只展示实时日志操作步骤)
|
2月前
|
JavaScript API
【vue实战项目】通用管理系统:api封装、404页
【vue实战项目】通用管理系统:api封装、404页
20 3
|
2月前
|
存储 iOS开发 开发者
使用克魔助手进行iOS数据抓包和HTTP抓包的方法详解
使用克魔助手进行iOS数据抓包和HTTP抓包的方法详解
30 0
|
2月前
|
安全 编译器 开发工具
​iOS安全加固方法及实现
​iOS安全加固方法及实现
21 0
​iOS安全加固方法及实现
|
2月前
|
小程序 前端开发 Android开发
解决小程序中textarea ios端样式不兼容的两种方法
解决小程序中textarea ios端样式不兼容的两种方法
|
7天前
|
缓存 监控 测试技术
ERP系统对接方案与API接口封装系列(高并发)
企业资源规划(ERP)系统是现代企业管理的核心,它集成了企业内部的各个部门和业务流程。为了实现ERP系统与其他外部系统或应用程序之间的数据交换和协作,需要对接方案。API(应用程序编程接口)是实现系统对接的常用方法之一。
|
1月前
|
安全 编译器 开发工具
iOS 安全加固方法及实现
iOS 安全加固方法及实现
|
1月前
|
安全 算法 数据安全/隐私保护
iOS 代码加固与保护方法详解 - 提升 iOS 应用安全性的关键步骤
iOS 代码加固与保护方法详解 - 提升 iOS 应用安全性的关键步骤
|
1月前
|
网络安全 开发工具 数据安全/隐私保护
如何把 ipa 文件 (iOS 安装包) 安装到 iPhone 手机上? 附方法汇总
如何把 ipa 文件 (iOS 安装包) 安装到 iPhone 手机上? 附方法汇总
|
2月前
|
缓存 JSON API
IOS网络编程:什么是 RESTful API?如何使用 RESTful 风格设计 API?
IOS网络编程:什么是 RESTful API?如何使用 RESTful 风格设计 API?
23 3

相关产品

  • 云迁移中心