|
1 |
| -import React, { useRef, useState } from 'react'; |
| 1 | +import React, { MutableRefObject, useRef, useState } from 'react'; |
2 | 2 | import {
|
3 | 3 | ActivityIndicator,
|
| 4 | + FlatList as FlatListType, |
4 | 5 | FlatListProps,
|
5 | 6 | ScrollViewProps,
|
6 | 7 | StyleSheet,
|
@@ -66,176 +67,185 @@ type Props<T> = Omit<FlatListProps<T>, 'maintainVisibleContentPosition'> & {
|
66 | 67 | * - doesn't accept `ListHeaderComponent` via prop, since it is occupied by `HeaderLoadingIndicator`
|
67 | 68 | * Set `showDefaultLoadingIndicators` to use `ListHeaderComponent`.
|
68 | 69 | */
|
69 |
| -const BidirectionalFlatList = <T extends any>(props: Props<T>) => { |
70 |
| - const { |
71 |
| - activityIndicatorColor = 'black', |
72 |
| - data, |
73 |
| - enableAutoscrollToTop, |
74 |
| - autoscrollToTopThreshold = 100, |
75 |
| - FooterLoadingIndicator, |
76 |
| - HeaderLoadingIndicator, |
77 |
| - ListHeaderComponent, |
78 |
| - ListFooterComponent, |
79 |
| - onEndReached = () => Promise.resolve(), |
80 |
| - onEndReachedThreshold = 10, |
81 |
| - onScroll, |
82 |
| - onStartReached = () => Promise.resolve(), |
83 |
| - onStartReachedThreshold = 10, |
84 |
| - showDefaultLoadingIndicators = true, |
85 |
| - } = props; |
86 |
| - |
87 |
| - const [onStartReachedInProgress, setOnStartReachedInProgress] = useState( |
88 |
| - false |
89 |
| - ); |
90 |
| - const [onEndReachedInProgress, setOnEndReachedInProgress] = useState(false); |
91 |
| - |
92 |
| - const onStartReachedTracker = useRef<Record<number, boolean>>({}); |
93 |
| - const onEndReachedTracker = useRef<Record<number, boolean>>({}); |
94 |
| - |
95 |
| - const onStartReachedInPromise = useRef<Promise<void> | null>(null); |
96 |
| - const onEndReachedInPromise = useRef<Promise<void> | null>(null); |
97 |
| - |
98 |
| - const maybeCallOnStartReached = () => { |
99 |
| - // If onStartReached has already been called for given data length, then ignore. |
100 |
| - if (data?.length && onStartReachedTracker.current[data.length]) { |
101 |
| - return; |
102 |
| - } |
103 |
| - |
104 |
| - if (data?.length) { |
105 |
| - onStartReachedTracker.current[data.length] = true; |
106 |
| - } |
107 |
| - |
108 |
| - setOnStartReachedInProgress(true); |
109 |
| - const p = () => { |
110 |
| - return new Promise<void>((resolve) => { |
111 |
| - onStartReachedInPromise.current = null; |
112 |
| - setOnStartReachedInProgress(false); |
113 |
| - resolve(); |
114 |
| - }); |
115 |
| - }; |
| 70 | +const BidirectionalFlatList = React.forwardRef( |
| 71 | + ( |
| 72 | + // TODO: Fix typescript generics for ref forwarding. |
| 73 | + props: Props<any>, |
| 74 | + ref: |
| 75 | + | ((instance: FlatListType | null) => void) |
| 76 | + | MutableRefObject<FlatListType | null> |
| 77 | + | null |
| 78 | + ) => { |
| 79 | + const { |
| 80 | + activityIndicatorColor = 'black', |
| 81 | + data, |
| 82 | + enableAutoscrollToTop, |
| 83 | + autoscrollToTopThreshold = 100, |
| 84 | + FooterLoadingIndicator, |
| 85 | + HeaderLoadingIndicator, |
| 86 | + ListHeaderComponent, |
| 87 | + ListFooterComponent, |
| 88 | + onEndReached = () => Promise.resolve(), |
| 89 | + onEndReachedThreshold = 10, |
| 90 | + onScroll, |
| 91 | + onStartReached = () => Promise.resolve(), |
| 92 | + onStartReachedThreshold = 10, |
| 93 | + showDefaultLoadingIndicators = true, |
| 94 | + } = props; |
| 95 | + const [onStartReachedInProgress, setOnStartReachedInProgress] = useState( |
| 96 | + false |
| 97 | + ); |
| 98 | + const [onEndReachedInProgress, setOnEndReachedInProgress] = useState(false); |
| 99 | + |
| 100 | + const onStartReachedTracker = useRef<Record<number, boolean>>({}); |
| 101 | + const onEndReachedTracker = useRef<Record<number, boolean>>({}); |
116 | 102 |
|
117 |
| - if (onEndReachedInPromise.current) { |
118 |
| - onEndReachedInPromise.current.finally(() => { |
| 103 | + const onStartReachedInPromise = useRef<Promise<void> | null>(null); |
| 104 | + const onEndReachedInPromise = useRef<Promise<void> | null>(null); |
| 105 | + |
| 106 | + const maybeCallOnStartReached = () => { |
| 107 | + // If onStartReached has already been called for given data length, then ignore. |
| 108 | + if (data?.length && onStartReachedTracker.current[data.length]) { |
| 109 | + return; |
| 110 | + } |
| 111 | + |
| 112 | + if (data?.length) { |
| 113 | + onStartReachedTracker.current[data.length] = true; |
| 114 | + } |
| 115 | + |
| 116 | + setOnStartReachedInProgress(true); |
| 117 | + const p = () => { |
| 118 | + return new Promise<void>((resolve) => { |
| 119 | + onStartReachedInPromise.current = null; |
| 120 | + setOnStartReachedInProgress(false); |
| 121 | + resolve(); |
| 122 | + }); |
| 123 | + }; |
| 124 | + |
| 125 | + if (onEndReachedInPromise.current) { |
| 126 | + onEndReachedInPromise.current.finally(() => { |
| 127 | + onStartReachedInPromise.current = onStartReached().then(p); |
| 128 | + }); |
| 129 | + } else { |
119 | 130 | onStartReachedInPromise.current = onStartReached().then(p);
|
120 |
| - }); |
121 |
| - } else { |
122 |
| - onStartReachedInPromise.current = onStartReached().then(p); |
123 |
| - } |
124 |
| - }; |
125 |
| - |
126 |
| - const maybeCallOnEndReached = () => { |
127 |
| - // If onEndReached has already been called for given data length, then ignore. |
128 |
| - if (data?.length && onEndReachedTracker.current[data.length]) { |
129 |
| - return; |
130 |
| - } |
131 |
| - |
132 |
| - if (data?.length) { |
133 |
| - onEndReachedTracker.current[data.length] = true; |
134 |
| - } |
135 |
| - |
136 |
| - setOnEndReachedInProgress(true); |
137 |
| - const p = () => { |
138 |
| - return new Promise<void>((resolve) => { |
139 |
| - onStartReachedInPromise.current = null; |
140 |
| - setOnStartReachedInProgress(false); |
141 |
| - resolve(); |
142 |
| - }); |
| 131 | + } |
143 | 132 | };
|
144 | 133 |
|
145 |
| - if (onStartReachedInPromise.current) { |
146 |
| - onStartReachedInPromise.current.finally(() => { |
147 |
| - onEndReachedInPromise.current = onEndReached().then(p); |
148 |
| - }); |
149 |
| - } else { |
150 |
| - onEndReachedInPromise.current = onEndReached().then(p); |
151 |
| - } |
152 |
| - }; |
153 |
| - |
154 |
| - const handleScroll: ScrollViewProps['onScroll'] = (event) => { |
155 |
| - // Call the parent onScroll handler, if provided. |
156 |
| - onScroll?.(event); |
157 |
| - |
158 |
| - const offset = event.nativeEvent.contentOffset.y; |
159 |
| - const visibleLength = event.nativeEvent.layoutMeasurement.height; |
160 |
| - const contentLength = event.nativeEvent.contentSize.height; |
161 |
| - |
162 |
| - // Check if scroll has reached either start of end of list. |
163 |
| - const isScrollAtStart = offset < onStartReachedThreshold; |
164 |
| - const isScrollAtEnd = |
165 |
| - contentLength - visibleLength - offset < onEndReachedThreshold; |
166 |
| - |
167 |
| - if (isScrollAtStart) { |
168 |
| - maybeCallOnStartReached(); |
169 |
| - } |
170 |
| - |
171 |
| - if (isScrollAtEnd) { |
172 |
| - maybeCallOnEndReached(); |
173 |
| - } |
174 |
| - }; |
175 |
| - |
176 |
| - const renderHeaderLoadingIndicator = () => { |
177 |
| - if (!showDefaultLoadingIndicators) { |
178 |
| - if (ListHeaderComponent) { |
179 |
| - return <ListHeaderComponent />; |
| 134 | + const maybeCallOnEndReached = () => { |
| 135 | + // If onEndReached has already been called for given data length, then ignore. |
| 136 | + if (data?.length && onEndReachedTracker.current[data.length]) { |
| 137 | + return; |
| 138 | + } |
| 139 | + |
| 140 | + if (data?.length) { |
| 141 | + onEndReachedTracker.current[data.length] = true; |
| 142 | + } |
| 143 | + |
| 144 | + setOnEndReachedInProgress(true); |
| 145 | + const p = () => { |
| 146 | + return new Promise<void>((resolve) => { |
| 147 | + onStartReachedInPromise.current = null; |
| 148 | + setOnStartReachedInProgress(false); |
| 149 | + resolve(); |
| 150 | + }); |
| 151 | + }; |
| 152 | + |
| 153 | + if (onStartReachedInPromise.current) { |
| 154 | + onStartReachedInPromise.current.finally(() => { |
| 155 | + onEndReachedInPromise.current = onEndReached().then(p); |
| 156 | + }); |
180 | 157 | } else {
|
181 |
| - return null; |
| 158 | + onEndReachedInPromise.current = onEndReached().then(p); |
182 | 159 | }
|
183 |
| - } |
| 160 | + }; |
184 | 161 |
|
185 |
| - if (!onStartReachedInProgress) return null; |
| 162 | + const handleScroll: ScrollViewProps['onScroll'] = (event) => { |
| 163 | + // Call the parent onScroll handler, if provided. |
| 164 | + onScroll?.(event); |
186 | 165 |
|
187 |
| - if (HeaderLoadingIndicator) { |
188 |
| - return <HeaderLoadingIndicator />; |
189 |
| - } |
| 166 | + const offset = event.nativeEvent.contentOffset.y; |
| 167 | + const visibleLength = event.nativeEvent.layoutMeasurement.height; |
| 168 | + const contentLength = event.nativeEvent.contentSize.height; |
190 | 169 |
|
191 |
| - return ( |
192 |
| - <View style={styles.indicatorContainer}> |
193 |
| - <ActivityIndicator size={'small'} color={activityIndicatorColor} /> |
194 |
| - </View> |
195 |
| - ); |
196 |
| - }; |
| 170 | + // Check if scroll has reached either start of end of list. |
| 171 | + const isScrollAtStart = offset < onStartReachedThreshold; |
| 172 | + const isScrollAtEnd = |
| 173 | + contentLength - visibleLength - offset < onEndReachedThreshold; |
197 | 174 |
|
198 |
| - const renderFooterLoadingIndicator = () => { |
199 |
| - if (!showDefaultLoadingIndicators) { |
200 |
| - if (ListFooterComponent) { |
201 |
| - return <ListFooterComponent />; |
202 |
| - } else { |
203 |
| - return null; |
| 175 | + if (isScrollAtStart) { |
| 176 | + maybeCallOnStartReached(); |
| 177 | + } |
| 178 | + |
| 179 | + if (isScrollAtEnd) { |
| 180 | + maybeCallOnEndReached(); |
| 181 | + } |
| 182 | + }; |
| 183 | + |
| 184 | + const renderHeaderLoadingIndicator = () => { |
| 185 | + if (!showDefaultLoadingIndicators) { |
| 186 | + if (ListHeaderComponent) { |
| 187 | + return <ListHeaderComponent />; |
| 188 | + } else { |
| 189 | + return null; |
| 190 | + } |
| 191 | + } |
| 192 | + |
| 193 | + if (!onStartReachedInProgress) return null; |
| 194 | + |
| 195 | + if (HeaderLoadingIndicator) { |
| 196 | + return <HeaderLoadingIndicator />; |
204 | 197 | }
|
205 |
| - } |
206 | 198 |
|
207 |
| - if (!onEndReachedInProgress) return null; |
| 199 | + return ( |
| 200 | + <View style={styles.indicatorContainer}> |
| 201 | + <ActivityIndicator size={'small'} color={activityIndicatorColor} /> |
| 202 | + </View> |
| 203 | + ); |
| 204 | + }; |
208 | 205 |
|
209 |
| - if (FooterLoadingIndicator) { |
210 |
| - return <FooterLoadingIndicator />; |
211 |
| - } |
| 206 | + const renderFooterLoadingIndicator = () => { |
| 207 | + if (!showDefaultLoadingIndicators) { |
| 208 | + if (ListFooterComponent) { |
| 209 | + return <ListFooterComponent />; |
| 210 | + } else { |
| 211 | + return null; |
| 212 | + } |
| 213 | + } |
| 214 | + |
| 215 | + if (!onEndReachedInProgress) return null; |
| 216 | + |
| 217 | + if (FooterLoadingIndicator) { |
| 218 | + return <FooterLoadingIndicator />; |
| 219 | + } |
| 220 | + |
| 221 | + return ( |
| 222 | + <View style={styles.indicatorContainer}> |
| 223 | + <ActivityIndicator size={'small'} color={activityIndicatorColor} /> |
| 224 | + </View> |
| 225 | + ); |
| 226 | + }; |
212 | 227 |
|
213 | 228 | return (
|
214 |
| - <View style={styles.indicatorContainer}> |
215 |
| - <ActivityIndicator size={'small'} color={activityIndicatorColor} /> |
216 |
| - </View> |
| 229 | + <> |
| 230 | + <FlatList |
| 231 | + {...props} |
| 232 | + ref={ref} |
| 233 | + progressViewOffset={50} |
| 234 | + ListHeaderComponent={renderHeaderLoadingIndicator} |
| 235 | + ListFooterComponent={renderFooterLoadingIndicator} |
| 236 | + onEndReached={null} |
| 237 | + onScroll={handleScroll} |
| 238 | + // @ts-ignore |
| 239 | + maintainVisibleContentPosition={{ |
| 240 | + autoscrollToTopThreshold: enableAutoscrollToTop |
| 241 | + ? autoscrollToTopThreshold |
| 242 | + : undefined, |
| 243 | + minIndexForVisible: 1, |
| 244 | + }} |
| 245 | + /> |
| 246 | + </> |
217 | 247 | );
|
218 |
| - }; |
219 |
| - |
220 |
| - return ( |
221 |
| - <> |
222 |
| - <FlatList |
223 |
| - {...props} |
224 |
| - progressViewOffset={50} |
225 |
| - ListHeaderComponent={renderHeaderLoadingIndicator} |
226 |
| - ListFooterComponent={renderFooterLoadingIndicator} |
227 |
| - onEndReached={null} |
228 |
| - onScroll={handleScroll} |
229 |
| - // @ts-ignore |
230 |
| - maintainVisibleContentPosition={{ |
231 |
| - autoscrollToTopThreshold: enableAutoscrollToTop |
232 |
| - ? autoscrollToTopThreshold |
233 |
| - : undefined, |
234 |
| - minIndexForVisible: 1, |
235 |
| - }} |
236 |
| - /> |
237 |
| - </> |
238 |
| - ); |
239 |
| -}; |
| 248 | + } |
| 249 | +); |
240 | 250 |
|
241 | 251 | export { BidirectionalFlatList as FlatList };
|
0 commit comments