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.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
/* Copyright 2026 Marimo. All rights reserved. */
import { getNotebook } from "@/core/cells/cells";
import type { CellId } from "@/core/cells/ids";
import { useOnMount } from "@/hooks/useLifecycle";
import { extractCellNameFromHash } from "@/utils/cell-urls";
import { Logger } from "@/utils/Logger";
/**
* Focus the first editor.
*
* If the URL contains a /#scrollTo= hash, focus on that cell.
* Otherwise, focus on the first non-hidden cell.
*/
export function useFocusFirstEditor() {
useOnMount(() => {
const delay = 100; // ms just so its not immediate
const timeout = setTimeout(() => {
// Let the DOM render
requestAnimationFrame(() => {
// Skip auto-focus if the document doesn't have focus to avoid
// stealing focus from outside (e.g., when embedded in an iframe)
if (!document.hasFocus()) {
return;
}
// Check if the URL contains a scrollTo parameter
const hash = window.location.hash;
const cellName = extractCellNameFromHash(hash);
if (cellName) {
// If we have a scrollTo parameter, focus on that cell
focusCellByName(cellName);
} else {
// Otherwise focus on the first cell
try {
focusFirstEditor();
} catch (error) {
Logger.warn("Error focusing first editor", error);
}
}
});
}, delay);
return () => clearTimeout(timeout);
// Delay only when app is first loaded
});
}
function focusFirstEditor() {
const { cellIds, cellData, cellHandles } = getNotebook();
// Focus on the first cell if it's been mounted and is not hidden
for (const cellId of cellIds) {
const handle = cellHandles[cellId];
const hidden = cellData[cellId]?.config.hide_code;
if (!hidden && handle?.current?.editorView) {
handle.current.editorView.focus();
return;
}
}
}
let hasScrolledToCell = false;
/**
* Focus the cell with the given name
*/
function focusCellByName(cellName: string) {
// Only do this once per page load
if (hasScrolledToCell) {
return;
}
// Find the cell div with data-cell-name attribute matching the cellName
const cellElement = document.querySelector(`[data-cell-name="${cellName}"]`);
if (cellElement) {
// Scroll the element into view
cellElement.scrollIntoView({
behavior: "smooth",
block: "start",
});
hasScrolledToCell = true;
// Try to focus the cell
if (cellElement instanceof HTMLElement) {
cellElement.focus();
// Look for an editor to focus
const { cellHandles } = getNotebook();
const cellId = extractCellIdFromDomElement(cellElement);
if (!cellId) {
Logger.error(`Missing cellId for cell with name ${cellName}`);
return;
}
const editor = cellHandles[cellId]?.current?.editorView;
if (editor) {
editor.focus();
}
}
} else {
Logger.warn(
`Cannot focus cell with name ${cellName} because it was not found`,
);
// Fall back to focusing the first editor if cell not found
focusFirstEditor();
}
}
function extractCellIdFromDomElement(
cellElement: HTMLElement,
): CellId | undefined {
const cellIdStr = cellElement.dataset.cellId ?? undefined;
return cellIdStr as CellId | undefined;
}