- Accordion
- Attachment
- Avatar
- Badge
- Breadcrumb
- Button
- Button Group
- Card
- Checkbox
- Code Block
- Collapsible
- Dialog
- Dropdown Menu
- Empty
- Field
- Hover Card
- Input
- Input Group
- Input OTP
- Item
- Label
- Marker
- Message
- Number Flow
- Pagination
- Popover
- Progress
- Radio Group
- Select
- Slider
- Sonner
- Spinner
- Switch
- Tooltip
- Separator
- Sheet
- Tabs
- Textarea
- Toggle
- Toggle Group
- Trace
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Questionnaire is a composition, not a primitive. It wraps a headless engine in lib/questionnaire with four Frakment primitives — Checkbox, RadioGroup, Button, and Card — to render a multi-step form with navigation, validation, and keyboard shortcuts.
Because the engine is compiled, install it through the CLI, not by copying source. The wrapper is available to copy from the Manual tab below.
Installation
Questionnaire is an engine plus a composition. The engine is compiled JavaScript, so install it through the CLI. The wrapper is a regular component you copy from the Manual tab.
$ bunx --bun frakment add questionnaire checkbox radio-group button card$ npx frakment add questionnaire checkbox radio-group button card$ pnpm dlx frakment add questionnaire checkbox radio-group button card$ yarn dlx frakment add questionnaire checkbox radio-group button card
What the command installs
The CLI also installs the npm dependencies these files need: radix-ui and lucide-react.
Install the npm dependencies:
$ bun add radix-ui lucide-react$ npm install radix-ui lucide-react$ pnpm add radix-ui lucide-react$ yarn add radix-ui lucide-react
Copy the headless engine into lib/questionnaire/:
Copy the four primitives the wrapper composes:
"use client";
import { CheckIcon } from "lucide-react";
import * as React from "react";
import { cn } from "@/lib/utils";
type CheckedState = boolean | "indeterminate";
type CheckboxProps = Omit<
React.ComponentPropsWithoutRef<"button">,
"onChange" | "role" | "aria-checked" | "type"
> & {
checked?: CheckedState;
defaultChecked?: CheckedState;
disabled?: boolean;
onCheckedChange?: (checked: CheckedState) => void;
ref?: React.Ref<HTMLButtonElement>;
};
function Checkbox({
checked: checkedProp,
className,
defaultChecked = false,
disabled = false,
onClick,
onCheckedChange,
ref,
...props
}: CheckboxProps) {
const isControlled = checkedProp !== undefined;
const [uncontrolled, setUncontrolled] =
React.useState<CheckedState>(defaultChecked);
const checked = isControlled ? checkedProp : uncontrolled;
const isChecked = checked === true;
const isIndeterminate = checked === "indeterminate";
const isActive = isChecked || isIndeterminate;
const dataState = isIndeterminate
? "indeterminate"
: isChecked
? "checked"
: "unchecked";
const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
onClick?.(event);
if (event.defaultPrevented || disabled) {
return;
}
const next: CheckedState = !isChecked;
if (!isControlled) {
setUncontrolled(next);
}
onCheckedChange?.(next);
};
return (
<button
aria-checked={isIndeterminate ? "mixed" : isChecked}
className={cn(
"peer border-input group-has-[:focus-visible]/field-label:not-data-checked:border-input focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-invalid:aria-checked:border-primary dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:border-primary data-checked:bg-primary data-checked:text-primary-foreground group-has-[:focus-visible]/field-label:data-checked:border-primary dark:data-checked:bg-primary relative flex size-4 shrink-0 items-center justify-center rounded-[4px] border transition-colors outline-none group-has-disabled/field:opacity-50 group-has-[:focus-visible]/field-label:ring-0 after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:ring-3 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3",
className
)}
data-checked={isActive ? "" : undefined}
data-slot="checkbox"
data-state={dataState}
disabled={disabled}
onClick={handleClick}
ref={ref}
role="checkbox"
type="button"
{...props}
>
{isActive ? (
<span
aria-hidden="true"
className="grid place-content-center text-current [&>svg]:size-3.5"
data-slot="checkbox-indicator"
>
{isIndeterminate ? (
<span className="block h-px w-2 rounded-full bg-current" />
) : (
<CheckIcon />
)}
</span>
) : null}
</button>
);
}
export { Checkbox };"use client";
import * as React from "react";
import { cn } from "@/lib/utils";
interface RadioGroupContextValue {
disabled: boolean;
name: string;
registerItem: (value: string) => () => void;
setValue: (value: string) => void;
value: string;
}
const RadioGroupContext = React.createContext<RadioGroupContextValue | null>(
null
);
function useRadioGroupContext(): RadioGroupContextValue {
const ctx = React.useContext(RadioGroupContext);
if (!ctx) {
throw new Error("RadioGroupItem must be used within <RadioGroup>.");
}
return ctx;
}
type RadioGroupProps = Omit<
React.ComponentPropsWithoutRef<"div">,
"defaultValue"
> & {
value?: string;
defaultValue?: string;
onValueChange?: (value: string) => void;
disabled?: boolean;
name?: string;
required?: boolean;
orientation?: "horizontal" | "vertical";
};
function RadioGroup({
className,
defaultValue = "",
disabled = false,
name: nameProp,
onKeyDown,
onValueChange,
orientation = "vertical",
required = false,
value: valueProp,
...props
}: RadioGroupProps) {
const isControlled = valueProp !== undefined;
const [uncontrolled, setUncontrolled] = React.useState(defaultValue);
const value = isControlled ? valueProp : uncontrolled;
const groupName = React.useId().replace(/:/gu, "");
const name = nameProp ?? groupName;
const itemsRef = React.useRef<string[]>([]);
const registerItem = React.useCallback((next: string) => {
if (!itemsRef.current.includes(next)) {
itemsRef.current = [...itemsRef.current, next];
}
return () => {
itemsRef.current = itemsRef.current.filter((x) => x !== next);
};
}, []);
const setValue = React.useCallback(
(next: string) => {
if (!isControlled) {
setUncontrolled(next);
}
onValueChange?.(next);
},
[isControlled, onValueChange]
);
const ctx = React.useMemo<RadioGroupContextValue>(
() => ({ disabled, name, registerItem, setValue, value }),
[disabled, name, registerItem, setValue, value]
);
const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
onKeyDown?.(event);
if (event.defaultPrevented) {
return;
}
const root = event.currentTarget;
const items = Array.from(
root.querySelectorAll<HTMLElement>(
"[data-slot=radio-group-item]:not([disabled])"
)
);
if (items.length === 0) {
return;
}
const currentIdx = items.indexOf(document.activeElement as HTMLElement);
if (currentIdx < 0) {
return;
}
const isVertical = orientation === "vertical";
const prevKey = isVertical ? "ArrowUp" : "ArrowLeft";
const nextKey = isVertical ? "ArrowDown" : "ArrowRight";
let nextIdx = -1;
if (event.key === nextKey) {
nextIdx = (currentIdx + 1) % items.length;
} else if (event.key === prevKey) {
nextIdx = (currentIdx - 1 + items.length) % items.length;
} else if (event.key === "Home") {
nextIdx = 0;
} else if (event.key === "End") {
nextIdx = items.length - 1;
}
if (nextIdx < 0) {
return;
}
event.preventDefault();
items[nextIdx].focus();
const nextValue = items[nextIdx].getAttribute("data-value");
if (nextValue) {
setValue(nextValue);
}
};
return (
<RadioGroupContext.Provider value={ctx}>
<div
{...props}
aria-disabled={disabled || undefined}
aria-orientation={orientation}
aria-required={required || undefined}
className={cn("grid w-full gap-2", className)}
data-disabled={disabled || undefined}
data-orientation={orientation}
data-slot="radio-group"
data-value={value}
onKeyDown={handleKeyDown}
role="radiogroup"
>
{props.children}
<input name={name} type="hidden" value={value} />
</div>
</RadioGroupContext.Provider>
);
}
type RadioGroupItemProps = Omit<
React.ComponentPropsWithoutRef<"button">,
"onChange" | "role" | "aria-checked" | "type" | "ref" | "value"
> & {
value: string;
ref?: React.Ref<HTMLButtonElement>;
};
function RadioGroupItem({
className,
disabled: disabledProp,
onClick,
ref,
value,
...props
}: RadioGroupItemProps) {
const ctx = useRadioGroupContext();
const isChecked = ctx.value === value;
const isDisabled = ctx.disabled || disabledProp === true;
const registerItem = ctx.registerItem;
React.useEffect(() => registerItem(value), [registerItem, value]);
const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
onClick?.(event);
if (event.defaultPrevented || isDisabled) {
return;
}
ctx.setValue(value);
};
return (
<button
{...props}
aria-checked={isChecked}
className={cn(
"group/radio-group-item peer border-input group-has-[:focus-visible]/field-label:not-data-checked:border-input focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-invalid:aria-checked:border-primary dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:border-primary data-checked:bg-primary data-checked:text-primary-foreground group-has-[:focus-visible]/field-label:data-checked:border-primary dark:data-checked:bg-primary relative flex aspect-square size-4 shrink-0 rounded-full border outline-none group-has-[:focus-visible]/field-label:ring-0 after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:ring-3 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3",
className
)}
data-checked={isChecked ? "" : undefined}
data-slot="radio-group-item"
data-state={isChecked ? "checked" : "unchecked"}
data-value={value}
disabled={isDisabled}
onClick={handleClick}
ref={ref}
role="radio"
tabIndex={isChecked ? 0 : -1}
type="button"
>
{isChecked ? (
<span
aria-hidden="true"
className="flex size-4 items-center justify-center"
data-slot="radio-group-indicator"
>
<span className="bg-primary-foreground absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full" />
</span>
) : null}
</button>
);
}
export { RadioGroup, RadioGroupItem };"use client";
import type { VariantProps } from "class-variance-authority";
import * as React from "react";
import {
getTransition,
parseMotion,
useMotionGuard,
useReducedMotion,
} from "@/lib/motion";
import { buttonVariants, cn } from "@/lib/utils";
export interface ButtonBaseProps extends VariantProps<typeof buttonVariants> {
anchorRef?: React.Ref<HTMLAnchorElement>;
as?: React.ElementType;
children?: React.ReactNode;
className?: string;
download?: string | boolean;
href?: string;
motion?: string;
rel?: string;
target?: React.HTMLAttributeAnchorTarget;
}
// biome-ignore lint/suspicious/noExplicitAny: loose polymorphic props for the `as` escape hatch
export type ButtonProps = ButtonBaseProps & Record<string, any>;
function Button({
as,
className,
variant,
size,
href,
target,
rel,
download,
ref,
anchorRef,
motion,
style,
children,
...props
}: ButtonProps) {
const reduce = useReducedMotion();
const internalRef = React.useRef<HTMLElement | null>(null);
const motionEnabled = motion !== undefined && !reduce;
let resolvedStyle = style as React.CSSProperties | undefined;
if (reduce) {
resolvedStyle = { ...resolvedStyle, transition: "none" };
} else if (motion !== undefined) {
const transition = getTransition(parseMotion(motion));
if (transition) {
resolvedStyle = { ...resolvedStyle, transition };
}
}
const styleFingerprint = JSON.stringify(resolvedStyle ?? null);
const yielded = useMotionGuard(internalRef, motionEnabled, styleFingerprint);
if (yielded && !reduce) {
resolvedStyle = { ...resolvedStyle, transition: "none" };
}
const setRef = React.useCallback(
(el: HTMLElement | null) => {
internalRef.current = el;
if (href !== undefined && anchorRef) {
if (typeof anchorRef === "function") {
anchorRef(el as HTMLAnchorElement | null);
} else {
(
anchorRef as React.MutableRefObject<HTMLAnchorElement | null>
).current = el as HTMLAnchorElement | null;
}
}
if (typeof ref === "function") {
(ref as (el: HTMLElement | null) => void)(el);
} else if (ref && typeof ref === "object") {
(ref as React.MutableRefObject<HTMLElement | null>).current = el;
}
},
[href, ref, anchorRef]
);
const classes = cn(buttonVariants({ className, size, variant }));
const attrs = {
"data-inline": true,
"data-size": size,
"data-slot": "button",
"data-variant": variant,
} as const;
if (as !== undefined) {
const allProps: Record<string, unknown> = {
...attrs,
...props,
className: classes,
ref: setRef,
style: resolvedStyle,
};
if (href !== undefined) {
allProps.href = href;
}
if (download !== undefined) {
allProps.download = download;
}
if (rel !== undefined) {
allProps.rel = rel;
}
if (target !== undefined) {
allProps.target = target;
}
return React.createElement(as, allProps, children);
}
if (href !== undefined) {
const {
type: _t,
disabled: _d,
form: _f,
formAction: _fa,
formEncType: _fe,
formMethod: _fm,
formNoValidate: _fnv,
formTarget: _ft,
name: _n,
value: _v,
...anchorRest
} = props as React.ButtonHTMLAttributes<HTMLButtonElement>;
return (
<a
className={classes}
download={download}
href={href}
ref={setRef}
rel={rel}
style={resolvedStyle}
target={target}
{...attrs}
{...(anchorRest as React.AnchorHTMLAttributes<HTMLAnchorElement>)}
>
{children}
</a>
);
}
return (
<button
className={classes}
ref={setRef}
style={resolvedStyle}
{...attrs}
{...(props as React.ButtonHTMLAttributes<HTMLButtonElement>)}
>
{children}
</button>
);
}
export { Button };import type * as React from "react";
import { cn } from "@/lib/utils";
function Card({
className,
size = "default",
...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
return (
<div
className={cn(
"group/card bg-card text-card-foreground ring-foreground/10 flex flex-col gap-(--card-spacing) overflow-hidden rounded-xl py-(--card-spacing) text-sm ring-1 [--card-spacing:--spacing(4)] has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:[--card-spacing:--spacing(3)] data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
className
)}
data-size={size}
data-slot="card"
{...props}
/>
);
}
function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn(
"group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-(--card-spacing) has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-(--card-spacing)",
className
)}
data-slot="card-header"
{...props}
/>
);
}
function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn(
"text-base leading-snug font-medium group-data-[size=sm]/card:text-sm",
className
)}
data-slot="card-title"
{...props}
/>
);
}
function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn("text-muted-foreground text-sm", className)}
data-slot="card-description"
{...props}
/>
);
}
function CardAction({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn(
"col-start-2 row-span-2 row-start-1 self-start justify-self-end",
className
)}
data-slot="card-action"
{...props}
/>
);
}
function CardContent({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn("px-(--card-spacing)", className)}
data-slot="card-content"
{...props}
/>
);
}
function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn(
"flex items-center rounded-b-xl p-(--card-spacing)",
className
)}
data-slot="card-footer"
{...props}
/>
);
}
export {
Card,
CardAction,
CardContent,
CardDescription,
CardFooter,
CardHeader,
CardTitle,
};Copy the wrapper into components/ui/questionnaire.tsx:
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Update the import paths to match your project setup.
Usage
Import the wrapper from components/ui/questionnaire and the engine types from lib/questionnaire if you need to type onStatusChange.
import {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSubmit,
QuestionnaireTitle,
} from "@/components/ui/questionnaire";<Questionnaire items={items} defaultItem="scope" onSubmit={handleSubmit}>
<QuestionnaireProgress />
<QuestionnaireItem name="scope" required>
<QuestionnaireTitle>What should the agent change?</QuestionnaireTitle>
<QuestionnaireDescription>Pick the change scope.</QuestionnaireDescription>
<QuestionnaireChoices>
<QuestionnaireChoice value="component">Component only</QuestionnaireChoice>
<QuestionnaireChoice value="feature">Complete feature</QuestionnaireChoice>
</QuestionnaireChoices>
<QuestionnaireError />
</QuestionnaireItem>
<QuestionnaireActions>
<QuestionnairePrevious />
<QuestionnaireNext>Next</QuestionnaireNext>
<QuestionnaireSubmit>Save</QuestionnaireSubmit>
</QuestionnaireActions>
</Questionnaire>The engine handles keyboard navigation, focus management, and form submission. Every choice renders as a native <input> wrapped by Checkbox or RadioGroup depending on whether the parent item is multiple.
Anatomy
<Questionnaire items={items} defaultItem="first">
<QuestionnaireProgress />
<QuestionnaireItem name="first" required>
<QuestionnaireTitle />
<QuestionnaireDescription />
<QuestionnaireChoices>
<QuestionnaireChoice value="a" />
<QuestionnaireChoice value="b" />
<QuestionnaireInput />
</QuestionnaireChoices>
<QuestionnaireError />
</QuestionnaireItem>
<QuestionnaireActions>
<QuestionnairePrevious />
<QuestionnaireSkip />
<QuestionnaireNext />
<QuestionnaireSubmit />
</QuestionnaireActions>
</Questionnaire>- Questionnaire — form root, tracks current step, focuses the active fieldset
- Progress — current position indicator, supports custom
render - Item — one question; renders as a
fieldsetwith alegend - Title / Description — question heading and helper text
- Choices / Choice — radio or checkbox group, depending on
multiple - Input — freeform text input inside the choice group
- Error — inline error region, wired via
aria-describedbywhen invalid - Actions / Previous / Skip / Next / Submit — navigation controls
Multiple selection
Set multiple on QuestionnaireItem to render checkboxes instead of radios.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Freeform input
Add QuestionnaireInput inside QuestionnaireChoices to let users type a custom answer alongside the predefined choices.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Conditional steps
Set disabled on an item to skip it dynamically. The engine skips disabled steps during navigation.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Keyboard shortcuts
Pass shortcuts="letters" or shortcuts="numbers" to show a shortcut badge on each choice. Pressing the key selects that choice.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};In a dialog
Questionnaire composes with Dialog for inline clarification flows. Each step renders into DialogHeader, and QuestionnaireActions sits inside DialogFooter.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};In Context
Agent configuration wizard
A multi-step flow that configures an agent before it starts. Each question narrows what the agent is allowed to do.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Scoped clarification in a dialog
Embed the questionnaire in a dialog when the agent needs a single focused clarification. Only the active step renders at once.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Skip button
Add QuestionnaireSkip for optional steps. The demo tracks onStatusChange to distinguish "skipped" from "answered".
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Validation
Validate answers on submit with any schema library. The demo uses Zod and pushes errors back into QuestionnaireError per item.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Controlled step
Pass item and onItemChange to control the active step from outside. Useful when a host tracks the checkpoint.
Current checkpoint: Change scope
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Resume with saved answers
Combine defaultItem, defaultChecked, and onReset to resume from saved state. defaultValue on QuestionnaireInput prefills freeform fields.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Navigation state
Track onStatusChange per item to disable Next and Submit until the current step is answered.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Custom progress
Override QuestionnaireProgress with render to display a step bar or any custom indicator.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};Animated step transition
Animate the active item with data-active utilities. Motion respects prefers-reduced-motion.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};In a card
Compose Questionnaire with Card. Use render on QuestionnaireTitle and QuestionnaireDescription to render CardTitle and CardDescription.
"use client";
import * as React from "react";
import type { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
import { Questionnaire as QuestionnairePrimitive } from "@/lib/questionnaire";
import { buttonVariants, cn } from "@/lib/utils";
function Questionnaire({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Root>) {
return (
<QuestionnairePrimitive.Root
className={cn("flex w-full min-w-0 flex-col gap-4", className)}
data-slot="questionnaire"
{...props}
/>
);
}
function QuestionnaireProgress({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Progress>) {
return (
<QuestionnairePrimitive.Progress
className={cn(
"text-muted-foreground min-h-[1lh] w-fit min-w-[14ch] text-xs font-medium tabular-nums",
className
)}
data-slot="questionnaire-progress"
{...props}
/>
);
}
function QuestionnaireItem({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Item>) {
return (
<QuestionnairePrimitive.Item
className={cn(
"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none",
className
)}
data-slot="questionnaire-item"
{...props}
/>
);
}
function QuestionnaireTitle({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Title>) {
return (
<QuestionnairePrimitive.Title
className={cn(
"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4",
className
)}
data-slot="questionnaire-title"
{...props}
/>
);
}
function QuestionnaireDescription({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Description>) {
return (
<QuestionnairePrimitive.Description
className={cn("text-muted-foreground text-sm text-pretty", className)}
data-slot="questionnaire-description"
{...props}
/>
);
}
function QuestionnaireChoices({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choices>) {
return (
<QuestionnairePrimitive.Choices
className={cn(
"group/questionnaire-choices grid min-w-0 gap-2",
className
)}
data-slot="questionnaire-choices"
{...props}
/>
);
}
function QuestionnaireChoice({
children,
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Choice>) {
const [checked, setChecked] = React.useState(false);
const [multiple, setMultiple] = React.useState(false);
const inputRef = React.useRef<HTMLInputElement>(null);
React.useEffect(() => {
const input = inputRef.current;
if (!input) {
return;
}
setMultiple(input.type === "checkbox");
setChecked(input.checked);
const sync = () => setChecked(input.checked);
input.addEventListener("change", sync);
return () => input.removeEventListener("change", sync);
}, []);
return (
<QuestionnairePrimitive.Choice
className={cn(
"group/questionnaire-choice border-input hover:bg-muted/50 relative flex min-h-11 cursor-pointer items-start gap-2.5 rounded-lg border bg-transparent px-3 py-2.5 text-start text-sm transition-colors outline-none select-none",
checked && "border-primary bg-muted dark:bg-muted",
className
)}
data-slot="questionnaire-choice"
{...props}
>
<QuestionnairePrimitive.ChoiceInput
className="sr-only"
data-slot="questionnaire-choice-input"
ref={inputRef}
/>
<span
aria-hidden="true"
className="pointer-events-none mt-0.5 flex shrink-0"
data-slot="questionnaire-choice-indicator"
>
{multiple ? (
<Checkbox aria-hidden checked={checked} tabIndex={-1} />
) : (
<RadioGroup
aria-hidden
className="contents"
onValueChange={() => {}}
value={checked ? "on" : ""}
>
<RadioGroupItem
className="pointer-events-none"
tabIndex={-1}
value="on"
/>
</RadioGroup>
)}
</span>
<QuestionnairePrimitive.ChoiceLabel
className="flex min-w-0 flex-1 flex-col gap-0.5 leading-snug"
data-slot="questionnaire-choice-label"
>
{children}
</QuestionnairePrimitive.ChoiceLabel>
<QuestionnairePrimitive.ChoiceShortcut
className="border-input bg-background text-muted-foreground pointer-events-none ms-auto hidden size-5 shrink-0 items-center justify-center rounded-md border font-mono text-[0.625rem] leading-none font-medium group-data-[shortcut]/questionnaire-choice:inline-flex"
data-slot="questionnaire-choice-shortcut"
/>
</QuestionnairePrimitive.Choice>
);
}
function QuestionnaireChoiceDescription({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
className={cn("text-muted-foreground", className)}
data-slot="questionnaire-choice-description"
{...props}
/>
);
}
function QuestionnaireInput({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Input>) {
return (
<div
className="group/questionnaire-input relative w-full min-w-0"
data-slot="questionnaire-input-wrapper"
>
<QuestionnairePrimitive.Input
className={cn(
"border-input focus-visible:border-ring focus-visible:ring-ring/50 disabled:bg-input/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 h-8 min-h-11 w-full min-w-0 rounded-lg border bg-transparent px-2.5 py-1 text-base transition-[color,box-shadow,background-color] outline-none focus-visible:ring-3 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-3 sm:min-h-0 md:text-sm",
"selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground",
className
)}
data-slot="questionnaire-input"
{...props}
/>
</div>
);
}
function QuestionnaireError({
className,
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Error>) {
return (
<QuestionnairePrimitive.Error
className={cn("text-destructive mt-2 text-sm", className)}
data-slot="questionnaire-error"
{...props}
/>
);
}
function QuestionnaireActions({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
className={cn(
"grid min-h-11 w-full grid-cols-[minmax(0,1fr)_auto_auto] items-center gap-2 sm:min-h-8",
className
)}
data-slot="questionnaire-actions"
{...props}
/>
);
}
function QuestionnairePrevious({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Previous> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Previous
className={cn(
buttonVariants({ size, variant }),
"col-start-1 row-start-1 min-h-11 justify-self-start sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-previous"
data-variant={variant}
{...props}
>
{children ?? "Previous"}
</QuestionnairePrimitive.Previous>
);
}
function QuestionnaireSkip({
children,
className,
size = "default",
variant = "outline",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Skip> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Skip
className={cn(
buttonVariants({ size, variant }),
"col-start-2 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-skip"
data-variant={variant}
{...props}
>
{children ?? "Skip"}
</QuestionnairePrimitive.Skip>
);
}
function QuestionnaireNext({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Next> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Next
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-next"
data-variant={variant}
{...props}
>
{children ?? "Next"}
</QuestionnairePrimitive.Next>
);
}
function QuestionnaireSubmit({
children,
className,
size = "default",
variant = "default",
...props
}: React.ComponentProps<typeof QuestionnairePrimitive.Submit> &
Pick<React.ComponentProps<typeof Button>, "size" | "variant">) {
return (
<QuestionnairePrimitive.Submit
className={cn(
buttonVariants({ size, variant }),
"col-start-3 row-start-1 min-h-11 justify-self-end sm:min-h-0",
className
)}
data-size={size}
data-slot="questionnaire-submit"
data-variant={variant}
{...props}
>
{children ?? "Submit"}
</QuestionnairePrimitive.Submit>
);
}
export {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoiceDescription,
QuestionnaireChoices,
QuestionnaireDescription,
QuestionnaireError,
QuestionnaireInput,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireProgress,
QuestionnaireSkip,
QuestionnaireSubmit,
QuestionnaireTitle,
};API Reference
Questionnaire
Extends React.ComponentPropsWithRef<"form">.
| Prop | Type | Default | Description |
|---|---|---|---|
items | QuestionnaireItemDefinition[] | — | Ordered step definitions. |
defaultItem | string | — | Initial step when uncontrolled. |
item | string | — | Controlled active step. |
onItemChange | (item: string) => void | — | Fires on step change. |
shortcuts | "letters""numbers" | — | Show keyboard shortcut badges. |
onSubmit | (event: React.FormEvent<HTMLFormElement>) => void | — | Fires on final step submit. |
QuestionnaireProgress
Renders step indicator. Accepts render.
| Prop | Type | Default | Description |
|---|---|---|---|
render | React.ReactElement((props, state) => React.ReactNode) | — | Custom indicator. State: { current, first, last, total }. |
QuestionnaireItem
Extends React.ComponentPropsWithRef<"fieldset">.
| Prop | Type | Default | Description |
|---|---|---|---|
name* | string | — | Matches the items entry. |
multiple | boolean | false | Checkboxes instead of radios. |
required | boolean | false | Blocks Next/Submit until answered. |
disabled | boolean | false | Skips the step. |
invalid | boolean | false | Marks invalid; links Error via aria-describedby. |
onStatusChange | (status: QuestionnaireItemStatus) => void | — | Fires on unanswered / answered / skipped. |
QuestionnaireTitle / QuestionnaireDescription
Render question heading (legend) and helper (p). Both accept render for custom elements.
QuestionnaireChoices
Wraps the choice group. Accepts render.
QuestionnaireChoice
| Prop | Type | Default | Description |
|---|---|---|---|
value* | string | — | Submitted value. |
checked | boolean | — | Controlled state. |
defaultChecked | boolean | — | Uncontrolled initial state. |
disabled | boolean | — | Disables this choice. |
onChange | React.ChangeEventHandler<HTMLInputElement> | — | Fires on toggle. |
QuestionnaireInput
| Prop | Type | Default | Description |
|---|---|---|---|
type | "text""email""number""url""tel""date""password""search" | "text" | Native input type. |
placeholder | string | — | Shown when empty. |
defaultValue | string | — | Uncontrolled initial value. |
QuestionnaireError
Inline error. Linked via aria-describedby when the parent is invalid. Accepts render.
QuestionnaireActions
Container for navigation buttons.
QuestionnairePrevious / QuestionnaireSkip / QuestionnaireNext / QuestionnaireSubmit
| Prop | Type | Default | Description |
|---|---|---|---|
disabled | boolean | — | Forces disabled state. |
variant | Button variant | — | Passed to the default Button. |
render | React.ReactElement | — | Swaps the underlying element. |
Accessibility
- Each
QuestionnaireItemrenders afieldsetwithlegend(viaQuestionnaireTitle), so screen readers announce the question on focus. QuestionnaireErroris linked to the fieldset viaaria-describedbywhen the item is invalid.- Keyboard shortcuts do not replace tab navigation. Users can still move between choices with Tab and Space.
- When the questionnaire is embedded in a Dialog, focus is trapped inside and restored on close.
Best Practices
- One question per step. Long forms break focus management and lose the progress indicator's value.
- Mark required fields explicitly.
requiredon the item enables inline validation; skipping is only allowed when the field is optional. - Use
shortcutssparingly. Letters or numbers help power users in dense flows but confuse others in short flows. - Validate on submit, not on every keystroke. Reserve
invalidfor real problems; show it only after the user tries to advance. - Persist answers if the flow spans sessions. Store
FormDataafter each submit; the engine resumes from the active step on load. - Keep the last step informational. The final submit should confirm what will happen, not add a new question.
On This Page
InstallationWhat the command installsUsageAnatomyMultiple selectionFreeform inputConditional stepsKeyboard shortcutsIn a dialogIn ContextAgent configuration wizardScoped clarification in a dialogSkip buttonValidationControlled stepResume with saved answersNavigation stateCustom progressAnimated step transitionIn a cardAPI ReferenceQuestionnaireQuestionnaireProgressQuestionnaireItemQuestionnaireTitle / QuestionnaireDescriptionQuestionnaireChoicesQuestionnaireChoiceQuestionnaireInputQuestionnaireErrorQuestionnaireActionsQuestionnairePrevious / QuestionnaireSkip / QuestionnaireNext / QuestionnaireSubmitAccessibilityBest Practices