RN的ScrollView和ListView

1、ScrollView组件

RN封装了Android与IOS两大操作系统提供的滚动视图组件,该组件支持RN组件View的所有属性,本身没有独有的样式设计。

1.1 ScrollView组件属性

ScrollView除了拥有View的属性外,还有以下独有属性:
1、contentContainerStyle:
用于定义组件的容器样式(容器中包括所有子组件)
2、horizontal:
布尔类型,默认为false,如果为true,滚动列表所有子组件将水平排列。
3、KeyboardDismissMode:
@字符串类型属性。
@取值可以为none,interactive,on-drag。
@决定了滑动列表中某一组件呼出了软键盘,是否允许通过拉软键盘这一动作让软键盘消失。
1.1、none是不允许
1.2、on-drag:表示在手势开始的时候,软键盘会消失。
1.3、interactive:表示键盘消失的动画会与手势交互对应,若用户向上拉,则软键盘不会消失。

注意:Android操作系统只支持none

4、onContentSizeChange:是一个回调函数,当承载ScrollView的父组件的宽高发生改变的时候会调用该方法。

5、onScroll:回调函数,在滑动时调用。

6、pagingEnable:布尔类型,默认false,当为true时,滑动组件中显示的内容在划过整数倍的宽高后会停止滑动,适合用来实现水平方向整页滑动,类似电子书界面。

7、scrollEnabled:布尔类型,为false时,将不能滑动。

8、showsHorizontalScrollIndicator与showsVerticalScrollIndicator:分别表示是否显示水平与垂直的滑动指示器,为布尔类型。

1.2 ScrollViiew组件Android专有属性

endFillColor: 为颜色类型的属性,如果ScrollView组件的宽高大于它的内容所需宽高,那么剩余的空间会渲染为指定的颜色。

1.3 ScrollView组件的公开函数

scrollTo函数:

数据结构:

{
x: aNumber, //横坐标
y:aNumber, //纵坐标
animated:aBool//是否需要动画效果
}

调用形式:aScroll.scrollTo({放入参数});

1.4 RefreshControl组件(下拉刷新)

该组件专门为ScrollView服务,当ScrollView拉动到顶部的时候,如果给该组件赋予一个RefreshControl组件,那么就会显示这个组件,就类似于下拉刷新组件,可以在此时请求网络做数据更新操作。
onRefresh: 当ScrollView拉到顶部时候,调用该方法。
refreshing: 布尔类型,当前是否刷新控制并显示刷新组件。

e.g.

<ScrollView style={styles.scrollView} onScroll={this.onScroll} 
                  refreshControl={
                    <RefreshControl refreshing={true}
                                    onRefresh={this._onRefresh}
                                    tintColor="#ff0000"
                                    title="加载中……"
                                    colors={['#ff0000','#00ff00','#0000ff']}
                                    progressBackgroundColor="#ffff00"/>
                  }>
</ScrollView>

1.4.1 Android平台特有的RefreshControl属性:

1、colors: 数组类型,用来指定刷新指示器的颜色,可以颜色变换。
2、enabled:是否打开刷新功能,为布尔类型。
3、progressBackgroundColor: 颜色类型,用于指定刷新指示器的背景颜色。
4、size: 为RefreshLayoutConsts.SIZE属性,用于指定刷新指示器的大小,默认为DEFAULT。

2、ListView组件

2.1 ListView组件的回调函数

1、onEndReached: 在ListView所有行都被渲染到屏幕上,并且列表被滑动到底部时候调用,无参无返回值。
2、renderFooter: 用来渲染列表底部,不接受任何参数,需要返回一个renderable组件,每一次重新渲染会调用一次。
3、renderHeader: 渲染首部,同上。
4、renderRow: 回调函数,渲染列表的每一行,接收四个参数,rowData、sectionID、rowID、highlightRow,并需要返回一个可渲染对象,四个参数分别为数据、数据ID、行号以及一个高亮显示某行的回调函数,但该函数在如今的RN当中还未被实现。
5、renderScrollComponent: 提供一个可滑动组件供List在其中渲染,默认返回一个ScrollView组件。
6、renderSectionHeader: 用于渲染某一节的头部,接收sectionData与sectionID,并返回一个可渲染组件。
7、renderSeparator: 用来在每一行下面(但如果下一行是另一节的开头则不会渲染)渲染一个分割单元,接收sectionID,rowID与adjacentRowHighlighted三个参数,返回可渲染组件。
8、onChangeVisibleRows: 回调函数,用于通知哪些行已经是可见行,哪些行的可见性已经改变,接收两个参数:visibleRows,changedRows,无需返回值,visibleRows是一个map结构,格式为{sectionID:{rowID:true|false}},changedRows同样如此,为true时可见,反之不可见。

2.2 其他属性

1、dataSource: 是一个ListViewDataSource类型,用来描述列表数据来源。
2、 initialListSize: 定义有多少行会在挂接时被渲染。
3、onEndReachedThreshold:数值类型属性,需要结合onEndReached回调函数使用,以pt为单位。
4、pageSize: 数值类型,默认值为1,即在每一次消息循环中只有一行会被渲染。
5、removeClippedSubviews:布尔类型,无默认值,为true时,RN将会对在屏幕以外的元素不进行计算而提高滑动流畅度,该函数仍处在实验阶段。需要配合view中添加overflow:hidden实现。

e.g.

//声明DataSource的状态机变量:
this.state={
      diaryListDataSource:new ListView.DataSource({rowHasChanged:(oldRow,newRow)=>{
        oldRow!==newRow;
      }})

//将数据源中的数据复制到DataSource中:
componentWillMount(){
    if(this.props.diaryList===null){
      return;
    }
    this.setState({
      diaryListDataSource:this.state.diaryListDataSource.cloneWithRows(this.props.diaryList)
    });
  }

  componentWillReceiveProps(nextProps){//这个函数很重要
    this.setState({
      diaryListDataSource:this.state.diaryListDataSource.cloneWithRows(nextProps.diaryList)//注意这里的nextProps.diaryList
    });
  }

//列表组件
{/*这里使用一个三元表达式进行判断*/}
      {
        (
          (this.props.diaryList.length!==0)?
          (
            <ListView dataSource={this.state.diaryListDataSource} renderRow={this.renderListItem}>
            </ListView>
          ):(
            <View style={{flex:1,justifyContent:'center'}}>
            <Text style={{fontSize:18}}></Text>
            </View>
          )
        )
      }

注意:ListView.DataSource类型的变量必须放置在集成React框架的Component组件的组建中生成。

2.3 列表的高级处理

1、可以将列表的每一行通过可触摸组件包裹,保证良好的UI交互效果。
2、可以在每一列中定义多个可触摸组件。

2.4 列表分段

2.4.1 声明状态机变量

//在构造函数中
状态机变量名:new ListView.DataSource({
rowHasChanged:(oldRow,newRow)=>{oldRow!==newRow},
sectionHeaderHasChanged:(oldSH,newSH)=>oldSH!==newSH
})

2.4.2 将数据源复制到DataSource中

let newListWithSection=[];
let sec1="分区1";
let sec2="分区2";
newListWithSection[sec1]=this.list;
newListWithSection[sec2]=this.list;
let fakeSections=[sec1,sec2];

this.setState(()=>{
return {listDS:this.state.listDS.closeWithRowsAndSections(newListWithSection,fakeSections)};
});

2.4.3 定义分栏、首尾栏以及列表间隔渲染:

renderSectionHeader(sectionData,sectionID);
renderHeader();
renderFooter();
renderSeparator();

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

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,016评论 4 62
  • 目击众神死亡的草原上野花一片 远在远方的风比远方更远 我的琴声呜咽泪水全无 我把这远方的远归还草原 一个叫木...
    宜绍阅读 785评论 0 0
  • 初夏,西安城南一老街道边,热闹喧嚣的烧烤摊上,男主角和几位朋友正在喝酒撸串… “还能接着喝吗?”我说。 “一人再开...
    長安诛客阅读 278评论 0 1
  • 穿上白雪婚纱 ——便开始接近一个母亲的样子 接近一个家的和睦,或者破毁 一个人的狂喜,渴望以及疯狂 你试图温和的走...
    屋顶有故事的猫阅读 188评论 4 11