Skip to content

스크롤바

스크롤바 스타일 설정

컴포넌트는 기본적으로 네이티브 스크롤바를 사용하며, 브라우저의 스크롤바 스타일에 완전히 의존합니다.

스크롤바 스타일을 커스터마이징하려면 CSS 를 통해 구현할 수 있습니다. StkTable 노드에 class 를 추가하면 됩니다.

vue
<StkTable class="scrollbar"></StkTable>
css
.scrollbar::-webkit-scrollbar {
    /* ..... */
}

다음 예제에서는 ::-webkit-scrollbar 를 사용하여 스크롤바 스타일을 설정합니다.

loading

Blink 또는 webkit 엔진 브라우저 (Chrome, Safari, Opera) 에서만 유효합니다 (::-webkit-scrollbar | MDN 참조).

내장 스크롤바 (^0.9.0)

DOM 기반의 내장 스크롤바는 props.scrollbar 를 통해 활성화할 수 있습니다.

스크롤 백색 화면 문제를 해결할 수 있습니다.

ts
<StkTable 
  virtual
  scrollbar 
></StkTable>
<StkTable
  virtual
  :scrollbar="{ width: 10, height: 10 }"
></StkTable>

주의

가상 목록 (virtual) 에서만 유효합니다.

loading

API 참조

ScrollbarOptions 타입

typescript
interface ScrollbarOptions {
  /** 스크롤바 활성화 여부 */
  enabled?: boolean;
  /** 수직 스크롤바 너비 default: 8 */
  width?: number;
  /** 수평 스크롤바 높이 default: 8 */
  height?: number;
  /** 스크롤바 썸 최소 너비 default: 20 */
  minWidth?: number;
  /** 스크롤바 썸 최소 높이 default: 20 */
  minHeight?: number;
}

스타일 커스터마이징

CSS 변수를 통해 스크롤바 외관을 커스터마이징할 수 있습니다:

css
.stk-table {
  --scrollbar-thumb-color: #c1c1d7;
  --scrollbar-thumb-hover-color: #a8a8c1;
  --scrollbar-track-color: transparent;
}

/* 다크 테마 */
.stk-table.dark {
  --scrollbar-thumb-color: rgba(93, 96, 100, .9);
  --scrollbar-thumb-hover-color: #727782;
}

키보드 스크롤

설명기능
ArrowUp위 방향키한 줄 위로 스크롤
ArrowDown아래 방향키한 줄 아래로 스크롤
ArrowLeft왼쪽 방향키왼쪽으로 50px 스크롤
ArrowRight오른쪽 방향키오른쪽으로 50px 스크롤
PageUp--한 페이지 위로 스크롤
PageDown--한 페이지 아래로 스크롤
Home--상단으로 스크롤
End--하단으로 스크롤

MIT 라이선스에 따라 공개되었습니다