ReactNative--自定义下拉刷新组件(iOS)

RN有提供原生的下拉刷新组件(菊花刷新),但并没有提供自定义刷新组件的方法。也许你会照着RCTRefreshControl来一发,不过很可惜,RCTScrollView不允许你在其内部的scrollview上添加除contentView和RCTRefreshControl以外的view。当时自己打算做的自定义刷新组件,期望能够:

  1. 不改源码。
  2. 刷新组件的自定义能够像导出其他原生组件的方式一样。
  3. js一侧使用起来能和官方提供的原生刷新组件使用保持一致。

既然要不改源码,且使用起来和RN提供的方式一致,所以RCTScrollView的scrollview上必须可以添加其他刷新组件,于是想到了用OC的黑魔法,利用Method Swizzling,对RCTScrollView的insertReactSubview方法做处理,使自定义的刷新组件能够添加到scrollview上。经过整理,最后做到只需往项目中引入一个QSRefreshControl文件夹,就可获得自定义刷新组件的能力。

在看具体过程之前可以看一下demo:


demo2.gif

下面开始自定义下拉刷新组件的具体过程:

1. 在工程中添加QSRefreshControl文件夹,文件夹内包括了以下文件:
B9F995FA-3AB8-4EB6-A7CE-C6532C1B3019.png

QSRefreshControl是一个空白的下拉刷新组件,之后,QSRefreshControl和QSRefreshControlManager会作为基类来实现自定义刷新组件。QSRefreshMotionProtocol协议内定义了下拉刷新的各个阶段需要调用的方法以及一个返回下拉触发距离的方法。QSRefresh分类里则做了上面说的黑魔法相关的事情。

2. 自定义刷新组件,这里以TangramRefreshControl为例:
D7AEF65E-A5B8-4911-B806-90751080CAD6.png

先准备遵守QSRefreshMotionProtocol的动画视图Tangram。下拉刷新各阶段动画的处理分别放在对应的方法中实现。

  //MARK:实现QSRefreshMotionProtocol
  func draggingBeforeRelease(withOffset offset: CGFloat) {
    updateTangramBy(max(offset - 30, 0) / 90) //根据下拉距离设置动画进度
  }
  
  func releaseAndBeginRefreshing() {
    assembleSevensTo(.fox)
    startShining() //正在刷新时的处理
  }
  
  func stopRefreshingAndBackToOrigin() {
    stopShining() //刷新结束时的处理
  }
  
  func endAll() {
    assembleSevensToOrigin() //完成刷新各阶段,返回到原点
  }
  
  func triggerDistance() -> CGFloat {
    return 120 //触发距离
  }

接着创建TangramRefreshControl和TangramRefreshControlManager,分别继承QSRefreshControl和QSRefreshControlManager。
TangramRefreshControl里,我们只需在其初始化方法中将动画视图Tangram赋给refreshView属性 (refreshView是从QSRefreshControl中继承来的,表示刷新用的动画视图)。再重写下layoutSubviews方法,以便在scrollview大小改变时更改refreshView的位置或大小。(如果确定位置始终不变可以不重写,这里Tangram需要始终在scrollview上方居中,所以重写了下)。代码如下:

- (instancetype)init
{
  self = [super init];
  if (self) {
    self.refreshView = [[Tangram alloc] initWithFrame:CGRectMake(self.frame.size.width * 0.5 - 25, 0, 50, 70)];
  }
  return self;
}

- (void)layoutSubviews {
  [super layoutSubviews];
  self.refreshView.frame = CGRectMake(self.frame.size.width * 0.5 - 25, 0, 50, 70);
}

再来看TangramRefreshControlManager,如果不需要暴露其他属性(QSRefreshControlManager中已经暴露了refreshing和onRefresh),就直接如下了。

RCT_EXPORT_MODULE();

- (TangramRefreshControl*)view
{
  return [TangramRefreshControl new];
}
3. 这样,原生端的处理就结束了,再来看js端的使用。先获取刷新组件
import {
  requireNativeComponent
} from 'react-native'; 
var Tangram = requireNativeComponent('TangramRefreshControl');

接着在scrollview上

<ScrollView
  refreshControl={
    <Tangram 
    refreshing={this.state.refreshing}
    onRefresh={this._handleRefresh}
    />}
>
</ScrollView>

这样下拉刷新就添加完成了,可以看到我们依然使用了ScrollView的refreshControl属性,做到了与官方的一致(为什么可以这样使用,可以看一下ScrollView的源码哦),其他诸如Flatlist等基于ScrollView封装的组件,一样可以通过这样的方式添加(注意Flatlist不要直接设置onRefresh属性,设置了就默认使用那个菊花刷新了)。

QSRefreshControl文件夹在github上可以获取到

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,565评论 6 479
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,021评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,003评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,015评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,020评论 5 370
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,856评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,178评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,824评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,264评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,788评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,913评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,535评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,130评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,102评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,334评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,298评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,622评论 2 343

推荐阅读更多精彩内容