react / react/react-native

(Android 9) Flatlist header shows up underneath items if items have elevation: 1 or higher; can't be fixed with zindex.

Open
#49,179 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Component: FlatList Needs: Triage :mag: Platform: Android
Dominant language
C++
Stars
127k
Forks
25.3k
Avg merge
1d 23h
Merged PRs (30d)
4

Description

Description

Flatlist ListHeaderComponent together with stickyHeaderIndices={[0]} shows up under items when scrolling, if items have elevation 1 or higher. Seems to only show up on my older device (Android 9), I've tried to fix this with both zIndex and elevation on the header component (also with ListHeaderComponentStyle) but nothing changes.

Steps to reproduce
  1. open the provided snack with an older device (Android 9), I can't test Android 10 at the moment but when using Android 11 or higher the issue doesn't show up.
  2. scroll the FlatList
  3. observe header component
React Native Version

0.76.6

Affected Platforms

Runtime - Android

Output of npx react-native info
System:
  OS: Windows 10
  Memory: 4.22 GB / 15.9 GB
Binaries:
  Node:
    version: 20.11.0
    path: ~\node_modules\.bin\node.CMD
  Yarn: Not Found
  npm:
    version: 11.0.0
    path: ~\project\node_modules\.bin\npm.CMD
  Watchman: Not Found
SDKs:
  Android SDK:
    API Levels:
      - "33"
      - "35"
    Build Tools:
      - 33.0.1
      - 34.0.0
      - 35.0.0
    System Images: Not Found
    Android NDK: Not Found
  Windows SDK: Not Found
IDEs:
  Android Studio: AI-241.18034.62.2412.12266719
  Visual Studio:
    - 17.9.34728.123 (Visual Studio Community 2022)
Languages:
  Java: 17.0.13
  Ruby: Not Found
npmPackages:
  "@react-native-community/cli":
    installed: 15.1.3
    wanted: ^15.1.3
  react:
    installed: 18.3.1
    wanted: 18.3.1
  react-native:
    installed: 0.76.6
    wanted: 0.76.6
  react-native-windows: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: Not found
  newArchEnabled: Not found
iOS:
  hermesEnabled: Not found
  newArchEnabled: Not found
Stacktrace or Logs
no stacktrace.
Reproducer

https://snack.expo.dev/@0xirakli/lonely-blue-cake?platform=android

Screenshots and Videos

Image

Image

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the linked Snack on Android 9 with React Native 0.76.6, using FlatList, stickyHeaderIndices={[0]}, and elevated items; compare the behavior with Android 11 or higher. Trace the Android handling of the sticky header and item elevation, and consider the issue complete when the header remains above elevated items while scrolling on the affected Android versions.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, react-native
Domain
mobile-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.