Skip to main content
Version: Next

Scroll Edge Effect Options

Controls the iOS 26+ UIScrollEdgeEffect (Liquid Glass fade) shown at the edges of scroll views when content scrolls under bars.

Credits: Contributed by @manuhook (PR #8281).

const options = {
scrollEdgeEffect: {
hidden: true,
},
};

hidden#

Hide the scroll edge effect.

TypeRequiredPlatform
booleanNoiOS 26+

style#

Set the scroll edge effect style.

TypeRequiredPlatformDefault
enum('automatic', 'soft', 'hard')NoiOS 26+'automatic'

top / bottom / left / right#

Per-edge override. Values fall back to the global hidden / style. Per-edge values take precedence.

TypeRequiredPlatform
{ hidden?: boolean; style?: 'automatic' \| 'soft' \| 'hard' }NoiOS 26+

Examples#

Hide all edges:

MyScreen.options = {
scrollEdgeEffect: { hidden: true },
};

Top visible, bottom hidden:

MyScreen.options = {
scrollEdgeEffect: {
top: { hidden: false },
bottom: { hidden: true },
},
};

Dynamic update:

Navigation.mergeOptions(componentId, {
scrollEdgeEffect: { bottom: { hidden: true } },
});