PullToRefresh

enum PullToRefresh

Associated Extensions

extension View
func pullToRefresh(scrollYOffset: Binding<CGFloat>, refresh: () async -> Void) -> some View

스크롤 뷰에 풀-투-리프레시(Pull-to-Refresh) 기능을 추가합니다.

  • Parameters

    ParameterDescription
    scrollYOffset스크롤 뷰의 Y축 오프셋 바인딩. 당김 정도를 감지하는 데 사용됩니다.
    refresh리프레시가 트리거될 때 실행될 비동기 클로저입니다.
  • Return Value

    풀-투-리프레시 기능이, 추가된 뷰

  • Discussion

    사용자가 스크롤 뷰를 아래로 당기면 애니메이션과 함께 리프레시 기능을 제공합니다. iOS 18 이상에서 사용 가능하며, 로딩 애니메이션과 함께 당김 정도에 따른 시각적 피드백을 제공합니다.

    Note

    iOS 18 이상에서 사용 가능합니다.

    @State private var scrollStatus = ScrollView.ScrollStatus()
    
    ScrollView(scrollStatus: $scrollStatus) {
        content
    }
    .pullToRefresh(scrollYOffset: $scrollStatus.contentOffset.y) {
        await loadData()
    }
    

© 2026 Wanted Lab, Inc.