滾動框

在Split screen內部,根據鍵名儲存和恢復滾動位置。


基本使用

FlexLayoutSplitScreenScrollBox將根據mount時儲存的位置恢復scrollLeft/scrollTop,並對滾動事件進行節流以儲存到store。

tsx
"use client";

import { FlexLayoutSplitScreenScrollBox } from "@byeolnaerim/flex-layout";

export default function CustomerList() {
  return (
    <FlexLayoutSplitScreenScrollBox
      keyName="customer-list"
      direction="y"
      style={{ height: 240, overflowY: "auto" }}
    >
      {Array.from({ length: 40 }, (_, index) => (
        <div key={index} style={{ padding: 12 }}>
          Customer {index + 1}
        </div>
      ))}
    </FlexLayoutSplitScreenScrollBox>
  );
}

狀態生命週期與驗證方法

높이가 제한되어야 박스 내부에서 스크롤됩니다. 각 박스에는 서로 다른 keyName을 사용합니다. 현재 구현은 70ms throttle로 위치를 저장하고, unmount 또는 keyName 변경 시 이전 키를 삭제합니다. 따라서 탭을 숨겨 mount를 유지하는 경우와 컴포넌트를 제거하는 경우는 다르며, 새로고침 후 복원을 보장하지 않습니다.

橫向滾輪滾動

direction="x"如果給定,將hover中的wheel deltaY轉換為橫向scrollLeft。

屬性

keyName

用於儲存及還原捲動位置的鍵。

direction

可設為 x 或 y。x 會將滾輪操作轉換為橫向捲動。

listScrollClassName

自訂捲動樣式類別。指定後,它會與 default-scroll 類別組合,而不使用依 direction 決定的 list-scroll 類別。

className

與內建樣式合併使用的外部樣式類別。

© 2026 Byeolnaerim. 版權所有。介紹隱私政策