Files
react-native/docs/0.37/using-a-listview.html
T
Website Deployment Script d6c8c31cb1 Deploy website
Deploy website version based on aa6bca5d8b7a59a46c8e4e5a6803f43206c13b65
2020-09-16 06:40:19 +00:00

206 lines
37 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Using List Views · React Native</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="React Native provides a suite of components for presenting lists of data. Generally, you&#x27;ll want to use either [FlatList](/docs/0.37/flatlist) or [SectionList](/docs/0.37/sectionlist)."/><meta name="docsearch:version" content="0.37"/><meta name="docsearch:language" content="en"/><meta property="og:title" content="Using List Views · React Native"/><meta property="og:type" content="website"/><meta property="og:url" content="https://reactnative.dev/"/><meta property="og:description" content="React Native provides a suite of components for presenting lists of data. Generally, you&#x27;ll want to use either [FlatList](/docs/0.37/flatlist) or [SectionList](/docs/0.37/sectionlist)."/><meta property="og:image" content="https://reactnative.dev/img/logo-og.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://reactnative.dev/img/logo-og.png"/><link rel="shortcut icon" href="/img/favicon.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/solarized-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://reactnative.dev/blog/atom.xml" title="React Native Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://reactnative.dev/blog/feed.xml" title="React Native Blog RSS Feed"/><script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-41298772-2', 'auto');
ga('send', 'pageview');
</script><script type="text/javascript" src="https://cdn.jsdelivr.net/npm/focus-visible@5.0.2/dist/focus-visible.min.js"></script><script type="text/javascript" src="https://snack.expo.io/embed.js"></script><script type="text/javascript" src="https://platform.twitter.com/widgets.js"></script><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><script type="text/javascript" src="/js/codeblocks.js"></script><script type="text/javascript" src="/js/tabs.js"></script><script type="text/javascript" src="/js/docs-rating.js"></script><script src="https://unpkg.com/vanilla-back-to-top@7.1.14/dist/vanilla-back-to-top.min.js"></script><script>
document.addEventListener('DOMContentLoaded', function() {
addBackToTop(
{"zIndex":100}
)
});
</script><script src="/js/scrollSpy.js"></script><link rel="stylesheet" href="/css/prism.css"/><link rel="stylesheet" href="/css/main.css"/><script src="/js/codetabs.js"></script></head><body class="sideNavVisible separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/"><img class="logo" src="/img/header_logo.svg" alt="React Native"/><h2 class="headerTitleWithLogo">React Native</h2></a><a href="/versions"><h3>0.37</h3></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class="siteNavGroupActive"><a href="/docs/0.37/getting-started" target="_self">Docs</a></li><li class="siteNavGroupActive"><a href="/docs/0.37/components-and-apis" target="_self">Components</a></li><li class=""><a href="/docs/0.37/accessibilityinfo" target="_self">API</a></li><li class=""><a href="/help" target="_self">Community</a></li><li class=""><a href="/blog/" target="_self">Blog</a></li><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li><li class=""><a href="https://github.com/facebook/react-native" target="_self">GitHub</a></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="docsNavContainer" id="docsNav"><nav class="toc"><div class="toggleNav"><section class="navWrapper wrapper"><div class="navBreadcrumb wrapper"><div class="navToggle" id="navToggler"><div class="hamburger-menu"><div class="line1"></div><div class="line2"></div><div class="line3"></div></div></div><h2><i></i><span>The Basics</span></h2><div class="tocToggler" id="tocToggler"><i class="icon-toc"></i></div></div><div class="navGroups"><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">The Basics<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.37/getting-started">Getting Started</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/tutorial">Learn the Basics</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/props">Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/state">State</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/style">Style</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/height-and-width">Height and Width</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/flexbox">Layout with Flexbox</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/handling-text-input">Handling Text Input</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/handling-touches">Handling Touches</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/using-a-scrollview">Using a ScrollView</a></li><li class="navListItem navListItemActive"><a class="navItem" href="/docs/0.37/using-a-listview">Using List Views</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/network">Networking</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/more-resources">More Resources</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Guides<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.37/components-and-apis">Components and APIs</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/platform-specific-code">Platform Specific Code</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/navigation">Navigating Between Screens</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/images">Images</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/animations">Animations</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/accessibility">Accessibility</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/improvingux">Improving User Experience</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/timers">Timers</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/debugging">Debugging</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/performance">Performance</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/gesture-responder-system">Gesture Responder System</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/javascript-environment">JavaScript Environment</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/direct-manipulation">Direct Manipulation</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/colors">Color Reference</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/integration-with-existing-apps">Integration with Existing Apps</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/running-on-device">Running On Device</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/upgrading">Upgrading to new React Native versions</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/troubleshooting">Troubleshooting</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/native-modules-setup">Native Modules Setup</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Guides (iOS)<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.37/native-modules-ios">Native Modules</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/native-components-ios">Native UI Components</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/linking-libraries-ios">Linking Libraries</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/running-on-simulator-ios">Running On Simulator</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/communication-ios">Communication between native and React Native</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/building-for-tv">Building For TV Devices</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/app-extensions">App Extensions</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Guides (Android)<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.37/native-modules-android">Native Modules</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/native-components-android">Native UI Components</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/headless-js-android">Headless JS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/signed-apk-android">Publishing to Google Play Store</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/removing-default-permissions">Removing Default Permissions</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Components<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.37/activityindicator">ActivityIndicator</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/button">Button</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/datepickerios">DatePickerIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/drawerlayoutandroid">DrawerLayoutAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/image">Image</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/keyboardavoidingview">KeyboardAvoidingView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/modal">Modal</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/navigator">Navigator</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/navigatorios">NavigatorIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/picker">Picker</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/pickerios">PickerIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/progressbarandroid">ProgressBarAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/progressviewios">ProgressViewIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/refreshcontrol">RefreshControl</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/scrollview">ScrollView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/segmentedcontrolios">SegmentedControlIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/slider">Slider</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/snapshotviewios">SnapshotViewIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/statusbar">StatusBar</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/switch">Switch</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/tabbarios">TabBarIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/tabbarios-item">TabBarIOS.Item</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/text">Text</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/textinput">TextInput</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/toolbarandroid">ToolbarAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/touchablehighlight">TouchableHighlight</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/touchablenativefeedback">TouchableNativeFeedback</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/touchableopacity">TouchableOpacity</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/touchablewithoutfeedback">TouchableWithoutFeedback</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/viewpagerandroid">ViewPagerAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/webview">WebView</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">APIs<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.37/actionsheetios">ActionSheetIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/alert">Alert</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/alertios">AlertIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/animated">Animated</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/appregistry">AppRegistry</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/appstate">AppState</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/asyncstorage">AsyncStorage</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/cameraroll">CameraRoll</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/clipboard">Clipboard</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/datepickerandroid">DatePickerAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/dimensions">Dimensions</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/easing">Easing</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/geolocation">Geolocation</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/imageeditor">ImageEditor</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/imagepickerios">ImagePickerIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/imagestore">ImageStore</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/image-style-props">Image Style Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/interactionmanager">InteractionManager</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/keyboard">Keyboard</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/layout-props">Layout Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/layoutanimation">LayoutAnimation</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/linking">Linking</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/netinfo">NetInfo</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/panresponder">PanResponder</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/permissionsandroid">PermissionsAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/pixelratio">PixelRatio</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/pushnotificationios">PushNotificationIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/settings">Settings</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/shadow-props">Shadow Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/share">Share</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/statusbarios">StatusBarIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/stylesheet">StyleSheet</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/systrace">Systrace</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/text-style-props">Text Style Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/timepickerandroid">TimePickerAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/toastandroid">ToastAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/transforms">Transforms</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/vibration">Vibration</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/vibrationios">VibrationIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.37/view-style-props">View Style Props</a></li></ul></div></div></section></div><script>
var coll = document.getElementsByClassName('collapsible');
var checkActiveCategory = true;
for (var i = 0; i < coll.length; i++) {
var links = coll[i].nextElementSibling.getElementsByTagName('*');
if (checkActiveCategory){
for (var j = 0; j < links.length; j++) {
if (links[j].classList.contains('navListItemActive')){
coll[i].nextElementSibling.classList.toggle('hide');
coll[i].childNodes[1].classList.toggle('rotate');
checkActiveCategory = false;
break;
}
}
}
coll[i].addEventListener('click', function() {
var arrow = this.childNodes[1];
arrow.classList.toggle('rotate');
var content = this.nextElementSibling;
content.classList.toggle('hide');
});
}
document.addEventListener('DOMContentLoaded', function() {
createToggler('#navToggler', '#docsNav', 'docsSliderActive');
createToggler('#tocToggler', 'body', 'tocActive');
var headings = document.querySelector('.toc-headings');
headings && headings.addEventListener('click', function(event) {
var el = event.target;
while(el !== headings){
if (el.tagName === 'A') {
document.body.classList.remove('tocActive');
break;
} else{
el = el.parentNode;
}
}
}, false);
function createToggler(togglerSelector, targetSelector, className) {
var toggler = document.querySelector(togglerSelector);
var target = document.querySelector(targetSelector);
if (!toggler) {
return;
}
toggler.onclick = function(event) {
event.preventDefault();
target.classList.toggle(className);
};
}
});
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://github.com/facebook/react-native-website/blob/master/docs/using-a-listview.md" target="_blank" rel="noreferrer noopener">Edit</a><h1 id="__docusaurus" class="postHeaderTitle">Using List Views</h1></header><article><div><span><p>React Native provides a suite of components for presenting lists of data. Generally, you'll want to use either <a href="/docs/0.37/flatlist">FlatList</a> or <a href="/docs/0.37/sectionlist">SectionList</a>.</p>
<p>The <code>FlatList</code> component displays a scrolling list of changing, but similarly structured, data. <code>FlatList</code> works well for long lists of data, where the number of items might change over time. Unlike the more generic <a href="/docs/0.37/using-a-scrollview"><code>ScrollView</code></a>, the <code>FlatList</code> only renders elements that are currently showing on the screen, not all the elements at once.</p>
<p>The <code>FlatList</code> component requires two props: <code>data</code> and <code>renderItem</code>. <code>data</code> is the source of information for the list. <code>renderItem</code> takes one item from the source and returns a formatted component to render.</p>
<p>This example creates a basic <code>FlatList</code> of hardcoded data. Each item in the <code>data</code> props is rendered as a <code>Text</code> component. The <code>FlatListBasics</code> component then renders the <code>FlatList</code> and all <code>Text</code> components.</p>
<div class="snack-player"><div class="mobile-friendly-snack" style="display: none"><pre><code class="hljs css javascript"><span class="hljs-keyword">import</span> React, { Component } <span class="hljs-keyword">from</span> <span class="hljs-string">&#x27;react&#x27;</span>;
<span class="hljs-keyword">import</span> { FlatList, StyleSheet, Text, View } <span class="hljs-keyword">from</span> <span class="hljs-string">&#x27;react-native&#x27;</span>;
<span class="hljs-keyword">export</span> <span class="hljs-keyword">default</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">FlatListBasics</span> <span class="hljs-keyword">extends</span> <span class="hljs-title">Component</span> </span>{
render() {
<span class="hljs-keyword">return</span> (
<span class="xml"><span class="hljs-tag">&lt;<span class="hljs-name">View</span> <span class="hljs-attr">style</span>=<span class="hljs-string">{styles.container}</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">FlatList</span>
<span class="hljs-attr">data</span>=<span class="hljs-string">{[</span>
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Devin</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Dan</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Dominic</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Jackson</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">James</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Joel</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">John</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Jillian</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Jimmy</span>&#x27;},
{<span class="hljs-attr">key:</span> &#x27;<span class="hljs-attr">Julie</span>&#x27;},
]}
<span class="hljs-attr">renderItem</span>=<span class="hljs-string">{({item})</span> =&gt;</span> <span class="hljs-tag">&lt;<span class="hljs-name">Text</span> <span class="hljs-attr">style</span>=<span class="hljs-string">{styles.item}</span>&gt;</span>{item.key}<span class="hljs-tag">&lt;/<span class="hljs-name">Text</span>&gt;</span>}
/&gt;
<span class="hljs-tag">&lt;/<span class="hljs-name">View</span>&gt;</span></span>
);
}
}
<span class="hljs-keyword">const</span> styles = StyleSheet.create({
<span class="hljs-attr">container</span>: {
<span class="hljs-attr">flex</span>: <span class="hljs-number">1</span>,
<span class="hljs-attr">paddingTop</span>: <span class="hljs-number">22</span>
},
<span class="hljs-attr">item</span>: {
<span class="hljs-attr">padding</span>: <span class="hljs-number">10</span>,
<span class="hljs-attr">fontSize</span>: <span class="hljs-number">18</span>,
<span class="hljs-attr">height</span>: <span class="hljs-number">44</span>,
},
})
</code></pre></div><div class="desktop-friendly-snack" style="margin-top: 15px; margin-bottom: 15px"><div
data-snack-name="FlatList Basics"
data-snack-description="Example usage"
data-snack-code="import%20React%2C%20%7B%20Component%20%7D%20from%20'react'%3B%0Aimport%20%7B%20FlatList%2C%20StyleSheet%2C%20Text%2C%20View%20%7D%20from%20'react-native'%3B%0A%0Aexport%20default%20class%20FlatListBasics%20extends%20Component%20%7B%0A%20%20render()%20%7B%0A%20%20%20%20return%20(%0A%20%20%20%20%20%20%3CView%20style%3D%7Bstyles.container%7D%3E%0A%20%20%20%20%20%20%20%20%3CFlatList%0A%20%20%20%20%20%20%20%20%20%20data%3D%7B%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Devin'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Dan'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Dominic'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Jackson'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'James'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Joel'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'John'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Jillian'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Jimmy'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Bkey%3A%20'Julie'%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%5D%7D%0A%20%20%20%20%20%20%20%20%20%20renderItem%3D%7B(%7Bitem%7D)%20%3D%3E%20%3CText%20style%3D%7Bstyles.item%7D%3E%7Bitem.key%7D%3C%2FText%3E%7D%0A%20%20%20%20%20%20%20%20%2F%3E%0A%20%20%20%20%20%20%3C%2FView%3E%0A%20%20%20%20)%3B%0A%20%20%7D%0A%7D%0A%0Aconst%20styles%20%3D%20StyleSheet.create(%7B%0A%20%20container%3A%20%7B%0A%20%20%20flex%3A%201%2C%0A%20%20%20paddingTop%3A%2022%0A%20%20%7D%2C%0A%20%20item%3A%20%7B%0A%20%20%20%20padding%3A%2010%2C%0A%20%20%20%20fontSize%3A%2018%2C%0A%20%20%20%20height%3A%2044%2C%0A%20%20%7D%2C%0A%7D)%0A"
data-snack-platform="web"
data-snack-supported-platforms=ios,android,web
data-snack-preview="true"
style="
overflow: hidden;
background: #fafafa;
border: 1px solid rgba(0,0,0,.16);
border-radius: 4px;
height: 514px;
width: 100%;
"
></div></div></div><p>If you want to render a set of data broken into logical sections, maybe with section headers, similar to <code>UITableView</code>s on iOS, then a <a href="/docs/0.37/sectionlist">SectionList</a> is the way to go.</p>
<div class="snack-player"><div class="mobile-friendly-snack" style="display: none"><pre><code class="hljs css javascript"><span class="hljs-keyword">import</span> React, { Component } <span class="hljs-keyword">from</span> <span class="hljs-string">&#x27;react&#x27;</span>;
<span class="hljs-keyword">import</span> { SectionList, StyleSheet, Text, View } <span class="hljs-keyword">from</span> <span class="hljs-string">&#x27;react-native&#x27;</span>;
<span class="hljs-keyword">export</span> <span class="hljs-keyword">default</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">SectionListBasics</span> <span class="hljs-keyword">extends</span> <span class="hljs-title">Component</span> </span>{
render() {
<span class="hljs-keyword">return</span> (
<span class="xml"><span class="hljs-tag">&lt;<span class="hljs-name">View</span> <span class="hljs-attr">style</span>=<span class="hljs-string">{styles.container}</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">SectionList</span>
<span class="hljs-attr">sections</span>=<span class="hljs-string">{[</span>
{<span class="hljs-attr">title:</span> &#x27;<span class="hljs-attr">D</span>&#x27;, <span class="hljs-attr">data:</span> [&#x27;<span class="hljs-attr">Devin</span>&#x27;, &#x27;<span class="hljs-attr">Dan</span>&#x27;, &#x27;<span class="hljs-attr">Dominic</span>&#x27;]},
{<span class="hljs-attr">title:</span> &#x27;<span class="hljs-attr">J</span>&#x27;, <span class="hljs-attr">data:</span> [&#x27;<span class="hljs-attr">Jackson</span>&#x27;, &#x27;<span class="hljs-attr">James</span>&#x27;, &#x27;<span class="hljs-attr">Jillian</span>&#x27;, &#x27;<span class="hljs-attr">Jimmy</span>&#x27;, &#x27;<span class="hljs-attr">Joel</span>&#x27;, &#x27;<span class="hljs-attr">John</span>&#x27;, &#x27;<span class="hljs-attr">Julie</span>&#x27;]},
]}
<span class="hljs-attr">renderItem</span>=<span class="hljs-string">{({item})</span> =&gt;</span> <span class="hljs-tag">&lt;<span class="hljs-name">Text</span> <span class="hljs-attr">style</span>=<span class="hljs-string">{styles.item}</span>&gt;</span>{item}<span class="hljs-tag">&lt;/<span class="hljs-name">Text</span>&gt;</span>}
renderSectionHeader={({section}) =&gt; <span class="hljs-tag">&lt;<span class="hljs-name">Text</span> <span class="hljs-attr">style</span>=<span class="hljs-string">{styles.sectionHeader}</span>&gt;</span>{section.title}<span class="hljs-tag">&lt;/<span class="hljs-name">Text</span>&gt;</span>}
keyExtractor={(item, index) =&gt; index}
/&gt;
<span class="hljs-tag">&lt;/<span class="hljs-name">View</span>&gt;</span></span>
);
}
}
<span class="hljs-keyword">const</span> styles = StyleSheet.create({
<span class="hljs-attr">container</span>: {
<span class="hljs-attr">flex</span>: <span class="hljs-number">1</span>,
<span class="hljs-attr">paddingTop</span>: <span class="hljs-number">22</span>
},
<span class="hljs-attr">sectionHeader</span>: {
<span class="hljs-attr">paddingTop</span>: <span class="hljs-number">2</span>,
<span class="hljs-attr">paddingLeft</span>: <span class="hljs-number">10</span>,
<span class="hljs-attr">paddingRight</span>: <span class="hljs-number">10</span>,
<span class="hljs-attr">paddingBottom</span>: <span class="hljs-number">2</span>,
<span class="hljs-attr">fontSize</span>: <span class="hljs-number">14</span>,
<span class="hljs-attr">fontWeight</span>: <span class="hljs-string">&#x27;bold&#x27;</span>,
<span class="hljs-attr">backgroundColor</span>: <span class="hljs-string">&#x27;rgba(247,247,247,1.0)&#x27;</span>,
},
<span class="hljs-attr">item</span>: {
<span class="hljs-attr">padding</span>: <span class="hljs-number">10</span>,
<span class="hljs-attr">fontSize</span>: <span class="hljs-number">18</span>,
<span class="hljs-attr">height</span>: <span class="hljs-number">44</span>,
},
})
</code></pre></div><div class="desktop-friendly-snack" style="margin-top: 15px; margin-bottom: 15px"><div
data-snack-name="SectionList Basics"
data-snack-description="Example usage"
data-snack-code="import%20React%2C%20%7B%20Component%20%7D%20from%20'react'%3B%0Aimport%20%7B%20SectionList%2C%20StyleSheet%2C%20Text%2C%20View%20%7D%20from%20'react-native'%3B%0A%0Aexport%20default%20class%20SectionListBasics%20extends%20Component%20%7B%0A%20%20render()%20%7B%0A%20%20%20%20return%20(%0A%20%20%20%20%20%20%3CView%20style%3D%7Bstyles.container%7D%3E%0A%20%20%20%20%20%20%20%20%3CSectionList%0A%20%20%20%20%20%20%20%20%20%20sections%3D%7B%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Btitle%3A%20'D'%2C%20data%3A%20%5B'Devin'%2C%20'Dan'%2C%20'Dominic'%5D%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7Btitle%3A%20'J'%2C%20data%3A%20%5B'Jackson'%2C%20'James'%2C%20'Jillian'%2C%20'Jimmy'%2C%20'Joel'%2C%20'John'%2C%20'Julie'%5D%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%5D%7D%0A%20%20%20%20%20%20%20%20%20%20renderItem%3D%7B(%7Bitem%7D)%20%3D%3E%20%3CText%20style%3D%7Bstyles.item%7D%3E%7Bitem%7D%3C%2FText%3E%7D%0A%20%20%20%20%20%20%20%20%20%20renderSectionHeader%3D%7B(%7Bsection%7D)%20%3D%3E%20%3CText%20style%3D%7Bstyles.sectionHeader%7D%3E%7Bsection.title%7D%3C%2FText%3E%7D%0A%20%20%20%20%20%20%20%20%20%20keyExtractor%3D%7B(item%2C%20index)%20%3D%3E%20index%7D%0A%20%20%20%20%20%20%20%20%2F%3E%0A%20%20%20%20%20%20%3C%2FView%3E%0A%20%20%20%20)%3B%0A%20%20%7D%0A%7D%0A%0Aconst%20styles%20%3D%20StyleSheet.create(%7B%0A%20%20container%3A%20%7B%0A%20%20%20flex%3A%201%2C%0A%20%20%20paddingTop%3A%2022%0A%20%20%7D%2C%0A%20%20sectionHeader%3A%20%7B%0A%20%20%20%20paddingTop%3A%202%2C%0A%20%20%20%20paddingLeft%3A%2010%2C%0A%20%20%20%20paddingRight%3A%2010%2C%0A%20%20%20%20paddingBottom%3A%202%2C%0A%20%20%20%20fontSize%3A%2014%2C%0A%20%20%20%20fontWeight%3A%20'bold'%2C%0A%20%20%20%20backgroundColor%3A%20'rgba(247%2C247%2C247%2C1.0)'%2C%0A%20%20%7D%2C%0A%20%20item%3A%20%7B%0A%20%20%20%20padding%3A%2010%2C%0A%20%20%20%20fontSize%3A%2018%2C%0A%20%20%20%20height%3A%2044%2C%0A%20%20%7D%2C%0A%7D)%0A"
data-snack-platform="web"
data-snack-supported-platforms=ios,android,web
data-snack-preview="true"
style="
overflow: hidden;
background: #fafafa;
border: 1px solid rgba(0,0,0,.16);
border-radius: 4px;
height: 514px;
width: 100%;
"
></div></div></div><p>One of the most common uses for a list view is displaying data that you fetch from a server. To do that, you will need to <a href="/docs/0.37/network">learn about networking in React Native</a>.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/0.37/using-a-scrollview"><span class="arrow-prev"></span><span class="function-name-prevnext">Using a ScrollView</span></a><a class="docs-next button" href="/docs/0.37/network"><span>Networking</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><div><h5>Docs</h5><a href="/docs/getting-started">Getting Started</a><a href="/docs/tutorial">Tutorial</a><a href="/docs/components-and-apis">Components and APIs</a><a href="/docs/more-resources">More Resources</a></div><div><h5>Community</h5><a href="/help">The React Native Community</a><a href="/showcase">Who&#x27;s using React Native?</a><a href="https://stackoverflow.com/questions/tagged/react-native" target="_blank">Ask Questions on Stack Overflow</a><a href="https://github.com/facebook/react-native/blob/master/CONTRIBUTING.md">Contributor Guide</a><a href="https://dev.to/t/reactnative" target="_blank">DEV Community</a></div><div><h5>More Resources</h5><a href="/blog">Blog</a><a href="https://twitter.com/reactnative" target="_blank">Twitter</a><a href="https://github.com/facebook/react-native" target="_blank">GitHub</a><a href="https://reactjs.org" target="_blank">React</a></div></section><a href="https://code.facebook.com/projects/" target="_blank" class="fbOpenSource"><img src="/img/oss_logo.png" alt="Facebook Open Source" width="170" height="45"/></a><section class="copyright">Copyright © 2020 Facebook Inc.</section></footer></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script><script>window.fbAsyncInit = function() {FB.init({appId:'1677033832619985',xfbml:true,version:'v2.7'});};(function(d, s, id){var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) {return;}js = d.createElement(s); js.id = id;js.src = '//connect.facebook.net/en_US/sdk.js';fjs.parentNode.insertBefore(js, fjs);}(document, 'script','facebook-jssdk'));
</script><script>window.twttr=(function(d,s, id){var js,fjs=d.getElementsByTagName(s)[0],t=window.twttr||{};if(d.getElementById(id))return t;js=d.createElement(s);js.id=id;js.src='https://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js, fjs);t._e = [];t.ready = function(f) {t._e.push(f);};return t;}(document, 'script', 'twitter-wjs'));</script><script>
document.addEventListener('keyup', function(e) {
if (e.target !== document.body) {
return;
}
// keyCode for '/' (slash)
if (e.keyCode === 191) {
const search = document.getElementById('search_input_react');
search && search.focus();
}
});
</script><script>
var search = docsearch({
apiKey: '2c98749b4a1e588efec53b2acec13025',
indexName: 'react-native-versions',
inputSelector: '#search_input_react',
algoliaOptions: {"facetFilters":["tags:0.37"],"hitsPerPage":5}
});
</script></body></html>