【React Native】react-native-scrollable-tab-view

一张跟内容完全关系的图

介绍

一个带有TabBar和可切换页面的控件。
Android中可以看成是ViewPagerTabLayout的结合。
实际效果的话,就下面这样了。

官方的动图

你可以选择直接上官方Github了解怎么使用,或者继续往下看我装逼。

【React Native】react-native-scrollable-tab-view_第1张图片

添加到项目中

npm install react-native-scrollable-tab-view --save

使用

基本用法

tabLabel指定Tab名称

render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}

效果:


【React Native】react-native-scrollable-tab-view_第2张图片

(怎么感觉比Android里面简单多了~~)

使用goToPage切换页面

render() {
    return (
         {
                this.tabView = tabView;
            }}>
            Tab 1
            Tab 2
            

this.tabView.goToPage(0):跳转到第0页 (页面:0、1、2...)

Props

  • renderTabBar (Function:ReactComponent)
    TabBar的样式,可以使用官方提供的DefaultTabBar(默认)、ScrollableTabBar,也可以自定义。
render() {
    return (
         }>
            Tab 1
            Tab 2
            Tab 3
        
    );
}

DefaultTabBar:自动分配水平方向的空间,空间不够时每个Tab会自动换行。
ScrollableTabBar:可以超过屏幕范围,滚动可以显示。

当然,我们还可以对他的样式进行调整。

    render() {
        return (
            
                    }>
                ...
            
        );
    }

borderWidth:设置边框(感觉没什么用)
elevation:层级效果(阴影)
tabStyle:每个小TabStyle
(修改style-height后,不改变tabStyle-height会导致TabBar内容不居中)

  • tabBarPosition (String)
    TabBar的位置。top(default)、bottomoverlayTop(顶部、悬浮在内容视图之上)、overlayBottom(底部、悬浮在内容视图之上)
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}

效果的话你一个个去试吧~~

  • onChangeTab (Function)
    页面改变监听。回调函数中有一个Object类型的参数,包含两个keyi(当前选中页面的下标)、ref(被选中的Tab对象)
render() {
    return (
         {
                console.log('current index : ' + obj.i)
            }}>
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • onScroll (Function)
    滑动监听。回调函数中有一个float类型的参数,表示滑动的偏移。
    如:当前页面和下个页面的中间值
    例:
    page0->page1 :0 -> 0.2 -> 0.3 ... 1 ;
    page2->page3: 2->2.1->2.2->2.3 ... 3
render() {
    return (
         {
                console.log('position : ' + position)
            }}>
            Tab 1
            Tab 2
            Tab 3
        
    );
}

从page0滑动到page1时打印的结果:


【React Native】react-native-scrollable-tab-view_第3张图片
page0->page1
  • locked (Bool)
    阻止滑动,默认为false。设置成true后,只能通过点击Tab来切换页面。
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • initialPage (Integer)
    默认选择的页面,默认为0。
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • page (Integer)
    我也不知道干嘛用的,官方给了这样的介绍
    set selected tab(can be buggy see #126

  • tabBarUnderlineStyle (View.propTypes.style)
    TabBar指示器的样式

    render() {
        return (
            
                Tab 1
                Tab 2
                Tab 3
            
        );
    }
  • tabBarBackgroundColor (String)
    TabBar背景色
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • tabBarActiveTextColor (String)
    Tab选中时的文字颜色
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • tabBarInactiveTextColor (String)
    Tab未选中时的文字颜色
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • tabBarTextStyle (Object)
    TabBar文字样式
tabBarTextStyle={fontFamily: 'Roboto', fontSize: 15} 

怎么用????

  • scrollWithoutAnimation (Bool)
    是否不显示指示条的左右移动的动画,默认`false
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}
  • prerenderingSiblingsNumber (Integer)
    预渲染当前页面相邻页面数量,默认为0。若设置为1,预渲染当前页左右共两个页面。
    (类似android中ViewPager 的setOffscreenPageLimit(int arg0);)
render() {
    return (
        
            Tab 1
            Tab 2
            Tab 3
        
    );
}

在完全显示页面前(滑动的过程中),默认是不渲染View的。只有完全切换到当前页面时,才开始渲染选中的View。
例:第一次page0->page1,当page1未完全显示时。page1还未开始渲染,是个空页面。

参考

react-native-scrollable-tab-view
[React Native]react-native-scrollable-tab-view(入门篇)

以上有错误之处,感谢指出

你可能感兴趣的:(【React Native】react-native-scrollable-tab-view)