[]
        
(Showing Draft Content)

스크롤바 옵션

통합 문서의 스크롤 막대 표시 여부와 스크롤 동작을 제어할 수 있습니다.

스크롤 막대 표시 또는 숨기기

showHorizontalScrollbarshowVerticalScrollbar를 사용하여 스크롤 막대 표시 여부를 제어할 수 있습니다.

이 속성은 다음 세 가지 값을 지원합니다.

  • true — 스크롤 막대를 항상 표시

  • false — 스크롤 막대를 항상 숨김

  • "auto" — 워크시트에 스크롤 가능한 콘텐츠가 있을 때만 스크롤 막대 표시

"auto"로 설정하면 콘텐츠가 뷰포트 안에 모두 표시되는 경우 스크롤 막대가 자동으로 숨겨집니다.

spread.options.showHorizontalScrollbar = "auto";
spread.options.showVerticalScrollbar = "auto";

autoShow-20260305.dd0b0f.gif

"auto" 모드에서는 다음과 같은 경우에도 스크롤 막대가 숨겨집니다.

  • 모든 행과 열이 뷰포트 안에 표시되는 경우

  • 고정 행 또는 고정 열로 인해 스크롤 가능한 영역이 모두 제거된 경우

type=note

참고: Excel로 내보낼 때 "auto"true로 처리됩니다. Excel은 자동 스크롤 막대 표시 기능을 지원하지 않기 때문입니다.

스크롤 가능 범위 제어

스크롤 막대가 스크롤 가능한 범위를 계산하는 방식을 조정할 수 있습니다.

  • scrollbarMaxAlign: 활성 시트의 마지막 행 및 열에 맞춰 스크롤 막대를 정렬합니다.

  • scrollbarShowMax: 전체 행 및 열 개수를 기준으로 스크롤 막대 범위를 계산합니다.

spread.options.scrollbarMaxAlign = true;

scrollbarMaxAlign-20260305.d9725b.gif

spread.options.scrollbarShowMax = true;

scrollbarShowMax-20260305.b1c603.gif

숨겨진 행 및 열 무시

scrollIgnoreHidden을 사용하면 숨겨진 행 및 열을 스크롤 막대 계산에서 제외할 수 있습니다.

숨겨진 행 및 열에는 다음이 포함됩니다.

  • 높이 또는 너비가 0인 경우

  • visible 메서드를 사용하여 숨긴 행 또는 열

  • 축소된 그룹 행 또는 열

  • 필터링으로 숨겨진 행

spread.options.scrollIgnoreHidden = true;