IOS常用框架集合

IDealist框架-IOS常用框架集合github部分截图要求iOS 8.0+swift 3.0+安装方式使用 CocoaPodspod ‘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.bottomid_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.redIDToastManager.share.bgColor = UIColor(white: 0, alpha: 0.5)IDToastManager.share.cornerRadius = 8使用注意1.IDToast 默认是支持多任务顺序异步执行的，如果连续调用多次id_show,toast会依次执行。通过以下属性可控制该功能IDToastManager.share.supportQuene = false2.修改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?/// 禁止输入表情符号emojipublic var allowEmoji: Bool?/// 正则表达式public var predicateString: String?IDLoadingloading的类型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])IDImagePicker1.访问相册，外部弹出let picker = IDImagePicker()picker.cameraOut = truepicker.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 = .singlePicturepicker.id_setupImagePickerWith(maxImagesCount: 10) { (assrtArr, img) in}4.高度定制导航栏颜色let picker = IDImagePicker()picker.navColor = UIColor.purplepicker.navTitleColor = UIColor.whitepicker.statusBarType = .whitepicker.id_setupImagePickerWith(maxImagesCount: 10) { (assrtArr, img) in}5.高度定制主题色let picker = IDImagePicker()picker.tineColor = UIColor.greenpicker.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)IDUIKit1.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?/// 禁止输入表情符号emojipublic var id_allowEmoji: Bool?/// 正则表达式public var id_predicateString: String?/// 是否支持文本高度跟随内容变化而变化public var id_supportAutoHeight = false4.IDPopView为了达到高度定制内容的需求，IDPopView只提供了一个盛放内容的容器，容器内的具体内容是需要外界传入的。基本使用如下/// self.contentView 是一个外界UIViewlet pop = IDPopView.init(contentView: self.contentView)/// 箭头的位置IDPopViewArrowPosition.left、center、right、custompop.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.IDProgressViewIDProgressView继承自UIProgressView，初始化的时候设置了主题色IDProgressCircleView展示的是圆形进度条、饼图进度条。部分属性：/// value的范围是0-100public var id_value: CGFloat = 0 /// 默认是2public var id_lineWidth: CGFloat = 2 /// 颜色public var id_fillColor: UIColor = (ColorConfig.share.mainColor ?? UIColor.white)/// 类型 .circle、.piepublic var id_type: IDProgressCircleViewType = .circle 6.IDSearchBarIDSearchBar的样式参考蓝湖部分属性如下/// 占位文字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.IDSwitchIDSwitch继承自UIControl，默认宽80，高度408.IDTextField部分属性/// 最多允许输入多少个字符public var maxLength: Int?/// 只允许输入数字和小数点public var onlyNumberAndPoint: Bool?/// 设置小数点位数public var pointLength: Int?/// 只允许输入数字public var onlyNumber: Bool?/// 禁止输入表情符号emojipublic var allowEmoji: Bool?/// 正则表达式public var predicateString: String?9.IDSelectViewIDSelectView目前提供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: CGFloatpublic var id_y: CGFloatpublic var id_height: CGFloatpublic var id_width: CGFloatpublic var id_size: CGSizepublic var id_centerX: CGFloatpublic 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的扩展// 通过字符串设置colorpublic 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?{…}