Code Monkey home page Code Monkey logo

collectionviewsiderefresh's Introduction

一款简单好用的UICollectionView横向滚动刷新控件

源码地址:(GitHub)

实现功能:

  • 接入简单,不侵入代码
  • 右拉刷新,左拉加载更多
  • 自定义提示文案和加载动画
  • 方便隐藏和显示加载提示文本和动画
  • 支持 ‘没有更多数据’ 提示

接入方式

  1. 下载源码,将文件夹 "SideRefresh"添加进工程
  2. 引入头文件 #import "UICollectionView+SideRefresh.h"
  3. 创建SideRefreshHeader和SideRefreshFooter并添加给UICollectionView即可

默认刷新样式

SideRefreshHeader *refreshHeader = [SideRefreshHeader refreshWithLoadAction:^{
    //执行刷新
}];
self.collectionView.sideRefreshHeader = refreshHeader;

SideRefreshFooter *refreshFooter = [SideRefreshFooter refreshWithLoadAction:^{
    //执行加载更多
}];
self.collectionView.sideRefreshFooter = refreshFooter;

默认样式

自定义刷新提示和图片动画

SideRefreshHeader *refreshHeader = [SideRefreshHeader refreshWithLoadAction:^{
    //执行刷新
}];
NSMutableArray *loadingImages = [NSMutableArray array];
for(int i = 1; i <= 9; i++) {
    UIImage *loadingImg = [UIImage imageNamed:[NSString stringWithFormat:@"loading_0%d", i]];
    if(loadingImg) {
        [loadingImages addObject:loadingImg];
    }
}
refreshHeader.loadingImages = loadingImages;//自定义图片动画
//自定义提示文案
refreshHeader.normalMessage = @"再拉我试试!";
refreshHeader.pullingMessage = @"松开,松开";
refreshHeader.loadingMessage = @"奔跑...";
self.collectionView.sideRefreshHeader = refreshHeader;

SideRefreshFooter *refreshFooter = [SideRefreshFooter refreshWithLoadAction:^{
    //执行加载更多
}];
self.collectionView.sideRefreshFooter = refreshFooter;

自定义

隐藏刷新提示或动画

SideRefreshHeader *refreshHeader = [SideRefreshHeader refreshWithLoadAction:^{
    //执行刷新
}];
refreshHeader.hideMessage = YES;//隐藏提示
self.collectionView.sideRefreshHeader = refreshHeader;

SideRefreshFooter *refreshFooter = [SideRefreshFooter refreshWithLoadAction:^{
    //执行加载更多
}];
refreshFooter.hideIndicator = YES;//隐藏加载动画
self.collectionView.sideRefreshFooter = refreshFooter;

隐藏提示或动画

‘没有更多数据’ 提示

显示默认提示

[self.collectionView showEmptyFooter]

显示自定义提示

[self.collectionView showEmptyFooterWithMessage:@"不要看了,没有了。"];

没有更多数据

PS:隐藏需要手动调用

[self.collectionView hideEmptyFooter];

实现方式

  • 通过Runtime为UICollectionView添加SideRefreshHeader和SideRefreshFooter属性
  • 观察UICollectionView的contentOffset实现拖动相关逻辑
  • 观察UICollectionView的contentSize来重置刷新视图
  • 更多细节参见源码Demo

如果觉得好用欢迎Star github, 使用问题请Issue。

collectionviewsiderefresh's People

Contributors

dengjianchenghcb avatar

Watchers

James Cloos avatar 小虫儿 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.