1. 写UI时，能快速布局，层级清晰
2. 代码写着顺手
3. 代码简洁、少
4. 代码功能封装完善

1. 代码少、出错的少、修改的时候更容易
2. 代码简洁易读、view所属层级清晰、约束依赖清晰
3. view相关配置、使用更集中，要查找更改更轻松

let  view = UIView().qbackgroundColor(.red).qisUserInteractionEnabled(true)

let textField = UITextField.init(frame: .zero)
    .qplaceholder("输入文本")
    .qmaxCount(10) // 最多输入字数 区别在于一个表情长度=1
//        .qmaxLength(10) // 最多输入字数 区别在于一个表情长度=2（也有大于2）
    .qbackgroundColor(.lightGray.withAlphaComponent(0.3))
    .qleftView(UIView.init(frame: .init(x: 0, y: 0, width: 30, height: 30)), .always)
    .qclearButtonMode(.always)
    .qfont(.systemFont(ofSize: 16))
    .qtextColor(.red)
    .qtextChanged({ textField in
        print("text 改变")
    }).qshouldChangeText { textField, range, replaceText in
        return true
    }.qshouldBeginEditing { textField in
        return true
    }

let btn = UIButton.init(type: .custom).qactionFor(.touchUpInside, handler: { sender in
    print("按钮点击")
}).qisSelectedChanged { sender in
    // isSelected 状态改变
    sender.backgroundColor = sender.isSelected ? .red : .lightGray
}.qisEnabledChanged { sender in
    // isEnabled 状态改变
    sender.alpha = sender.isEnabled ? 1 : 0.3
}

let scrollView = UIScrollView()
    .qdidScroll { scrollView in
        
    }.qdidEndScroll { scrollView in
        
    }.qdidZoom { scrollView in
        
    }

tableView
    .qregister(TestTableViewCell.self, identifier: "cell")
    .qnumberofSections {
        return 1
    }.qnumberofRows { section in
        return 100
    }.qcell { tableView, indexPath in
        let cell: TestTableViewCell = (tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath) as? TestTableViewCell) ?? .init(style: .default, reuseIdentifier: "cell")
        let rad = indexPath.row
        cell.nameLabel.text = "阿斯加德发按理阿斯加德发按理"
        cell.timeLabel.text = "05:20"
        cell.cover.isHidden = rad % 3 == 0
        return cell
    }.qdidSelectRow { tableView, indexPath in
        tableView.deselectRow(at: indexPath, animated: false)
        print("---- selected:\(indexPath)")
    }
    .qcanEdit { indexPath in
        return true
    }.qcanMove { indexPath in
        return true
    }.qeditActions { indexPath in
        let aciton = UITableViewRowAction.init(style: .default, title: "删除") { _, indexPath in
            
        }
        return [aciton]
    } 
    .qcontentSizeChanged { scrollView in
        print("contentsize changed 改变")
    }.qcontentOffsetChanged { scrollView in
        print("contentoffset changed 改变")
    }.qdidScroll { scrollView in
        print("scrollView 滚动")
    }.qdidEndScroll { scrollView in
        print("scrollView 停止滚动")
    }

public extension UIStackView {
    /// 生成QStackView
    @discardableResult
    class func qbody(_ axis: NSLayoutConstraint.Axis, _ space: CGFloat, _ align: UIStackView.Alignment, _ distribution: UIStackView.Distribution, _ views: [UIView]?) -> QStackView {
        let stackView = QStackView.init(frame: .zero)
        stackView.qaxis(axis).qspacing(space).qalignment(align).qdistribution(distribution)
        if let views = views, views.count > 0 {
            stackView.qbody(views)
        }
        return stackView
    }
}
/// 垂直UIStackView
public struct VStackView {
    /// 垂直UIStackView
    @discardableResult
    static public func qbody(_ views: [UIView]) -> QStackView {
        return QStackView.qbody(.vertical, 5, .fill, .equalSpacing, views)
    }
}
/// 水平UIStackView
public struct HStackView {
    /// 水平UIStackView
    @discardableResult
    static public func qbody(_ views: [UIView]) -> QStackView {
        return QStackView.qbody(.horizontal, 5, .fill, .equalSpacing, views)
    }
}

extentsion UIView {
    /// 添加子视图views, 如果是stackView，会添加addArrangedSubview
    func qbody(_ views: [UIView]) -> Self {}
        
    /// 设置约束。 注意，这个方法仅仅是方便qaddSubviews()  qbody() 方法里的view使用
    /// 需要调用qactiveConstraints() 激活,
    /// 方法里已经激活了，可以不需要调用
    func qmakeConstraints(_ closure: ((_ make: ConstraintMaker) -> Void)?) -> Self {}
}

class QuickLayoutViewController: UIViewController {
    let label1 = UILabel().qtext("文本框1文本框1文本框1文本框1")
    let label2 = UILabel().qtext("文本框2文本框2文本框2文本框2")
    let label3 = UILabel().qtext("文本框3文本框3文本框3文本框3")
    
    let btn1 = UIButton.init(type: .custom).qtitle("按钮1按钮1按钮1按钮1").qtitleColor(.black).qbackgroundColor(.lightGray)
    let btn2 = UIButton.init(type: .custom).qtitle("按钮2按钮2按钮2按钮2").qtitleColor(.black).qbackgroundColor(.lightGray)
    let btn3 = UIButton.init(type: .custom).qtitle("按钮3按钮3按钮3按钮3").qtitleColor(.black).qbackgroundColor(.lightGray)
    override func viewDidLoad() {
        super.viewDidLoad()
        self.view.backgroundColor = .white

        self.view.qbody([
            label1.qmakeConstraints({ make in
                make.left.right.equalToSuperview().inset(20)
                make.top.equalToSuperview().inset(qnavigationbarHeight)
            }),
            label2.qmakeConstraints({ make in
                make.left.right.equalTo(self.label1)
                make.top.equalTo(self.label1.snp.bottom).offset(30)
            }),
            label3.qmakeConstraints({ make in
                make.left.right.equalTo(self.label1)
                make.top.equalTo(self.label2.snp.bottom).offset(30)
            }),
            
            /// 垂直排列的UIStackView 
            VStackView.qbody([
                btn1,
                btn2,
                btn3
            ]).qmakeConstraints({ make in
                make.left.right.equalToSuperview()
                make.top.equalTo(self.label3.snp.bottom).offset(50)
            }).qspacing(15),
            
            /// 也可以直接使用数组 :[UIView], qjoined()方法，将直接组合生成一个UIStackView
//            [btn1, btn2, btn3].qjoined(aixs: .vertical, spacing: 15, align: .fill, distribution: .equalSpacing)
//                .qmakeConstraints({ make in
//                    make.left.right.equalToSuperview()
//                    make.top.equalTo(self.label3.snp.bottom).offset(50)
//                })
        ])
    }
}

/// 添加子视图, 如果是stackView，会添加addArrangedSubview
@discardableResult
func qbody(_ views: [UIView]) -> Self {
    if let stackView = self as? UIStackView {
        views.forEach({stackView.addArrangedSubview($0)})
    } else {
        views.forEach({self.addSubview($0)})
    }
    /// 激活约束
    views.forEach({$0.qactiveConstraints()})
    return self
}
/// 激活snap的约束
@discardableResult
func qactiveConstraints() -> Self {
    if let constraintMake = qconstraintMake {
        self.snp.makeConstraints(constraintMake)
        self.qconstraintMake = nil
    }
    return self
}

/// 一键开关
QGrayFloatManager.shared.isgrayActive = true // or false

/// 飘灰视图层级，默认为1， view.layer.zPosition默认为0，数值越大，图层越处于顶层
QGrayFloatManager.shared.zposition = 1 

tableView
    .qregister(TestTableViewCell.self, identifier: "cell")
    .qnumberofSections {
        return 1
    }.qnumberofRows { section in
        return 100
    }.qcell { tableView, indexPath in
        let cell: TestTableViewCell = (tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath) as? TestTableViewCell) ?? .init(style: .default, reuseIdentifier: "cell")
        let rad = indexPath.row
        cell.nameLabel.text = "阿斯加德发按理阿斯加德发按理"
        cell.timeLabel.text = "05:20"
        cell.cover.isHidden = rad % 3 == 0
        return cell
    }.qdidSelectRow { tableView, indexPath in
        tableView.deselectRow(at: indexPath, animated: false)
        print("---- selected:\(indexPath)")
    }

tableView
    .qcanEdit { indexPath in
        return true
    }.qcanMove { indexPath in
        return true
    }.qeditActions { indexPath in
        let aciton = UITableViewRowAction.init(style: .default, title: "删除") { _, indexPath in
            
        }
        return [aciton]
    }

tableView
    .qcontentSizeChanged { scrollView in
        print("contentsize changed 改变")
    }.qcontentOffsetChanged { scrollView in
        print("contentoffset changed 改变")
    }.qdidScroll { scrollView in
        print("scrollView 滚动")
    }.qdidEndScroll { scrollView in
        print("scrollView 停止滚动")
    }

/// 拖拽时，style
public enum QDragPanStyle {
    /// 普通模式，手势停止则view停止, 如果view太靠近边界，需要修正的位置edge
    case normal(edge: UIEdgeInsets)
    /// 吸边，停止之后，自动吸附到水平（左右）靠近的一边
    case nearHorizontal(edge: UIEdgeInsets)
    /// 吸边，停止之后，自动吸附到垂直（上下）靠近的一边
    case nearVertical(edge: UIEdgeInsets)
    /// 吸边，停止之后，自动吸附到靠的最近的一边
    case nearBorder(edge: UIEdgeInsets)
}

let testView = UIView()
    .qsizeChanged { view in
        print("view size 改变")
    }.qtap { view in
        print("view 单击手势 响应")
    }.qdeinit {
        // 被释放
    }.qshowToWindow { view, show in
        // 显示在window
    }
    .qdrag(style)  // 拖拽  可自动吸边
    ///.qborder(.black, 1)
    /// 设置左上、右下圆角
    ///.qcornerRadiuscustom([.topLeft, .bottomRight], radii: 50)
    .qcornerRadius(50, false)
    .qbackgroundColor(.lightGray)
    .qshadow(.red, .init(width: 5, height: 5), radius: 20)
    
    等等等等

let label = UILabel()
    .qfont(.systemFont(ofSize: 15))
    .qtextColor(.red)
    .qnumberOfLines(0)
    .qtap { view in
        print("点击了label")
    }
    等等等等

let btn = UIButton.init(type: .custom)
    .qtitle("按钮")
    .qtitleColor(.red)
    .qactionFor(.touchUpInside) { sender in
        print("点击了按钮 事件响应")
    }.qtap { view in
        print("点击了按钮 tap响应 如果设置了tap， qactionFor touchUpInside方法无效 将被覆盖")
    }.qisSelectedChanged { sender in
        // isSelected 状态改变
        sender.backgroundColor = sender.isSelected ? .red : .lightGray
    }.qisEnabledChanged { sender in
        // isEnabled 状态改变
        sender.alpha = sender.isEnabled ? 1 : 0.3
    }

public extension UIControl {
    /// control的事件回调
    @discardableResult
    func qactionFor(_ event: UIControl.Event, handler:((_ sender: UIControl) -> Void)?) -> Self { }
}

let textField = UITextField.init(frame: .zero)
    .qplaceholder("输入文本")
    .qmaxCount(10) // 最多输入字数 区别在于一个表情长度=1
//        .qmaxLength(10) // 最多输入字数 区别在于一个表情长度=2（也有大于2）
    .qbackgroundColor(.lightGray.withAlphaComponent(0.3))
    .qleftView(UIView.init(frame: .init(x: 0, y: 0, width: 30, height: 30)), .always)
    .qclearButtonMode(.always)
    .qfont(.systemFont(ofSize: 16))
    .qtextColor(.red)
    .qtextChanged({ textField in
        print("text 改变")
    }).qshouldChangeText { textField, range, replaceText in
        return true
    }.qshouldBeginEditing { textField in
        return true
    }

let textView = UITextView.init(frame: .zero)
    .qplaceholder("请输入文本")
    .qmaxCount(10) // 最多输入字数 区别在于一个表情长度=1
//        .qmaxLength(10) // 最多输入字数 区别在于一个表情长度=2（也有大于2）
    .qfont(.systemFont(ofSize: 17))
    .qtextColor(.qhex(0xff0000))
    .qbackgroundColor(.lightGray.withAlphaComponent(0.3))
    .qtextChanged({ textView in
        print("text 改变")
    })

// let vc = UIViewController()
vc.qdidpop {
    print("self 从navigationController 中 pop 出去了")
}.qdidAppear {
    
}.qdidDisAppear {
    
}.qwillAppear {
    
}.qwillDisAppear {
    
}.qdeinit {

}

let actions = ["按钮1", "按钮2", "按钮3"]
UIAlertController.qwith(title: "标题", "提示内容", actions: actions, cancelTitle: "取消", style: .alert) { index in
    print("点击了\(actions[index])， index是取自数组下标")
} cancel: {
    print("点击了取消")
}

/// app 的 keywindow
public var qappKeyWindow: UIWindow {
    if let window = UIApplication.shared.delegate?.window, let window = window {
        return window
    }
    if #available(iOS 13.0, *) {
        let arraySet: Set = UIApplication.shared.connectedScenes
        let windowScene: UIWindowScene? = arraySet.first(where: { sce in
            if let _ = sce as? UIWindowScene {
                return true
            }
            return false
        }) as? UIWindowScene
        if let window = windowScene?.windows.first(where: {$0.isKeyWindow}) {
            return window
        }
    }
    if let window = UIApplication.shared.windows.first(where: {$0.isKeyWindow}) {
        return window
    }
    return UIApplication.shared.keyWindow ?? .init()
}

/// app 上下左右安全距离，没有刘海屏，则顶部为状态栏高度，其余为0
public var qappSafeAreaInsets: UIEdgeInsets {
    if #available(iOS 11.0, *) {
        return qappKeyWindow.safeAreaInsets
    } else {
        return .init(top: qstatusbarHeight, left: 0, bottom: 0, right: 0)
    }
}

/// 是否是刘海屏
public var qisiPhoneNotch: Bool {
    if #available(iOS 11.0, *) {
        return qappKeyWindow.safeAreaInsets.bottom > 0
    } else {
        return false
    }
}

/// 底部安全区域 刘海屏是34， 也有21
public var qbottomSafeHeight: CGFloat {
    return qappSafeAreaInsets.bottom
}

/// 导航栏高度
/// iOS13之后，导航栏高度不固定
public var qstatusbarHeight: CGFloat {
    if #available(iOS 13.0, *),
        let height = qappKeyWindow.windowScene?.statusBarManager?.statusBarFrame.size.height {
        return height
    }
    return UIApplication.shared.statusBarFrame.size.height
}

/// 导航栏高度 44 + 状态栏高度
public var qnavigationbarHeight: CGFloat {
    return qstatusbarHeight + 44
}

/// 设备是否横屏
public var qisdeviceLandscape: Bool {
    var type: UIInterfaceOrientation = UIApplication.shared.statusBarOrientation
    if #available(iOS 13.0, *), let t = qappKeyWindow.windowScene?.interfaceOrientation {
        type = t
    }
    switch type {
    case .landscapeLeft, .landscapeRight:
        return true
    case.portrait, .portraitUpsideDown, .unknown:
        return false
    }
}

QuicklyAppFrame.swift

qAppFrame.navigationController?  // 获取当前最顶层vc所在的navigationController

qAppFrame.viewControllers   // 获取当前最顶层vc所在的navigationController 的所有的栈viewControllers

qAppFrame.pushViewController(vc, animated:) // 跳转到vc，忽略重复的跳转vc （如果因为卡顿或者其他原因，重复跳转到这一个vc时）

qAppFrame.present(vc, animated: complete)  // 模态打开vc

/// 从当前navigationController栈里移除vc
qAppFrame.remove(viewController: UIViewController, animate: Bool)
qAppFrame.remove(viewControllerClass: AnyClass, animate: Bool)

self.view.qbody([
    label1.qmakeConstraints({ make in
        make.left.right.equalToSuperview().inset(20)
        make.top.equalToSuperview().inset(qnavigationbarHeight)
    }),
    label2.qmakeConstraints({ make in
        make.left.right.equalTo(self.label1)
        make.top.equalTo(self.label1.snp.bottom).offset(30)
    }),
    label3.qmakeConstraints({ make in
        make.left.right.equalTo(self.label1)
        make.top.equalTo(self.label2.snp.bottom).offset(30)
    }),
    
    /// 垂直排列的UIStackView 
    VStackView.qbody([
        btn1,
        btn2,
        btn3
    ]).qmakeConstraints({ make in
        make.left.right.equalToSuperview()
        make.top.equalTo(self.label3.snp.bottom).offset(50)
    }).qspacing(15),
   
    /// 也可以直接使用数组 :[UIView], qjoined()方法，将直接组合生成一个UIStackView
//            [btn1, btn2, btn3].qjoined(aixs: .vertical, spacing: 15, align: .fill, distribution: .equalSpacing)
//                .qmakeConstraints({ make in
//                    make.left.right.equalToSuperview()
//                    make.top.equalTo(self.label3.snp.bottom).offset(50)
//                })
])