Scroll View에 관하여

스크롤뷰란?

스크롤 할 수 있는 뷰인 스크롤뷰에 대해 알아봅니다.

 

학습 목표

1. 스크롤뷰가 무엇인지 알아봅니다.

2. 스크롤뷰의 주요 메서드와 프로퍼티에 대해 알아봅니다.

학습하기

스크롤뷰란?

스크롤뷰는 스크롤뷰 안에 포함된 뷰를 상,하,좌,우로 스크롤 할 수 있고 확대 및 축소할 수 있는 뷰입니다. 그리고 스크롤뷰를 상속받아 활용되는 뷰로는 UITableView, UICollectionView, UITextView등 여러 UIKit 클래스가 있습니다.

 

스크롤뷰 상호작용

주요 프로퍼티

• delegate : 스크롤뷰 객체의 델리게이트weak var delegate: UIScrollViewDelegate? { get set }​UIScrollViewDelegate 프로토콜에 의해 선언된 메소드 델리게이트가 UIScrollView 클래스의 메시지에 응답

콘텐츠 크기 및 오프셋 관리

주요 프로퍼티

• contentSize : 콘텐츠뷰의 크기 var contentSize: CGSize { get set }

• contentOffset : 콘텐츠뷰의 원점이 스크롤뷰의 원점에서 오프셋 된 지점

  var contentOffset: CGPoint { get set }

주요 메서드

• setContentOffset(_:animated:) : 스크롤뷰의 원점에 대한 콘텐츠뷰의 오프셋 설정.func setContentOffset(_ contentOffset: CGPoint, animated: Bool)

콘텐츠 삽입 동작 관리

주요 프로퍼티

• contentInset : 콘텐츠뷰와 안전 영역 또는 스크롤뷰 가장자리에 간격 var contentInset: UIEdgeInsets { get set }​

스크롤뷰 구성

주요 프로퍼티

• isScrollEnabled : 스크롤링이 사용 가능한지 아닌지를 결정하는 부울 값var isScrollEnabled: Bool { get set }​
• isDirectionalLockEnabled : 스크롤이 특정 방향으로 고정할지를 결정하는 부울 값 var isDirectionalLockEnabled: Bool { get set }

• isPagingEnabled : 스크롤뷰에서 페이징을 사용할 수 있는 여부를 결정하는 부울 값

  var isPagingEnabled: Bool { get set }
• scrollsToTop :  스크롤 할 수 있는 제스처를 사용할지를 결정하는 부울 값 var scrollsToTop: Bool { get set }

• bounces : 스크롤뷰가 가장자리를 통과해서 다시 튀어나오는지 제어하는 부울 값

  var bounces: Bool { get set }

• alwaysBounceVertical : 세로 스크롤이 콘텐츠뷰의 끝에 도달할 때 튀어 오르기가 항상 발생하는지를 결정하는 부울 값

  var alwaysBounceVertical: Bool { get set }

• alwaysBounceHorizontal : 가로 스크롤이 콘텐츠뷰의 끝에 도달할 때 튀어 오르기가 항상 발생하는지를 결정하는 부울 값

  var alwaysBounceHorizontal: Bool { get set }

스크롤링 상태 가져오기

주요 프로퍼티

• isTracking : 사용자가 스크롤을 시작하기 위해 콘텐츠를 터치한 여부를 반환

  var isTracking: Bool { get }

• isDragging : 사용자가 콘텐츠를 스크롤하고 있는지 나타내는 부울 값

  var isDragging: Bool { get }

• isDecelerating : 사용자가 손가락을 떼었을 때 콘텐츠가 스크롤뷰에서 움직이지 않고 있는지를 반환

  var isDecelerating: Bool { get }
• decelerationRate : 사용자가 손가락을 뗀 후의 감속도를 결정하는 부동 소수점 값 var decelerationRate: CGFloat { get set }

스크롤 인디케이터 및 새로고침 제어 관리

주요 프로퍼티

• indicatorStyle : 스크롤 인디케이터의 스타일

  var indicatorStyle: UIScrollViewIndicatorStyle { get set }

• showsHorizontalScrollIndicator : 가로 스크롤 바 표시 여부를 제어하는 부울 값

  var showsHorizontalScrollIndicator: Bool { get set }

• showsVerticalScrollIndicator : 세로 스크롤 바 표시 여부를 제어하는 부울 값

  var showsVerticalScrollIndicator: Bool { get set }

특정 위치로 스크롤 하기

주요 메서드

• scrollRectToVisible(_:animated:) : 콘텐츠의 특정 위치로 스크롤 하여 화면에 표시

  func scrollRectToVisible(_ rect: CGRect, animated: Bool)

확대 및 축소

주요 프로퍼티

• panGestureRecognizer : 팬 제스처를 제어하기 위한 제스처 인스턴스

  var panGestureRecognizer: UIPanGestureRecognizer { get }

• pinchGestureRecognizer : 핀치 제스처를 제어하기 위한 제스처 인스턴스

  var pinchGestureRecognizer: UIPinchGestureRecognizer? { get }

• zoomScale : 스크롤뷰 콘텐츠에 적용되는 현재 배율

  var zoomScale: CGFloat { get set }
• maximumZoomScale :  스크롤뷰 콘텐츠에 적용되는 최대 배율 var maximumZoomScale: CGFloat { get set }
• minimumZoomScale : 스크롤뷰 콘텐츠에 적용되는 최소 배율 var minimumZoomScale: CGFloat { get set }

• isZoomBouncing : 확대 및 축소가 지정한 배율 제한을 초과했음을 나타내는 부울 값

  var isZoomBouncing: Bool { get }

• isZooming : 콘텐츠뷰가 현재 확대 또는 축소되어 있는지를 나타내는 부울 값

  var isZooming: Bool { get }

• bouncesZoom : 크기 조정이 최대 또는 최소 제한을 초과할 때 튀어 오르는 애니메이션을 보여줄지 결정하는 부울 값

  var bouncesZoom: Bool { get set }

주요 메서드

• zoom(to:animated:) : 콘텐츠 특정 영역 확대

  func zoom(to rect: CGRect, animated: Bool)

• setZoomScale(_:animated:) : 현재 배율을 지정

  func setZoomScale(_ scale: CGFloat, animated: Bool)

키보드 관리

주요 프로퍼티

• keyboardDismissMode : 스크롤뷰에서 드래그가 시작될 때 키보드가 해제되는 방식

  var keyboardDismissMode: UIScrollViewKeyboardDismissMode { get set }

UIScrollViewDelegate 프로토콜

스크롤 및 드래그

• scrollViewDidScroll(_:) : 콘텐츠뷰를 스크롤 할 때 델리게이트에 알림

  optional func scrollViewDidScroll(_ scrollView: UIScrollView)

• scrollViewWillBeginDragging(_:) : 스크롤뷰에서 콘텐츠 스크롤을 시작할 시점을 델리게이트에 알림

  optional func scrollViewWillBeginDragging(_ scrollView: UIScrollView)
• scrollViewWillEndDragging(_:withVelocity:targetContentOffset:) : 스크롤뷰의 드래그가 끝나기 직전에 델리게이트에 알림optional func scrollViewWillEndDragging(_ scrollView: UIScrollView, withVelocity velocity: CGPoint, targetContentOffset: UnsafeMutablePointer<CGPoint>)
• scrollViewDidEndDragging(_:willDecelerate:) : 스크롤뷰의 드래그가 끝났을 때 델리게이트에 알림optional func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool)

• scrollViewShouldScrollToTop(_:) : 스크롤뷰가 콘텐츠의 맨 위로 스크롤 해야 하는 경우 델리게이트에 동작 여부를 물어봄

  optional func scrollViewShouldScrollToTop(_ scrollView: UIScrollView) -> Bool
• scrollViewDidScrollToTop(_:) : 스크롤뷰가 콘텐츠의 맨 위로 스크롤 되었음을 델리게이트에 알림 optional func scrollViewDidScrollToTop(_ scrollView: UIScrollView)

• scrollViewWillBeginDecelerating(_:) : 스크롤링 동작이 감속되기 시작하고 있다고 델리게이트에 알림

  optional func scrollViewWillBeginDecelerating(_ scrollView: UIScrollView)

• scrollViewDidEndDecelerating(_:) : 스크롤링 동작이 감속이 끝났을 때 델리게이트에 알림

  optional func scrollViewDidEndDecelerating(_ scrollView: UIScrollView)

확대 및 축소

• viewForZooming(in:) : 스크롤뷰에서 확대 및 축소를 할 때 확대 및 축소를 할 뷰 인스턴스를 요청

  optional func viewForZooming(in scrollView: UIScrollView) -> UIView?

• scrollViewWillBeginZooming(_:with:) : 스크롤뷰의 콘텐츠 확대가 시작될 때 델리게이트에 알림

  optional func scrollViewWillBeginZooming(_ scrollView: UIScrollView, with view: UIView?)

• scrollViewDidEndZooming(_:with:atScale:) : 스크롤뷰의 콘텐츠 확대가 완료될 때 델리게이트에 알림

  optional func scrollViewDidEndZooming(_ scrollView: UIScrollView, with view: UIView?, atScale scale: CGFloat)
• scrollViewDidZoom(_:) : 스크롤뷰의 확대 및 축소 배율이 변경될 때 델리게이트에 알림optional func scrollViewDidZoom(_ scrollView: UIScrollView)

스크롤 애니메이션

• scrollViewDidEndScrollingAnimation(_:) : 스크롤뷰의 스크롤 애니메이션이 끝날 때 델리게이트에 알림

  optional func scrollViewDidEndScrollingAnimation(_ scrollView: UIScrollView)