Remember to include separator length (height or width) in your offset calculation if you
specify ItemSeparatorComponent.
If true, renders items next to each other horizontally instead of stacked vertically.
How many items to render in the initial batch. This should be enough to fill the screen but not much more. Note these items will never be unmounted as part of the windowed rendering in order -to improve perceived performance of scroll-to-top actions.
Used to extract a unique key for a given item at the specified index. Key is used for caching +to improve perceived performance of scroll-to-top actions.
Instead of starting at the top with the first item, start at initialScrollIndex. This
+disables the "scroll to top" optimization that keeps the first initialNumToRender items
+always rendered and immediately renders the items starting at this initial index. Requires
+getItemLayout to be implemented.
Used to extract a unique key for a given item at the specified index. Key is used for caching
and as the react key to track item re-ordering. The default extractor checks item.key, then
falls back to using the index, like React does.
Multiple columns can only be rendered with horizontal={false} and will zig-zag like a
flexWrap layout. Items should all be the same height - masonry layouts are not supported.
Called once when the scroll position gets within onEndReachedThreshold of the rendered
diff --git a/releases/next/docs/sectionlist.html b/releases/next/docs/sectionlist.html
index ef8b2a70474..51da27c0b82 100644
--- a/releases/next/docs/sectionlist.html
+++ b/releases/next/docs/sectionlist.html
@@ -25,11 +25,14 @@ changes. This includes the data prop and parent component state.
key prop on each item and uses that for the React key.
-Alternatively, you can provide a custom keyExtractor prop.Rendered in between each item, but not at the top or bottom. By default, highlighted and
-leadingItem props are provided. renderItem provides separators.highlight/unhighlight
-which will update the highlighted prop, but you can also add custom props with
-separators.updateProps.
Rendered at the very end of the list.
Rendered at the very beginning of the list.
Rendered in between each section. Also receives highlighted, leadingItem, and any custom
-props from separators.updateProps.
A marker property for telling the list to re-render (since it implements PureComponent). If
+Alternatively, you can provide a custom keyExtractor prop.
Rendered in between each item, but not at the top or bottom. By default, highlighted,
+section, and [leading/trailing][Item/Separator] props are provided. renderItem provides
+separators.highlight/unhighlight which will update the highlighted prop, but you can also
+add custom props with separators.updateProps.
Rendered at the very end of the list.
Rendered at the very beginning of the list.
Rendered at the top and bottom of each section (note this is different from
+ItemSeparatorComponent which is only rendered between items). These are intended to separate
+sections from the headers above and below and typically have the same highlight response as
+ItemSeparatorComponent. Also receives highlighted, [leading/trailing][Item/Separator],
+and any custom props from separators.updateProps.
A marker property for telling the list to re-render (since it implements PureComponent). If
any of your renderItem, Header, Footer, etc. functions depend on anything outside of the
data prop, stick it here and treat it immutably.
How many items to render in the initial batch. This should be enough to fill the screen but not
much more. Note these items will never be unmounted as part of the windowed rendering in order
@@ -47,12 +50,13 @@ sure to also set the refreshing prop correctly.
Set this true while waiting for new data from a refresh.
Note: may have bugs (missing content) in some circumstances - use at your own risk.
This may improve scroll performance for large lists.
Default renderer for every item in every section. Can be over-ridden on a per-section basis.
Rendered at the top of each section. These stick to the top of the ScrollView by default on
+}) => ?React.Element<any> #
Default renderer for every item in every section. Can be over-ridden on a per-section basis.
Rendered at the bottom of each section.
Rendered at the top of each section. These stick to the top of the ScrollView by default on
iOS. See stickySectionHeadersEnabled.
The actual data to render, akin to the data prop in <FlatList>.
General shape:
renderItem, Header, Footer, etc. functions depend on an
data prop, stick it here and treat it immutably.A generic accessor for extracting an item from any sort of data blob.
Determines how many items are in the data blob.
How many items to render in the initial batch. This should be enough to fill the screen but not much more. Note these items will never be unmounted as part of the windowed rendering in order -to improve perceived performance of scroll-to-top actions.
The maximum number of items to render in each incremental render batch. The more rendered at +to improve perceived performance of scroll-to-top actions.
Instead of starting at the top with the first item, start at initialScrollIndex. This
+disables the "scroll to top" optimization that keeps the first initialNumToRender items
+always rendered and immediately renders the items starting at this initial index. Requires
+getItemLayout to be implemented.
The maximum number of items to render in each incremental render batch. The more rendered at once, the better the fill rate, but responsiveness my suffer because rendering content may interfere with responding to button taps or other interactions.
If provided, a standard RefreshControl will be added for "Pull to Refresh" functionality. Make
sure to also set the refreshing prop correctly.
Called when the viewability of rows changes, as defined by the
-viewabilityConfig prop.
Set this true while waiting for new data from a refresh.
Note: may have bugs (missing content) in some circumstances - use at your own risk.
This may improve scroll performance for large lists.
Render a custom scroll component, e.g. with a differently styled RefreshControl.
Amount of time between low-pri item render batches, e.g. for rendering items quite a ways off
+viewabilityConfig prop.
Set this true while waiting for new data from a refresh.
Note: may have bugs (missing content) in some circumstances - use at your own risk.
This may improve scroll performance for large lists.
Render a custom scroll component, e.g. with a differently styled RefreshControl.
Amount of time between low-pri item render batches, e.g. for rendering items quite a ways off
screen. Similar fill rate/responsiveness tradeoff as maxToRenderPerBatch.
Determines the maximum number of items rendered outside of the visible area, in units of
visible lengths. So if your list fills the screen, then windowSize={21} (the default) will
render the visible screen area plus up to 10 screens above and 10 below the viewport. Reducing