Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

1.9 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import { atom, useStore } from "jotai";
import { useJotaiEffect } from "@/core/state/jotai";
import { Logger } from "@/utils/Logger";
import { cellSelectionStateAtom } from "./atoms";

const focusedCellAtom = atom((get) => get(cellSelectionStateAtom).focusedCell);

/**
 * Hook that automatically scrolls the focused cell into view when it changes.
 * This ensures that when users navigate with keyboard or select cells,
 * the focused cell remains visible in scrollable tables.
 */
export function useScrollIntoViewOnFocus(
  root: React.RefObject<HTMLElement | null>,
) {
  const store = useStore();
  useJotaiEffect(focusedCellAtom, (focusedCell) => {
    if (!focusedCell?.cellId) {
      return;
    }

    const scroll = () => {
      if (
        !root.current ||
        store.get(focusedCellAtom)?.cellId !== focusedCell.cellId
      ) {
        return;
      }
      // Check if this cell contains the CellRangeSelectionIndicator with our cellId
      const indicator = root.current?.querySelector<HTMLElement>(
        `[data-cell-id="${focusedCell.cellId}"]`,
      );
      if (!indicator) {
        Logger.warn(
          "[ScrollIntoView] Could not find cell with ID:",
          focusedCell.cellId,
        );
        return;
      }

      const focusRoot = root.current.getRootNode();
      const activeElement =
        focusRoot instanceof ShadowRoot || focusRoot instanceof Document
          ? focusRoot.activeElement
          : null;
      if (
        root.current.contains(activeElement) &&
        activeElement?.matches("td[data-cell-id]")
      ) {
        indicator.focus({ preventScroll: true });
      }

      indicator.scrollIntoView({
        behavior: "smooth",
        block: "nearest",
        inline: "nearest",
      });
    };

    // Small delay to ensure DOM updates have completed
    setTimeout(scroll, 0);
  });
}