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 { type JSX, useId } from "react";
import { z } from "zod";
import { NativeSelect } from "../../components/ui/native-select";
import { cn } from "../../utils/cn";
import type { IPlugin, IPluginProps } from "../types";
import { Labeled } from "./common/labeled";
import { SearchableSelect } from "./SearchableSelect";
interface Data {
label: string | null;
options: string[];
allowSelectNone: boolean;
fullWidth: boolean;
searchable: boolean;
disabled: boolean;
}
export class DropdownPlugin implements IPlugin<string[], Data> {
public tagName = "marimo-dropdown";
public validator = z.object({
initialValue: z.array(z.string()),
label: z.string().nullable(),
options: z.array(z.string()),
allowSelectNone: z.boolean(),
fullWidth: z.boolean().default(false),
searchable: z.boolean().default(false),
disabled: z.boolean().default(false),
});
public render(props: IPluginProps<string[], Data>): JSX.Element {
if (props.data.searchable) {
const value = props.value.length > 0 ? props.value[0] : null;
const setValue = (newValue: string | null) =>
props.setValue(newValue ? [newValue] : []);
return (
<SearchableSelect {...props.data} value={value} setValue={setValue} />
);
}
return (
<Dropdown {...props.data} value={props.value} setValue={props.setValue} />
);
}
}
type T = string[];
/**
* Arguments for a dropdown menu
*
* @param options - text labels for each dropdown option
* @param allowSelectNone - whether to have a null option
* @param label - an optional label for the dropdown
* @param value - an array of options that is selected by default
* @param setValue - selects a radio option
*/
interface DropdownProps extends Data {
value: T;
setValue: (value: T) => void;
}
const EMPTY_VALUE = "--";
const Dropdown = (props: DropdownProps): JSX.Element => {
const {
label,
options,
value,
setValue,
allowSelectNone,
fullWidth,
disabled,
} = props;
const id = useId();
const defaultValue = allowSelectNone ? EMPTY_VALUE : options[0];
const singleValue = value.length === 0 ? defaultValue : value[0];
return (
<Labeled label={label} controlId={id} fullWidth={fullWidth}>
<NativeSelect
data-testid="marimo-plugin-dropdown"
onChange={(e) => {
const newValue = e.target.value;
if (newValue === EMPTY_VALUE) {
setValue([]);
} else {
setValue([newValue]);
}
}}
className={cn({
"w-full": fullWidth,
})}
value={singleValue}
id={id}
disabled={disabled}
>
{allowSelectNone ? <option value={EMPTY_VALUE}>--</option> : null}
{options.map((option) => (
<option value={option} key={option}>
{option}
</option>
))}
</NativeSelect>
</Labeled>
);
};