ScrollView

스크롤 상태 추적과 오프셋 감지가 가능한 커스텀 스크롤 뷰입니다.

@MainActor struct ScrollView

Overview

기본 SwiftUI 스크롤 뷰를 확장하여 스크롤 상태 추적, 오프셋 감지, 새로고침 등 추가 기능을 제공합니다.

@State private var scrollStatus = ScrollView.ScrollStatus()

ScrollView(scrollStatus: $scrollStatus, 
            onOffsetChanged: { offset in
              print("스크롤 오프셋: \(offset)")
            }) {
    VStack(spacing: 16) {
        ForEach(0..<20) { index in
            Text("항목 \(index)")
                .frame(maxWidth: .infinity)
                .padding()
                .background(Color.gray.opacity(0.1))
                .cornerRadius(8)
        }
    }
    .padding()
}
.axis(.vertical)
.hidesIndicators()
.onRefresh {
    // 새로고침 작업 수행
    try? await Task.sleep(nanoseconds: 2_000_000_000)
}

Topics

Structures

struct ScrollStatus

스크롤 뷰의 상태를 추적하는 구조체입니다.

Initializers

init(axis: Axis, scrollViewSize: CGSize, contentSize: CGSize, contentOffset: CGPoint)

스크롤 상태를 초기화합니다.

  • Parameters
    ParameterDescription
    axis스크롤 방향, 생략하면 기본값으로 .vertical 적용
    scrollViewSize스크롤 뷰 크기, 생략하면 기본값으로 .zero 적용
    contentSize콘텐츠 크기, 생략하면 기본값으로 .zero 적용
    contentOffset콘텐츠 오프셋, 생략하면 기본값으로 .zero 적용

Instance Properties

var axis: Axis

스크롤 방향

var contentOffset: CGPoint

콘텐츠 오프셋

var contentSize: CGSize

콘텐츠 크기

var scrollViewSize: CGSize

스크롤 뷰 크기

var scrolledToMax: Bool

스크롤이 최대 위치에 도달했는지 여부입니다.

Initializers

init(scrollStatus: Binding<ScrollStatus>?, onOffsetChanged: (CGPoint) -> Void, content: () -> any View)

스크롤 뷰를 초기화합니다.

  • Parameters
    ParameterDescription
    scrollStatus스크롤 상태를 추적하기 위한 바인딩, 생략하면 기본값으로 nil 적용
    onOffsetChanged스크롤 오프셋이 변경될 때 호출되는 클로저, 생략하면 기본값으로 빈 클로저 적용
    content스크롤 뷰에 표시할 콘텐츠를 반환하는 클로저

Instance Properties

var body: some View

뷰의 내용과 동작을 정의합니다.

Instance Methods

func axis(Axis) -> ScrollView

스크롤 방향을 설정합니다.

  • Parameters

    ParameterDescription
    axis스크롤 방향 (.vertical 또는 .horizontal)

  • Return Value

    수정된 스크롤 뷰

func hidesIndicators(Bool) -> ScrollView

스크롤 인디케이터 표시 여부를 설정합니다.

  • Parameters

    ParameterDescription
    hidesIndicators인디케이터를 숨길지 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 스크롤 뷰

func onRefresh(() async -> Void) -> ScrollView

당겨서 새로고침 동작을 설정합니다.

  • Parameters

    ParameterDescription
    perform새로고침 시 실행할 비동기 작업

  • Return Value

    수정된 스크롤 뷰

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.