# 스크롤바 옵션 

## Content

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

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

`showHorizontalScrollbar` 및 `showVerticalScrollbar`를 사용하여 스크롤 막대 표시 여부를 제어할 수 있습니다.
이 속성은 다음 세 가지 값을 지원합니다.

* `true` — 스크롤 막대를 항상 표시
* `false` — 스크롤 막대를 항상 숨김
* `"auto"` — 워크시트에 스크롤 가능한 콘텐츠가 있을 때만 스크롤 막대 표시

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

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

![autoShow-20260305.dd0b0f.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/autoShow-20260305.dd0b0f-20260528.ca1f63.gif?width=600)
`"auto"` 모드에서는 다음과 같은 경우에도 스크롤 막대가 숨겨집니다.

* 모든 행과 열이 뷰포트 안에 표시되는 경우
* 고정 행 또는 고정 열로 인해 스크롤 가능한 영역이 모두 제거된 경우

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

## 스크롤 가능 범위 제어

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

* `scrollbarMaxAlign`: 활성 시트의 마지막 행 및 열에 맞춰 스크롤 막대를 정렬합니다.
* `scrollbarShowMax`: 전체 행 및 열 개수를 기준으로 스크롤 막대 범위를 계산합니다.

```auto
spread.options.scrollbarMaxAlign = true;
```

![scrollbarMaxAlign-20260305.d9725b.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/scrollbarMaxAlign-20260305.d9725b-20260528.ef6d87.gif?width=600)

```auto
spread.options.scrollbarShowMax = true;
```

![scrollbarShowMax-20260305.b1c603.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/scrollbarShowMax-20260305.b1c603-20260528.549bf2.gif?width=600)

## 숨겨진 행 및 열 무시

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

* 높이 또는 너비가 0인 경우
* `visible` 메서드를 사용하여 숨긴 행 또는 열
* 축소된 그룹 행 또는 열
* 필터링으로 숨겨진 행

```auto
spread.options.scrollIgnoreHidden = true;
```