共计 10091 个字符，预计需要花费 26 分钟才能阅读完成。
IDealist 框架 -IOS 常用框架集合
github
部分截图
要求
iOS 8.0+
swift 3.0+
安装方式
使用 CocoaPods
pod ‘IDealist’
设置所有组件的主题色
IDealistConfig.share.id_setupMainColor(color: UIColor.red)
项目中引用 IDeal 框架
引用 IDealist 内部的框架有 2 种方法
1. 按需导入，每个文件中需要哪个框架就引用哪个，例如：import IDealist。优点：有提示。缺点：需要每次都导入
–
2. 使用 @_exported 关键字导入一次即可。例如：@_exported import IDealist 优点：只要导入一次，缺点：可能没有代码提示
注意：对于 IDealist 框架，其内部含有很多扩展方法，需要使用 @_exported import IDealist 的方式导入一次即可，也有代码提示。
使用详解
IDToast
调用 id_show 方法，可传入参数介绍如下
// 默认纯文本、展示在 window 上、1.5 秒消失、中间位置
// onView: 可以指定显示在指定的 view 上
// success=nil, 展示纯文本，success=false 展示错误的图片，success=true 展示成功的图片
// position: 展示的位置 IDToastPosition.top、IDToastPosition.middle、IDToastPosition.bottom
id_show(msg: String, onView:UIView? = nil,success: IDToastUtilsImageType? = nil,duration:CGFloat? = nil, position: IDToastPosition? = .middle)
使用方式
IDToast.id_show(msg: “ 展示纯文本 ”)
IDToast.id_show(msg: “ 展示纯文本，在指定 view 上。指定 3s”, onView: self.view, duration: 3)
IDToast.id_show(msg: “ 登录成功 ”, success: IDToastUtilsImageType.success)
修改 toast 样式
IDToastManager.share.successImage = UIImage(named: “message_success”)
IDToastManager.share.textFont = UIFont.boldSystemFont(ofSize: 20)
IDToastManager.share.textColor = UIColor.red
IDToastManager.share.bgColor = UIColor(white: 0, alpha: 0.5)
IDToastManager.share.cornerRadius = 8
使用注意
1.IDToast 默认是支持多任务顺序异步执行的，如果连续调用多次 id_show,toast 会依次执行。通过以下属性可控制该功能
IDToastManager.share.supportQuene = false
2. 修改 toast 样式是通过单例来设置的，所以建议在项目初始化时就统一 toast 的样式。
IDDialog
目前提供 4 种类型的弹框
1. 普通弹框，调用 id_show 方法
IDDialog.id_show(title: “ 温馨提示 ”, msg: “ 确定要取消？”, leftActionTitle: “ 确定 ”, rightActionTitle: “ 取消 ”, leftHandler: {
}) {
}
2. 带有图片显示的弹框，调用 id_showImg 方法
IDDialog.id_showImg(success: IDDialogUtilImageType.success, msg: “ 提交成功 ”, leftActionTitle: “ 知道了 ”, rightActionTitle: nil, leftHandler: nil, rightHandler: nil)
3. 带有输入文本框的弹框，调用 id_showInput 方法
IDDialog.id_showInput(msg: “ 请输入取消原因 ”, leftActionTitle: “ 取消 ”, rightActionTitle: “ 确定 ”, leftHandler: { (text) in
print(text)
}) {(text) in
print(text)
}
4. 自定义内容的弹框，调用 id_showCustom 方法
IDDialog.id_showCustom(msg: “ 标题 ”, leftActionTitle: nil, rightActionTitle: “ 确定 ”, customView: self.myView, leftHandler: { (customView) in
}) {(customView) in
}
属性介绍
/// 内容的对齐方式
public var textAlignment = NSTextAlignment.center
/// 设置主题色，2 个按钮时只设置右边的主题色，1 个按钮时显示主题色
public var mainColor = UIColor.black
/// 是否支持动画
public var supportAnimate = true
/// 自定义动画
public var animate = CABasicAnimation()
/// 成功图片
public var successImage = UIImage(named: “ic_toast_success”, in: BundleUtil.getCurrentBundle(), compatibleWith: nil)
/// 失败图片
public var failImage = UIImage(named: “icn_icn_fail”, in: BundleUtil.getCurrentBundle(), compatibleWith: nil)
/// 警告图片
public var warnImage = UIImage(named: “icon_sign”, in: BundleUtil.getCurrentBundle(), compatibleWith: nil)
/// 针对输入框类型的弹框，限制输入框的输入条件, 文本框默认没有限制，在文本框消失时，自动重置文本框的属性
/// 最多允许输入多少个字符
public var maxLength: Int?
/// 只允许输入数字和小数点
public var onlyNumberAndPoint: Bool?
/// 设置小数点位数
public var pointLength: Int?
/// 只允许输入数字
public var onlyNumber: Bool?
/// 禁止输入表情符号 emoji
public var allowEmoji: Bool?
/// 正则表达式
public var predicateString: String?
IDLoading
loading 的类型
public enum IDLoadingUtilLoadingType {
case wait // 会阻止用户交互，需要等待加载完成
case nav // 一条进度线条
case free // 不会阻止用户交互
}
1. 展示不阻止用户交互的加载框
IDLoading.id_show()
IDLoading.id_dismiss() // 取消
2. 展示阻止用户交互的加载框
IDLoading.id_showWithWait()
IDLoading.id_dismissWait()
3. 展示网页加载进度
IDLoading.id_showProgressLine(onView: self.navView)
IDLoading.id_dismissNav()
4. 自定义 gif 动画
IDLoading.id_showGif(gifName: nil, type: IDLoadingUtilLoadingType.free, onView: self.view)
IDLoading.id_dismissGif()
5. 定制网页加载进度条的颜色
IDLoading.id_showProgressLine(onView: self.navView, colors: [RGBAColor(0, 238, 0, 0.1).cgColor, RGBAColor(0, 238, 0, 0.5).cgColor, RGBAColor(0, 238, 0, 1).cgColor])
IDImagePicker
1. 访问相册，外部弹出
let picker = IDImagePicker()
picker.cameraOut = true
picker.id_setupImagePickerWith(maxImagesCount: 10) {(assrtArr, img) in
}
2. 访问相册，默认多选
let picker = IDImagePicker()
picker.id_setupImagePickerWith(maxImagesCount: 10) {(assrtArr, img) in
}
3. 访问相册，单选
let picker = IDImagePicker()
picker.singleImageChooseType = .singlePicture
picker.id_setupImagePickerWith(maxImagesCount: 10) {(assrtArr, img) in
}
4. 高度定制导航栏颜色
let picker = IDImagePicker()
picker.navColor = UIColor.purple
picker.navTitleColor = UIColor.white
picker.statusBarType = .white
picker.id_setupImagePickerWith(maxImagesCount: 10) {(assrtArr, img) in
}
5. 高度定制主题色
let picker = IDImagePicker()
picker.tineColor = UIColor.green
picker.id_setupImagePickerWith(maxImagesCount: 10) {(assrtArr, img) in
}
IDScanCode
二维码与条形码扫描控件，而且能够实现快速的扫描二维码和条形码
1. 使用方法
新建控制器继承 IDScanCodeController 即可
2. 可定制的一些提示语
id_scanTitle // 扫描框顶部的提示语，默认无
id_scanDetailTitle // 扫描框底部的提示语，默认是“将二维码 / 条码放入框内，即可自动扫描”
IDEmptyView
使用 IDEmptyView 扩展了 UIView，可以通过 id_empty 属性添加到目标视图当你需要展示或隐藏的时候可以利用 rxcocoa 的扩展绑定数据和 isHidden 属性
view.id_empty = IDEmptyView.create().configStyle(style)
创建并使用
let emptyView = IDEmptyView.create().configStyle(style)
view.addSubview(emptyView)
style 可设置为
public enum Style {
case normal
// 有为什么为空状态说明
case normalDeail(String)
// 可操作空状态
case normalOperational
// 可操作并有说明的空状态
case normalDetailOperational(String)
// 网络加载失败可操作
case load
// 网络环境不良可操作
case loadDetail
// 空状态的文字提示
case detail(String)
}
当你的 style 为 normalOperational，normalDetailOperational，load，loadDetail 时必须设置操作回调
emptyView.setOperatorAction {/// 重新加载页面或者做其他事}
/// 也可以在创建的时候设置
let emptyView = IDEmptyView.create().configStyle(style).setOperatorAction {}
view.addSubview(emptyView)
自定义图片，文本，按钮文字
emptyView.custom(image, title, detail, buttonText)
IDUIKit
1.IDButton
封装 IDButton 的原因：解决 Button 的图片位置问题。当系统的 Button 的宽度自适应并且 Button 的样式是文字和图片的结合，图片可以在顶部，右侧，底部，此时如果使用 imageEdgeInsets 和 titleEdgeInsets 是达不到理想效果的，IDButton 由此产生。IDButton 继承自系统的 Button。按钮的类型
public enum IDButtonType {
case normal
case primary
case error
case loading
}
normal:
self.layer.borderWidth = 1
self.setTitleColor(UIColor.black, for: UIControl.State.normal)
self.backgroundColor = UIColor.white
primary: // 背景色是主题色
self.backgroundColor = ColorConfig.share.mainColor
self.layer.borderWidth = 0
self.setTitleColor(UIColor.white, for: UIControl.State.normal)
error: // 背景色是红色
self.backgroundColor = RGBAColor(233, 80, 79, 1) // 写死的颜色
self.layer.borderWidth = 0
self.setTitleColor(UIColor.white, for: UIControl.State.normal)
loading: // 可以展示一个 loading 动画
self.id_startLoading() // 开始动画
self.id_stopLoading() // 结束动画
按钮图片的位置
public enum IDButtonPosition {
case left // 图片在文字左侧
case right // 图片在文字右侧
case top // 图片在文字上侧
case bottom // 图片在文字下侧
}
设置按钮渐变色
public enum IDButtonGradientDirection {
case horizontally
case vertically
}
public func id_setupGradient(gradientColors: [UIColor], gradientDirection direction: IDButtonGradientDirection, gradientFrame: CGRect? = nil) {
….
}
部分属性
/// 图片位置
open var id_imagePosition = IDButtonPosition.left
/// 图片和文字之间的间距
open var id_imageTitleSpace: CGFloat = 0
/// loading 视图和文字之间的间距
open var id_loadingTitleSpace: CGFloat = 5
/// 按钮类型
open var id_type: IDButtonType = .normal
/// 加载框大小
open var id_loadingSize: CGSize = CGSize.init(width: 15, height: 15)
2.IDLabel
开启长按复制功能
label.id_canCopy = true
富文本：图片插入的文字的指定位置
label.id_setupAttbutImage(img: UIImage(named: “ic_new”)!, index: 0)
3.IDTextView
部分属性
/// 占位文字
public var id_placehoder: String?
public var id_placehoderColor: UIColor?
/// 文字改变的回调
public var textChangeClouse: IDTextViewTextDidChangedClouse?
/// 最多允许输入多少个字符
public var id_maxLength: Int?
/// 只允许输入数字和小数点
public var id_onlyNumberAndPoint: Bool?
/// 设置小数点位数
public var id_pointLength: Int?
/// 只允许输入数字
public var id_onlyNumber: Bool?
/// 禁止输入表情符号 emoji
public var id_allowEmoji: Bool?
/// 正则表达式
public var id_predicateString: String?
/// 是否支持文本高度跟随内容变化而变化
public var id_supportAutoHeight = false
4.IDPopView
为了达到高度定制内容的需求，IDPopView 只提供了一个盛放内容的容器，容器内的具体内容是需要外界传入的。基本使用如下
/// self.contentView 是一个外界 UIView
let pop = IDPopView.init(contentView: self.contentView)
/// 箭头的位置 IDPopViewArrowPosition.left、center、right、custom
pop.id_arrowPosition = .left
/// 箭头的位置
pop.id_trianglePoint = CGPoint.init(x: KScreenWidth-30, y: 120)
/// popview 展示在的具体的位置
pop.showInRect(rect: CGRect.init(x: KScreenWidth-160-10, y: 128, width: 160, height: self.contentView.frame.height + 16))
5.IDProgressView
IDProgressView 继承自 UIProgressView，初始化的时候设置了主题色 IDProgressCircleView 展示的是圆形进度条、饼图进度条。部分属性：
/// value 的范围是 0 -100
public var id_value: CGFloat = 0
/// 默认是 2
public var id_lineWidth: CGFloat = 2
/// 颜色
public var id_fillColor: UIColor = (ColorConfig.share.mainColor ?? UIColor.white)
/// 类型 .circle、.pie
public var id_type: IDProgressCircleViewType = .circle
6.IDSearchBar
IDSearchBar 的样式参考蓝湖部分属性如下
/// 占位文字
public var id_placeHolder: String = “ 请输入搜索关键字 ”
/// 搜索图片
public var id_searchImage: UIImage? = UIImage(named: “ic_ssearch”, in: BundleUtil.getCurrentBundle(), compatibleWith: nil)
/// 搜索框背景颜色
public var id_textFieldBgColor = UIColor.white
/// 搜索框字体大小
public var id_textFieldFont = UIFont.systemFont(ofSize: 12)
/// 右边按钮的文字
public var id_cancelButtonTitle = “ 取消 ”
/// 右边按钮的文字颜色
public var id_cancelButtonTitleColor = RGBAColor(95,95,95,1)
/// 右边按钮的文字字体
public var id_cancelButtonTitleFont = UIFont.systemFont(ofSize: 13)
/// 是否显示右边的按钮
public var id_showRightBtn = false
/// 搜索容器的背景色
public var id_containerBgColor = RGBAColor(239, 239, 244, 1)
/// 搜索框的圆角大小
public var id_cornerRadius: CGFloat = 2
7.IDSwitch
IDSwitch 继承自 UIControl，默认宽 80，高度 40
8.IDTextField
部分属性
/// 最多允许输入多少个字符
public var maxLength: Int?
/// 只允许输入数字和小数点
public var onlyNumberAndPoint: Bool?
/// 设置小数点位数
public var pointLength: Int?
/// 只允许输入数字
public var onlyNumber: Bool?
/// 禁止输入表情符号 emoji
public var allowEmoji: Bool?
/// 正则表达式
public var predicateString: String?
9.IDSelectView
IDSelectView 目前提供 3 种类型的视图, 详细参数较多，请参考 demo 事例。该视图对 JXSegmentedView 的再次封装，提取了常用的功能点。
public enum IDSelectViewType {
case normal // 标题
case number // 含有数字显示
case dots // 含有原点显示
}
IDUtils (扩展方法和工具类)
String 的扩展方法
/// 字符串截取函数, 截取到指定的位置
public func id_subString(to index: Int) -> String {
…
}
/// 字符串截取函数，从指定位置开始截取
public func id_subString(from index: Int) -> String {
…
}
/// 从指定位置开始截取, 截取到指定的位置
public func id_subString(from index: Int, offSet: Int) -> String {
…
}
UIView 的扩展方法
public var id_x: CGFloat
public var id_y: CGFloat
public var id_height: CGFloat
public var id_width: CGFloat
public var id_size: CGSize
public var id_centerX: CGFloat
public var id_centerY: CGFloat
/// 设置渐变色
public func id_addGradientLayer(gradientColors: [UIColor],gradientDirection direction: UIViewGradientDirection, gradientFrame: CGRect? = nil) {
…
}
/// 设置圆角
public func id_border(borderWidth: CGFloat?, borderColor:UIColor?,cornerRadius:CGFloat?) -> UIView{
…
}
/// 设置指定部位的圆角
public func id_borderSpecified(_ specified: UIRectCorner,cornerRadius:CGFloat) -> UIView {
…
}
URL 的扩展
// 过滤字符串中的特殊字符
public static func id_init(string:String) -> URL? {
…
}
Array 的扩展
// 去重
public func id_filterDuplicates<E: Equatable>(_ filter: (Element) -> E) -> [Element] {
…
}
UIColor 的扩展
// 通过字符串设置 color
public convenience init(hexString: String) {
…
}
// 通过 rgb 值设置颜色
convenience init(redValue: Int, green: Int, blue: Int, alpha: CGFloat) {
..
}
UIDevice 的扩展
// 是否是 iphonex 系列
public static func id_isX() -> Bool {
…
}
// 是否是 ios11 以上的系统
public static func id_isIOS11() -> Bool {
..
}
UIViewController 的扩展
// 获取当前控制器
public func id_getCurrentViewcontroller() -> UIViewController?{
…
}
