onScrollVisibilityChange
Adds an action to be called when the view crosses the threshold to be considered on/off screen.
View ModifieriOS 18.0+macOS 15.0+tvOS 18.0+watchOS 11.0+visionOS 2.0+onScrollVisibilityChange(threshold:_:) in SwiftUI
Declaration
compose().onScrollVisibilityChange({
threshold?: number,
action: (arg0: boolean) => void,
})nonisolated func onScrollVisibilityChange(
threshold: Double = 0.5,
_ action: @escaping (Bool) -> Void
) -> some ViewParameters
options.thresholdnumberThe amount required to be visible within the viewport of the parent view before the
actionis fired. By default when the view has crossed more than 50% on-screen, the action will be called.options.action*(arg0: boolean) => voidThe action which will be called when the threshold has been reached.
Discussion
Use this modifier to be informed when the view has crossed the provided threshold to be considered on/off screen.
struct VideoPlayer: View {
@State private var playing = false
var body: some View {
Group {
// ...
}
.onScrollVisibilityChange(threshold: 0.2) { isVisible in
playing = isVisible
}
}
}When the view appears on-screen, the action will be called if the threshold has already been reached.
See also
More in Events and lifecycle.
- onAppearAdds an action to perform before this view appears.
- onChangeAdds a modifier for this view that fires an action when a specific value changes.
- onContinueUserActivityRegisters a handler to invoke in response to a user activity that your app receives.
- onContinuousHoverAdds an action to perform when the pointer enters, moves within, and exits the view's bounds.
- onDisappearAdds an action to perform after this view disappears.
- onDragActivates this view as the source of a drag and drop operation.
- onDragSessionUpdatedSpecifies an action to perform on each update of an ongoing dragging operation activated by draggable(:) or anther drag modifiers.
- onDropDefines the destination of a drag and drop operation that handles the dropped content with a closure that you specify.
- onDropSessionUpdatedSpecifies an action to perform on each update of an ongoing drop operation activated by dropDestination(:) or other drop modifiers.
- onGeometryChangeAdds an action to be performed when a value, created from a geometry proxy, changes.
- onHingeChangeAdds an action to perform when the hinge context of the view hierarchy changes.
- onHoverAdds an action to perform when the user moves the pointer over or away from the view's frame.