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 { dequal as isEqual } from "dequal";
import { type JSX, useEffect, useId, useState } from "react";
import { useLocale } from "react-aria";
import { z } from "zod";
import { cn } from "@/utils/cn";
import {
fractionDigitsForSlider,
prettyScientificNumber,
} from "@/utils/numbers";
import { RangeSlider } from "../../components/ui/range-slider";
import type { IPlugin, IPluginProps, Setter } from "../types";
import { Labeled } from "./common/labeled";
type T = number[];
interface Data {
start: number;
stop: number;
step?: number;
label: string | null;
steps: T | null;
debounce: boolean;
orientation: "horizontal" | "vertical";
showValue: boolean;
fullWidth: boolean;
disabled?: boolean;
}
export class RangeSliderPlugin implements IPlugin<T, Data> {
public tagName = "marimo-range-slider";
public validator = z.object({
initialValue: z.array(z.number()),
label: z.string().nullable(),
start: z.number(),
stop: z.number(),
step: z.number().optional(),
steps: z.array(z.number()).nullable(),
debounce: z.boolean().default(false),
orientation: z.enum(["horizontal", "vertical"]).default("horizontal"),
showValue: z.boolean().default(false),
fullWidth: z.boolean().default(false),
disabled: z.boolean().optional(),
});
public render(props: IPluginProps<T, Data>): JSX.Element {
const valueMap = (sliderValue: number): number => {
if (props.data.steps && props.data.steps.length > 0) {
return props.data.steps[sliderValue];
}
return sliderValue;
};
return (
<RangeSliderComponent
{...props.data}
value={props.value}
setValue={props.setValue}
valueMap={valueMap}
/>
);
}
}
interface RangeSliderProps extends Data {
value: T;
setValue: Setter<T>;
valueMap: (sliderValue: number) => number;
}
const RangeSliderComponent = ({
label,
setValue,
value,
start,
stop,
step,
steps,
debounce,
orientation,
showValue,
fullWidth,
disabled,
valueMap,
}: RangeSliderProps): JSX.Element => {
const id = useId();
const { locale } = useLocale();
// Hold internal value
const [internalValue, setInternalValue] = useState(value);
const fractionDigits = fractionDigitsForSlider(
step,
steps,
start,
internalValue.map(valueMap),
);
// Update internal value on prop change
useEffect(() => {
// TODO: Replace this synchronization with a controlled-state primitive.
// oxlint-disable-next-line react/no-deriving-state-in-effects -- Synchronize the editable buffer when the controlled value changes.
setInternalValue(value);
}, [value]);
const sliderElement = (
<Labeled
label={label}
controlId={id}
align={orientation === "horizontal" ? "left" : "top"}
className={cn(fullWidth && "my-1 w-full")}
fullWidth={fullWidth}
>
<div
className={cn(
"flex items-center gap-2",
orientation === "vertical" &&
"items-end inline-flex justify-center self-center mx-2",
fullWidth && "w-full",
)}
>
<RangeSlider
id={id}
className={cn(
"relative flex items-center select-none",
!fullWidth && "data-[orientation=horizontal]:w-36 ",
"data-[orientation=vertical]:h-36",
)}
value={internalValue}
min={start}
max={stop}
step={step}
steps={steps ?? undefined}
orientation={orientation}
disabled={disabled}
// Triggered on all value changes
onValueChange={(nextValue: number[]) => {
setInternalValue(nextValue);
if (!debounce) {
setValue(nextValue);
}
}}
// Triggered on mouse up
onValueCommit={(nextValue: number[]) => {
if (debounce) {
setValue(nextValue);
}
}}
// Sometimes onValueCommit doesn't trigger
// see https://github.com/radix-ui/primitives/issues/1760
// So we also set the value on pointer/mouse up
onPointerUp={() => {
if (debounce && !isEqual(internalValue, value)) {
setValue(internalValue);
}
}}
onMouseUp={() => {
if (debounce && !isEqual(internalValue, value)) {
setValue(internalValue);
}
}}
valueMap={valueMap}
/>
{showValue && (
<div className="text-xs text-muted-foreground min-w-[16px]">
{`${prettyScientificNumber(valueMap(internalValue[0]), {
maximumFractionDigits: fractionDigits,
locale,
})}, ${prettyScientificNumber(valueMap(internalValue[1]), {
maximumFractionDigits: fractionDigits,
locale,
})}`}
</div>
)}
</div>
</Labeled>
);
return sliderElement;
};