siteline/swiftui-introspect

어떤 프로젝트인가요?

핵심 기능

• 01다양한 SwiftUI 컨트롤의 기반 UIKit 또는 AppKit 뷰에 접근합니다.
• 02iOS, tvOS, visionOS 및 macOS 플랫폼을 지원합니다.
• 03각 인트로스펙션 대상에 OS 버전을 명시적으로 지정해야 합니다.
• 04향후 플랫폼 버전에 사용할 수 있는 범위 기반 버전 조건자를 제공합니다.
• 05지원되지 않는 요소를 위한 사용자 지정 인트로스펙션 대상 뷰 유형을 정의할 수 있습니다.

활용 사례

• SwiftUI List 또는 ScrollView의 바운스 동작이나 배경을 변경합니다.
• SwiftUI modifier만으로는 어려운 TextField 또는 SecureField의 외관을 사용자화합니다.
• NavigationStack 또는 NavigationView의 내비게이션 바를 꾸밉니다.
• iOS 앱에서 고급 제어를 위해 네이티브 UIKit 뷰의 참조를 유지합니다.

빠른 시작

1. 1

   Swift Package Manager 종속성에 SwiftUIIntrospect 패키지를 추가합니다

   .package(url: "https://github.com/siteline/swiftui-introspect", from: "27.0.0"),
2. 2

   타깃 종속성에 SwiftUIIntrospect 제품을 추가합니다

   .product(name: "SwiftUIIntrospect", package: "swiftui-introspect"),

사용 전 알아둘 점

• !기반이 되는 UIKit/AppKit 타입은 메이저 버전 간에 변경될 수 있으므로, 인트로스펙션을 사용하려면 각 OS 버전(예: .iOS(.v18))을 개별적으로 옵트인해야 합니다.
• !README에 나열된 뷰 타입만 지원되며, Text와 Image 같은 많은 SwiftUI 뷰는 인트로스펙션할 수 없습니다.

포함된 컬렉션

토픽

자주 묻는 질문

swiftui-introspect은(는) 무엇인가요?

SwiftUI 코드에서 SwiftUI 뷰의 기반이 되는 UIKit 또는 AppKit 뷰에 접근해 사용자화할 수 있는 Swift 라이브러리입니다. SwiftUI는 기반이 되는 UIKit 및 AppKit 구성 요소의 여러 속성을 노출하지 않습니다. SwiftUI Introspect는 SwiftUI 뷰 주위에 보이지 않는 마커 뷰를 추가한 다음, 두 마커 사이의 뷰 계층 구조를 검색해 UIScrollView나 NSTextField 같은 해당 UIKit 또는 AppKit 인스턴스를 찾습니다. 클로저에는 이 네이티브 뷰가 전달되므로 SwiftUI에서 제공하지 않는 속성을 변경할 수 있습니다.

swiftui-introspect은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

swiftui-introspect은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

swiftui-introspect은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. swiftui-introspect의 마지막 커밋은 2026년 10월 7일입니다.

swiftui-introspect은(는) 어디에 사용할 수 있나요?

SwiftUI List 또는 ScrollView의 바운스 동작이나 배경을 변경합니다. SwiftUI modifier만으로는 어려운 TextField 또는 SecureField의 외관을 사용자화합니다. NavigationStack 또는 NavigationView의 내비게이션 바를 꾸밉니다. iOS 앱에서 고급 제어를 위해 네이티브 UIKit 뷰의 참조를 유지합니다.

swiftui-introspect는 어떻게 설치하나요?

Swift Package Manager 종속성에 SwiftUIIntrospect 패키지를 추가합니다: .package(url: "https://github.com/siteline/swiftui-introspect", from: "27.0.0"), 타깃 종속성에 SwiftUIIntrospect 제품을 추가합니다: .product(name: "SwiftUIIntrospect", package: "swiftui-introspect"),

swiftui-introspect은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/siteline/swiftui-introspect