react-native/docs/Basics-Component-ScrollView.md
Joel Marcey 6668cd2129 Add ScrollView to Basics docs
Summary:
Add basic information about the generic `ScrollView` -- talk a bit about how it renders elements and a quick compare against something like a `ListView`. Provide a simple example.

Fixes #8261
Closes https://github.com/facebook/react-native/pull/8266

Differential Revision: D3465105

Pulled By: JoelMarcey

fbshipit-source-id: 3a2e1eac6e877669763fc6b8bb0fc78ebe870ab1
2016-06-21 13:28:30 -07:00

2.5 KiB

id title layout category permalink next
basics-component-scrollview ScrollView docs Basics docs/basics-component-scrollview.html basics-component-listview

Given the screen sizes of mobile devices, the ability to scroll through data is generally paramount for a proper usability experience.

The ScrollView is a generic scrolling container that can host multiple components and views. The scrollable items need not be homogenous, and you can scroll both vertically and horizontally (by setting the horizontal property).

ScrollView works best to present a list of short, static items of a known quantity. All the elements and views of a ScrollView are rendered a priori, even if they are not currently shown on the screen. Contrast this with a ListView, which render only those views that are on the screen and remove views that go off-screen.

TextView and ListView are specialized scrollable containers.

This contrived example creates a horizontal ScrollView with a static amount of heterogenous elements (images and text).

import React, { AppRegistry, ScrollView, Image, Text, View } from 'react-native'

var SimpleScrollView = React.createClass({
  render(){
      return(
        <ScrollView horizontal={true}>
          <View>
            <Image source={require('./img/check.png')} />
          </View>
          <View>
            <Image source={require('./img/check.png')} />
          </View>
          <View>
            <Image source={require('./img/check.png')} />
          </View>
          <View>
            <Text style={{fontSize:96}}>Text1</Text>
          </View>
          <View>
            <Text style={{fontSize:96}}>Text2</Text>
          </View>
          <View>
            <Text style={{fontSize:96}}>Text3</Text>
          </View>
          <View>
            <Text style={{fontSize:96}}>Text4</Text>
          </View>
          <View>
            <Image source={require('./img/check.png')} />
          </View>
          <View>
            <Image source={require('./img/check.png')} />
          </View>
          <View>
            <Image source={require('./img/check.png')} />
          </View>
          <View>
            <Text style={{fontSize:96}}>Text5</Text>
          </View>
          <View>
            <Text style={{fontSize:96}}>Text6</Text>
          </View>
        </ScrollView>
    );
  }
});


AppRegistry.registerComponent('MyApp', () => SimpleScrollView);