仿腾讯课堂固定滚动列表ReactNative组件

前言

由于业务需要做成类似腾讯课堂课程详情滚动的效果,考虑到后面有可能有新的呈现方式,RN提供的组件没有这种滚动控件,不如自己封装。


效果图.gif
  • 项目地址 在这里,如果有好的意见欢迎提 issue或pr。

开始

  • 我们先来看下,腾讯课堂视频播放详情页面是怎么样的?
腾讯课堂视频.gif
  • 咋一看界面感觉有点复杂,其实简化来说,这个界面可以看成tab组件+scroll组件。哲学上说,要抓好主要矛盾与次要矛盾,这个问题的主要矛盾是scroll组件实现,也就是最外层的RNFixScrollView。
分解图.png
  • 说道这里,我尝试着写了个测试js例子,最外面套一个ReactNative自带的ScrollView并设置视频播放控件的高度为200Tab导航控件style={{height: windowHeight- 80}},那这样滚动距离到120时,滚动条到底部了,视频播发控件的区域距离屏幕顶部还有80。

  • 跑起来运行后发现的一个严重的问题是,如果Tab导航控件的内容区域存在ScrollView或者ListView时,无法滚动,只有最外层可以滚动,也就是手势滚动被拦截了?

  • 一开始想两种大的思路:一种是完全靠JS层面,通过ScrollView暴露的API去实现,第二种是原生+JS,这里涉及到几个关键的东西,如何寻找Tab导航控件中的ScrollView或者ListView和控制手势实现的效果 -- 外层滚动容器到顶部+手势往上则通知内层滚动容器开始滚动;内层到顶部+手势往下则通知外层开始滚动。

  • 发现第一种方法在解决如何寻找子控件并判断滚动状态上没有方法(可能是我没发现)以及性能上的考量,那就采用第二种方法。

分析

为了解决上面的问题,我们需要了解几个关键点。

  • 一个是怎么判断手势滑动以及外层滚动容器到底部和内层滚动到顶部?
  • 第二个是寻找滚动组件并通知内层滚动组件开始滚动?

因此,网上搜寻这两个问题的相关资料和解决办法,判断是否到底部很容易搜到了,当然了解了其原理。另外,判断手势是往上滑还是往下滑的问题放到后面说明。

寻找内层滚动容器,一开始是认为递归寻找可见的ScrollView实例(Android中界面控件是一种树形结构),通过Hierarchy Viewer工具发现这三个都是可见的,随后对比三个ScrollView属性发现其在屏幕上的LocationOnScreenX坐标不同,如果当前滚动容器显示则等于0。

剩下最后一个如何通知内层容器滚动呢?先卖个关子,在解决这个问题之前,我们先来了解下Android中的View事件是如何传递的。

正所谓知己知彼,百战不殆,看看Android触摸事件类型有哪些?我们想下玩手机的时候手指的情况:落下手指,抬起手指,移动手指是三种基本的操作,其实也是3种触摸事件,分别代表着MotionEvent.ACTION_DOWN,MotionEvent.ACTION_UP,MotionEvent.ACTION_MOVE

简单来说,如下图所示:触摸事件发生后,如果事件的坐标处于ViewGroup的管辖范围,那么首先调用ViewGroup的dispatchTouchEvent方法,然后其内部调用onInterceptTouchEvent()方法来判断是否拦截该触摸事件,若拦截该事件则调用ViewGroup的onTouchEvent()方法,否则的话,交给其子View的dispatchTouchEvent处理。

image.png

具体可以参考我以前写的事件分发机制学习

回过头来讲外层滚动容器通知内层滚动,其实通知滚动相当于不拦截事件,那么就是重写 onInterceptTouchEvent方法并返回false。而这个方法会随着手势不断调用,这时候聪明的你想到了啥?根据手触摸屏幕的y坐标差来判断手势往上还是往下。手指滑动时会产生一系列触摸事件,这里有两种情况:说明下屏幕的左上角是坐标原点,沿着右边是x轴,左边则是y轴。
① Down -> Move ... -> Move -> UP
② Down -> Move ->... -> Move

记录Down触摸事件的Y坐标值作为起始值,Move或者UP的Y坐标值作为末尾值,两者之差大于最小滑动值则说明向上滑,小于最小滑动值则说明向上滑(这里简化了条件,如果是实现OnGestureListener的话判断滑动的话还有X轴滑动速度值和Y轴滑动速度值)。到这里前面提的两个问题都得到解决了,下面开始真正上手了。

如何封装RN组件

原生上要做的事
  • 1.创建原生固定滚动控件
  • 2.创建管理滚动控件ViewManager的子类
  • 3.创建实现了ReactPackage接口的类
JavaScript上要做的事
  • 4.实现对应的JavaScript模块

开始动手

1.创建原生固定滚动控件

根据前面的分析,我们知道写原生滚动控件主要是重写控制拦截事件方法onInterceptTouchEvent,这里先说明下我们只需要判断当前 Tab导航控件 存在 ScrollView 的话才进入我们的逻辑进行拦截控制,否则按默认的逻辑。

  • 需要在 MotionEvent.ACTION_DOWN 事件中,通过前面分析的条件寻找第一个子 ScrollView ,代码如下:
  private ScrollView findScrollView(ViewGroup group) {
        if (group != null) {
            for (int i = 0, j = group.getChildCount(); i < j; i++) {
                View child = group.getChildAt(i);
                if (child instanceof ScrollView) {
                    //获取view在整个屏幕中的坐标如果x==0的话代表这个scrollview是正在显示
                    int[] location = new int[2];
                    child.getLocationOnScreen(location);
                    System.out.print("locationx:" + location[0] + ",locationy:" + location[1]);
                    if (location[0] == 0)
                        return (ScrollView) child;
                    else
                        continue;

                } else if (child instanceof ViewGroup) {
                    ScrollView result = findScrollView((ViewGroup) child);
                    if (result != null)
                        return result;
                }
            }
        }
        return null;
    }
  • 声明计算滑动手势的两个点 Down点(x1, y1) Move点(x2, y2),这样出现两种情况:向上滑,向下滑

  • 在通过isAtBottom方法,判断RNFixScrollView是否滑到底部。

    public boolean isAtBottom() {
        return getScrollY() == getChildAt(getChildCount() - 1).getBottom() + getPaddingBottom() - getHeight();
    }
  • 综合上面的已知条件,只需要找出几种临界情况:
    RNFixScrolView已到底部&&向上滑:不拦截
    RNFixScrolView未到底部&&向上滑:拦截
    RNFixScrolView未到底部&&向下滑&&子ScrollView已到顶部:拦截
    RNFixScrolView已到底部&&向下滑&&子ScrollView未到顶部:不拦截,代码如下:
   @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        if (!mScrollEnabled) {
            return false;
        }

        int action = ev.getAction();
        if (action == MotionEvent.ACTION_DOWN) {
            //当手指按下的时候
            x1 = ev.getX();
            y1 = ev.getY();
            scrollView = findScrollView(this);
            isIntercept = false;
        }

        if ((action == MotionEvent.ACTION_MOVE) || (action == MotionEvent.ACTION_UP)) {
            //Tab导航控件是否存在ScrollView
            if (scrollView != null) {
                //当手指移动或者抬起的时候计算其值
                x2 = ev.getX();
                y2 = ev.getY();
                //判断RNFixScrollView是否到底部 
                isbottom = isAtBottom();
                //向上滑动
                if (y1 - y2 > FLING_MIN_DISTANCE ) {
                    if (!isbottom) {
                        isIntercept = true;
                    } else {
                        isIntercept = false;
                    }
                    return isIntercept;
                } //向下滑动
                else if (y2 - y1 > FLING_MIN_DISTANCE ) {
                    int st = scrollView.getScrollY();
                    if (!isbottom) {
                        isIntercept = true;
                    } else {
                        if (st == 0) {
                            isIntercept = true;
                        } else {
                            isIntercept = false;
                        }
                    }
                    return isIntercept;
                }
            }
        }
        //不加的话 ReactScrollView滑动不了
        if (super.onInterceptTouchEvent(ev)) {
            NativeGestureUtil.notifyNativeGestureStarted(this, ev);
            ReactScrollViewHelper.emitScrollBeginDragEvent(this);
            mDragging = true;
            enableFpsListener();
            return true;
        }
        return false;
    }

以上代码完成了第一步创建原生固定滚动控件主要逻辑。

2.创建管理滚动控件ViewManager的子类

简单讲下,copy RN自带的ScrollViewManager 类,修改类名和其他引用到ScrollViewManager 。另外注意修改字段,REACT_CLASS = "RNFixedScrollView",这个与JS的模块的名字存在映射。

3.创建实现了ReactPackage接口的类并注册

RNAppViewsPackage 类

public class RNAppViewsPackage implements ReactPackage {
    @Override
    public List<NativeModule> createNativeModules(
            ReactApplicationContext reactContext) {
        List<NativeModule> modules = new ArrayList<>();
        return modules;
    }

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
        return Arrays.<ViewManager>asList(
                new RNFixedScrollViewManager()
        );
    }
}

MainApplication类进行注册

 @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
              new RNAppViewsPackage()
      );
    }
4.实现对应的JavaScript模块

简单讲下,copy RN自带ScrollViewJS的module,修改注释上 providesModule 的值RNFixedScrollView以及导出原生模块的名称,与第二步的值存在映射。

if (Platform.OS === 'android') {
  nativeOnlyProps = {
    nativeOnly: {
      sendMomentumEvents: true,
    }
  };
  AndroidScrollView = requireNativeComponent(
    'RNFixedScrollView',
    (ScrollView: React.ComponentType<any>),
    nativeOnlyProps
  );
}

完成上面的内容后,可以通过导入 import RNFixedScrollView from './modules/RNFixedScrollView',使用 RNFixedScrollView 控件

测试

为了模拟这个界面,构建了下面的代码,其中 ViewPagerPage组件是Tab导航控件,详细代码请转到 github

  • 主页面
 <View style={styles.container}>
                <RNFixedScrollView showsVerticalScrollIndicator={false}>
                    <View style={{
                        backgroundColor: '#87cefa',
                        height: 200,
                    }}>
                    </View>
                    <ViewPagerPage style={{height: windowHeight- 80}}/>
                </RNFixedScrollView>
            </View>
  • Tab导航控件,第二个tab内容区域嵌套了 FlatList,其他两个则显示文字。
import {StyleSheet, View, Text, Platform, Image, TouchableOpacity, Animated, Dimensions, FlatList} from 'react-native';
import React, {Component} from 'react';
import {PagerTabIndicator, IndicatorViewPager, PagerTitleIndicator, PagerDotIndicator} from 'rn-viewpager';

const windowWidth = Dimensions.get('window').width;
export default class ViewPagerPage extends Component {

    static title = '<FlatList>';
    static description = 'Performant, scrollable list of data.';

    state = {
        data: this.genItemData(20,0),
        debug: false,
        horizontal: false,
        filterText: '',
        fixedHeight: true,
        logViewable: false,
        virtualized: true,
    };

    genItemData(loadNum,counts){
       let items = [];
       for(let i=counts;i<counts+loadNum;i++){
           items.push({key:i});
        }
        return items;
    };

    _onEndReached(){
        this.setState((state) => ({
            data: state.data.concat(this.genItemData(10, state.data.length)),
        }));
    };

    render() {
        return (

                <IndicatorViewPager
                    style={[{backgroundColor: 'white', flexDirection: 'column-reverse'},this.props.style]}
                    indicator={this._renderTitleIndicator()}
                >
                    <View style={{backgroundColor: 'cornflowerblue'}}>
                        <Text>这里是课程介绍</Text>
                    </View>
                    <View style={{backgroundColor: 'cadetblue'}}>
                        <FlatList
                            ItemSeparatorComponent={() => <View
                                style={{height: 1, backgroundColor: 'black', marginLeft: 0}}/>}
                            data={this.state.data}
                            onEndReached={this._onEndReached.bind(this)}
                            onEndReachedThreshold={0.2}
                            renderItem={({item}) => <View
                                style={{  justifyContent: 'center',height:40,alignItems:'center'}}><Text
                                style={{fontSize: 16}}>{"目录"+item.key}</Text></View>}
                        />
                    </View>
                    <View style={{backgroundColor: '#1AA094'}}>
                        <Text>相关课程</Text>
                    </View>
                </IndicatorViewPager>

        );
    }

    _renderTitleIndicator() {
        return <PagerTitleIndicator style={{
            backgroundColor: 0x00000020,
            height: 48
        }} trackScroll={true} itemStyle={{width: windowWidth / 3}}
                                    selectedItemStyle={{width: windowWidth / 3}} titles={['详情介绍', '目录', '相关课程']}/>;
    }


}

总结

  • 从编写玩这个组件在RN组件封装还是很有收获的,对于衡量使用不同的方案进行选择也有了体会。
  • 调试代码的时候需要技巧,通过注释不同的代码段,对于渲染不出界面是一种好的方法。
  • 弄清楚原理后编码会少犯很多错误。

参考:

讲讲Android事件拦截机制
Android 屏幕手势滑动

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