maskmale/jxpagingview

类似微博主页、简书主页等效果。多页面嵌套，既可以上下滑动，也可以左右滑动切换页面。支持HeaderView悬浮、支持下拉刷新、上拉加载更多。

JXPagingView

类似微博主页、简书主页、QQ联系人页面等效果。多页面嵌套，既可以上下滑动，也可以左右滑动切换页面。支持HeaderView悬浮、支持下拉刷新、上拉加载更多。

功能特点

• 支持OC与Swift，OC版本细节查看JXPagerViewExample-OC工程；
• 手势交互更自然；
• 悬浮的categoryView支持更多效果，而且支持自定义扩展；
• 封装性更好，不用关心内部实现，只需要实现对应delegate方法即可；
• 支持像使用普通UITableView一样，添加首页下拉刷新功能；
• 支持列表视图添加下拉刷新、上拉加载更多；

预览

效果	预览图
头图缩放
主页下拉刷新&列表上拉加载更多
列表下拉刷新
导航栏隐藏
CollectionView列表示例 只有swift的demo工程有该示例

头图缩放说明

头图缩放原理，有不明白的可以参考我写的：JXTableViewZoomHeaderImageView 一看就懂了。

悬浮HeaderView说明

悬浮的HeaderView，用的是我写的：JXCategoryView 几乎实现了所有主流效果，而且非常容易自定义扩展，强烈推荐阅读。

列表下拉刷新说明

需要使用JXPagingListRefreshView类（是JXPagingView的子类）

安装

手动

Swift版本： Clone代码，拖入JXPagingView-Swift文件夹，使用JXPagingView类；

OC版本： Clone代码，拖入JXPagerView文件夹，使用JXPagerView类；

CocoaPods

• Swift版本

target '<Your Target Name>' do
    pod 'JXPagingView/Paging'
end

• OC版本

target '<Your Target Name>' do
    pod 'JXPagingView/Pager'
end

Swift与OC的仓库地址不一样，请注意选择！

pod install之前最好pod repo udpate一下！

使用

主要遵从JXPagingViewDelegate和JXPagingViewListViewDelegate协议就可以实现了，逻辑非常简单明了。具体实现细节请查阅源码。

1.实例化JXPagingView

    let pagingView = JXPagingView(delegate: self)
    self.view.addSubview(pagingView)

2.实现JXPagingViewDelegate

@objc public protocol JXPagingViewDelegate: NSObjectProtocol {
    /// tableHeaderView的高度
    ///
    /// - Parameter pagingView: JXPagingViewView
    /// - Returns: height
    func tableHeaderViewHeight(in pagingView: JXPagingView) -> CGFloat


    /// 返回tableHeaderView
    ///
    /// - Parameter pagingView: JXPagingViewView
    /// - Returns: view
    func tableHeaderView(in pagingView: JXPagingView) -> UIView


    /// 返回悬浮HeaderView的高度。
    ///
    /// - Parameter pagingView: JXPagingViewView
    /// - Returns: height
    func heightForPinSectionHeader(in pagingView: JXPagingView) -> CGFloat


    /// 返回悬浮HeaderView。我用的是自己封装的JXCategoryView（Github:https://github.com/pujiaxin33/JXCategoryView），你也可以选择其他的三方库或者自己写
    ///
    /// - Parameter pagingView: JXPagingViewView
    /// - Returns: view
    func viewForPinSectionHeader(in pagingView: JXPagingView) -> UIView

    /// 返回listViews，只要遵循JXPagingViewListViewDelegate即可，无论你返回的是UIView还是UIViewController都可以。
    ///
    /// - Parameter pagingView: JXPagingViewView
    /// - Returns: listViews
    func listViews(in pagingView: JXPagingView) -> [JXPagingViewListViewDelegate]

    /// mainTableView的滚动回调，用于实现头图跟随缩放
    ///
    /// - Parameter scrollView: JXPagingViewMainTableView
    @objc optional func mainTableViewDidScroll(_ scrollView: UIScrollView)
}

3.让底部listView（无论是UIView还是UIViewController都可以，swift版本demo工程有VC列表使用示例）遵从JXPagingViewListViewDelegate协议

//协议说明
@objc public protocol JXPagingViewListViewDelegate: NSObjectProtocol {

    /// 返回listView
    ///
    /// - Returns: UIView
    func listView() -> UIView

    /// 返回listView内部持有的UIScrollView或UITableView或UICollectionView
    /// 主要用于mainTableView已经显示了header，listView的contentOffset需要重置时，内部需要访问到外部传入进来的listView内的scrollView
    ///
    /// - Returns: listView内部持有的UIScrollView或UITableView或UICollectionView
    func listScrollView() -> UIScrollView


    /// 当listView内部持有的UIScrollView或UITableView或UICollectionView的代理方法`scrollViewDidScroll`回调时，需要调用该代理方法传入的callback
    ///
    /// - Parameter callback: `scrollViewDidScroll`回调时调用的callback
    func listViewDidScrollCallback(callback: @escaping (UIScrollView)->())
}

///当listView内部持有的UIScrollView或UITableView或UICollectionView的代理方法`scrollViewDidScroll`回调时，需要调用该代理方法传入的callback
func listViewDidScrollCallback(callback: @escaping (UIScrollView) -> ()) {
    self.listViewDidScrollCallback = callback
}

//self.listViewDidScrollCallback在listView的scrollViewDidScroll代理方法里面回调
func scrollViewDidScroll(_ scrollView: UIScrollView) {
    self.listViewDidScrollCallback?(scrollView)
}

OC版本使用类似，只是类名及相关API更改为JXPagerView，具体细节请查看JXPagerViewExample-OC工程。

关于下方列表视图的代理方法func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath)有时候需要点击两次才回调

出现步骤：当手指放在下方列表视图往下拉，直到TableHeaderView完全显示。

原因：经过上面的步骤之后，手指已经离开屏幕且列表视图已经完全静止，UIScrollView的isDragging属性却依然是true。就导致了后续的第一次点击，让系统认为当前UIScrollView依然在滚动，该点击就让UIScrollView停止下来，没有继续转发给UITableView，就没有转化成didSelectRow事件。

解决方案：经过N种尝试之后，还是没有回避掉系统的isDragging异常为true的bug。大家可以在自定义cell最下方放置一个与cell同大小的button，把button的touchUpInside事件当做didSelectRow的回调。因为UIButton在响应链中的优先级要高于UIGestureRecognizer。

代码：请参考TestTableViewCell类的配置。

TableHeaderView使用tips

如果TableHeaderView逻辑较多，一般都会用ViewController来包裹，然后使用ViewController.view当做TableHeaderView。又或者视图较多，使用xib来布局。

以上两种情况，都需要创建一个ContainerView，把ContainerView赋值给TableHeaderView，然后add真正的ViewController.view或xib视图到ContainerView上面。不这么做布局会有异常。

参考：demo工程BaseViewController文件里userHeaderContainerView的使用方式。

补充

有不明白的地方，建议多看下源码。再有疑问的，欢迎提Issue交流🤝