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 React, { useRef, useState } from "react";
import { Input } from "@/components/ui/input";
import { Tooltip } from "@/components/ui/tooltip";
import { getCellNames } from "@/core/cells/cells";
import type { CellId } from "@/core/cells/ids";
import {
getValidName,
isInternalCellName,
normalizeName,
} from "@/core/cells/names";
import { useNotebookDocumentEdit } from "@/core/notebook/document";
import { useOnMount } from "@/hooks/useLifecycle";
import { cn } from "@/utils/cn";
import { Events } from "@/utils/events";
interface Props extends Omit<
React.InputHTMLAttributes<HTMLInputElement>,
"onChange"
> {
value: string;
onChange: (newName: string) => void;
placeholder?: string;
onEnterKey?: () => void;
}
export const NameCellInput: React.FC<Props> = ({
value,
onChange,
placeholder,
onEnterKey,
...props
}) => {
const ref = useRef<HTMLInputElement>(null);
const inputProps = useCellNameInput(value, onChange);
// Custom onBlur without React's synthetic events
// See https://github.com/facebook/react/issues/12363
useOnMount(() => {
const onBlur = inputProps.onBlur;
const input = ref.current;
if (!input) {
return;
}
input.addEventListener("blur", onBlur);
return () => {
input.removeEventListener("blur", onBlur);
};
});
return (
<Input
data-testid="cell-name-input"
value={inputProps.value}
onChange={inputProps.onChange}
ref={ref}
placeholder={placeholder}
className="shadow-none! hover:shadow-none focus:shadow-none focus-visible:shadow-none"
onKeyDown={Events.onEnter((e) => {
Events.stopPropagation()(e);
onEnterKey?.();
})}
{...props}
/>
);
};
export const NameCellContentEditable: React.FC<{
cellId: CellId;
value: string;
className: string;
}> = ({ value, cellId, className }) => {
const edit = useNotebookDocumentEdit();
const inputProps = useCellNameInput(value, (newName) =>
edit((tx) => tx.setName(cellId, newName)),
);
// If the name is the default, don't render the content editable
if (isInternalCellName(value)) {
return null;
}
return (
<Tooltip content="Click to rename">
<span
className={cn(
"outline-hidden border hover:border-cyan-500/40 focus:border-cyan-500/40",
// Prevent layout shift when focusing
inputProps.focusing ? "" : "text-ellipsis",
className,
)}
contentEditable={true}
suppressContentEditableWarning={true}
onChange={inputProps.onChange}
onBlur={inputProps.onBlur}
onFocus={inputProps.onFocus}
onKeyDown={(e) => {
// Prevent all key presses from triggering hotkeys
e.stopPropagation();
// On Enter, blur the input to commit the change
if (e.key === "Enter" && e.target instanceof HTMLElement) {
e.target.blur();
}
}}
>
{value}
</span>
</Tooltip>
);
};
function useCellNameInput(value: string, onChange: (newName: string) => void) {
const [internalValue, setInternalValue] = useState(value);
const [focusing, setFocusing] = useState(false);
const commit = (newValue: string) => {
// No change
if (newValue === value) {
return;
}
// Empty
if (!newValue || isInternalCellName(newValue)) {
onChange(newValue);
return;
}
// Get unique name
const validName = getValidName(newValue, getCellNames());
onChange(validName);
};
return {
value: isInternalCellName(internalValue) ? "" : internalValue,
focusing,
onChange: (evt: React.ChangeEvent<HTMLInputElement>) => {
const newValue = evt.target.value;
const normalized = normalizeName(newValue);
setInternalValue(normalized);
},
onBlur: (evt: Pick<Event, "target">) => {
if (evt.target instanceof HTMLInputElement) {
const newValue = evt.target.value;
commit(normalizeName(newValue));
} else if (evt.target instanceof HTMLSpanElement) {
const newValue = evt.target.innerText.trim();
commit(normalizeName(newValue));
// Scroll to the left after committing to make sure showing the start of the cell name
evt.target.scrollLeft = 0;
setFocusing(false);
}
},
onFocus: () => {
setFocusing(true);
},
};
}