본문으로 건너뛰기

ScrollView

개요

콘텐츠가 화면을 넘칠 때 스크롤 가능하도록 만드는 컨테이너입니다. 예를 들어 여러 섹션으로 구성된 상세 페이지에 사용합니다.

속성 (Property)

속성설명기본값
scrollDirection콘텐츠가 스크롤되는 축(가로/세로)을 지정합니다.horizontal, verticalvertical
reverse스크롤 시작 위치를 반대편으로 뒤집습니다.켜기/끄기끄기
padding콘텐츠 주위의 안쪽 여백을 지정합니다. 미설정 시 여백 없이 적용됩니다.여백 값미설정
controller스크롤 위치를 제어할 컨트롤러를 연결합니다. 단, 스크롤 영역이 중첩되어 기본 컨트롤러를 공유하는 경우에는 무시됩니다.컨트롤러미설정
primary기본 스크롤 컨트롤러에 연결할지 지정합니다. 실제 공유는 스크롤 영역이 중첩된 경우에만 이뤄지고, 그 밖에서는 자체 컨트롤러로 분리되어 동작합니다.켜기/끄기끄기
physics스크롤 반응 방식(관성·경계 처리 등)을 지정합니다.bouncing, clamping, alwaysScrollable, rangeMaintaining, neverScrollable, page미설정
dragStartBehavior드래그 시작 시점을 판정하는 기준을 지정합니다.down, startstart
clipBehavior영역을 넘치는 콘텐츠를 잘라내는 방식을 지정합니다.none, hardEdge, antiAlias, antiAliasWithSaveLayerhardEdge
restorationId스크롤 위치를 저장·복원할 때 사용하는 식별자를 지정합니다.문자열미설정
keyboardDismissBehavior스크롤(드래그)할 때 키보드를 자동으로 닫을지 동작을 지정합니다.manual, onDragmanual