スクロールボックス

Split screen内部のスクロール位置をキー名基準で保存し復元します。


基本使用

FlexLayoutSplitScreenScrollBoxはマウント時に保存された位置にscrollLeft/scrollTopを復元し、スクロールイベントをスロットルしてストアに保存します。

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"を与えると、ホバー中のホイールdeltaYを横方向のscrollLeftに変換します。

プロップス

keyName

スクロール位置の保存と復元に使うキーです。

direction

x または y を指定します。x ではホイールで横方向にスクロールします。

listScrollClassName

カスタムスクロールスタイルのクラスです。指定すると、direction に基づく list-scroll の代わりに default-scroll クラスと組み合わされます。

className

組み込みスタイルと組み合わせる外部スタイルクラスです。

© 2026 Byeolnaerim. 無断転載を禁じます。紹介プライバシーポリシー