- 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 { cva, type VariantProps } from "class-variance-authority";
import type * as React from "react";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
import { Textarea } from "@/components/ui/textarea";
import { cn } from "@/lib/utils";
function InputGroup({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn(
"group/input-group border-input has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 has-[[data-slot][aria-invalid=true]]:border-destructive has-[[data-slot][aria-invalid=true]]:ring-destructive/20 dark:bg-input/30 dark:has-[[data-slot][aria-invalid=true]]:ring-destructive/40 relative flex h-9 w-full min-w-0 items-center rounded-lg border transition-colors outline-none in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0 has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>textarea]:h-auto has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot][aria-invalid=true]]:ring-3 has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:pb-3 has-[>[data-align=inline-end]]:[&>input]:pr-1.5 has-[>[data-align=inline-start]]:[&>input]:pl-1.5",
className
)}
data-slot="input-group"
role="group"
{...props}
/>
);
}
const inputGroupAddonVariants = cva(
"text-subtle-foreground flex h-auto cursor-text items-center justify-center gap-2 py-1.5 text-sm font-medium select-none group-data-[disabled=true]/input-group:opacity-50 [&>kbd]:rounded-[calc(var(--radius)-5px)] [&>svg:not([class*='size-'])]:size-4",
{
defaultVariants: {
align: "inline-start",
},
variants: {
align: {
"block-end":
"order-last w-full justify-start px-2.5 pb-2 group-has-[>input]/input-group:pb-2 [.border-t]:pt-2",
"block-start":
"order-first w-full justify-start px-2.5 pt-2 group-has-[>input]/input-group:pt-2 [.border-b]:pb-2",
"inline-end":
"order-last pr-2 has-[>button]:mr-[-0.3rem] has-[>kbd]:mr-[-0.15rem]",
"inline-start":
"order-first pl-2 has-[>button]:ml-[-0.3rem] has-[>kbd]:ml-[-0.15rem]",
},
},
}
);
function InputGroupAddon({
className,
align = "inline-start",
...props
}: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>) {
return (
<div
className={cn(inputGroupAddonVariants({ align }), className)}
data-align={align}
data-slot="input-group-addon"
onClick={(e) => {
if ((e.target as HTMLElement).closest("button")) {
return;
}
e.currentTarget.parentElement?.querySelector("input")?.focus();
}}
role="group"
{...props}
/>
);
}
const inputGroupButtonVariants = cva(
"flex items-center gap-2 rounded-full text-sm shadow-none",
{
defaultVariants: {
size: "xs",
},
variants: {
size: {
"icon-sm": "size-8 p-0 has-[>svg]:p-0",
"icon-xs":
"size-6 rounded-[calc(var(--radius)-3px)] p-0 has-[>svg]:p-0",
sm: "",
xs: "h-6 gap-1 rounded-[calc(var(--radius)-3px)] px-1.5 [&>svg:not([class*='size-'])]:size-3.5",
},
},
}
);
function InputGroupButton({
className,
type = "button",
variant = "ghost",
size = "xs",
...props
}: Omit<React.ComponentProps<typeof Button>, "size"> &
VariantProps<typeof inputGroupButtonVariants>) {
return (
<Button
className={cn(inputGroupButtonVariants({ size }), className)}
data-size={size}
type={type}
variant={variant}
{...props}
/>
);
}
function InputGroupText({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
className={cn(
"text-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex items-center gap-2 text-sm [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
/>
);
}
function InputGroupInput({
className,
...props
}: React.ComponentProps<"input">) {
return (
<Input
className={cn(
"flex-1 rounded-none border-0 bg-transparent shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
className
)}
data-slot="input-group-control"
{...props}
/>
);
}
function InputGroupTextarea({
className,
...props
}: React.ComponentProps<"textarea">) {
return (
<Textarea
className={cn(
"flex-1 resize-none rounded-none border-0 bg-transparent py-2 shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
className
)}
data-slot="input-group-control"
{...props}
/>
);
}
export {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupInput,
InputGroupText,
InputGroupTextarea,
};Input Group wraps a single input or textarea and lets you compose inline addons — icons, text prefixes, and buttons — in a single bordered surface.
Installation
$ bunx --bun frakment add input-group$ npx frakment add input-group$ pnpm dlx frakment add input-group$ yarn dlx frakment add input-group
The CLI also installs the registry dependencies: button, input, and textarea.
Install the following dependencies:
$ bun add class-variance-authority$ npm install class-variance-authority$ pnpm add class-variance-authority$ yarn add class-variance-authority
Copy and paste the following code into your project.
"use client";
import { cva, type VariantProps } from "class-variance-authority";
import type * as React from "react";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
import { Textarea } from "@/components/ui/textarea";
import { cn } from "@/lib/utils";
function InputGroup({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
className={cn(
"group/input-group border-input has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 has-[[data-slot][aria-invalid=true]]:border-destructive has-[[data-slot][aria-invalid=true]]:ring-destructive/20 dark:bg-input/30 dark:has-[[data-slot][aria-invalid=true]]:ring-destructive/40 relative flex h-9 w-full min-w-0 items-center rounded-lg border transition-colors outline-none in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0 has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>textarea]:h-auto has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot][aria-invalid=true]]:ring-3 has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:pb-3 has-[>[data-align=inline-end]]:[&>input]:pr-1.5 has-[>[data-align=inline-start]]:[&>input]:pl-1.5",
className
)}
data-slot="input-group"
role="group"
{...props}
/>
);
}
const inputGroupAddonVariants = cva(
"text-subtle-foreground flex h-auto cursor-text items-center justify-center gap-2 py-1.5 text-sm font-medium select-none group-data-[disabled=true]/input-group:opacity-50 [&>kbd]:rounded-[calc(var(--radius)-5px)] [&>svg:not([class*='size-'])]:size-4",
{
defaultVariants: {
align: "inline-start",
},
variants: {
align: {
"block-end":
"order-last w-full justify-start px-2.5 pb-2 group-has-[>input]/input-group:pb-2 [.border-t]:pt-2",
"block-start":
"order-first w-full justify-start px-2.5 pt-2 group-has-[>input]/input-group:pt-2 [.border-b]:pb-2",
"inline-end":
"order-last pr-2 has-[>button]:mr-[-0.3rem] has-[>kbd]:mr-[-0.15rem]",
"inline-start":
"order-first pl-2 has-[>button]:ml-[-0.3rem] has-[>kbd]:ml-[-0.15rem]",
},
},
}
);
function InputGroupAddon({
className,
align = "inline-start",
...props
}: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>) {
return (
<div
className={cn(inputGroupAddonVariants({ align }), className)}
data-align={align}
data-slot="input-group-addon"
onClick={(e) => {
if ((e.target as HTMLElement).closest("button")) {
return;
}
e.currentTarget.parentElement?.querySelector("input")?.focus();
}}
role="group"
{...props}
/>
);
}
const inputGroupButtonVariants = cva(
"flex items-center gap-2 rounded-full text-sm shadow-none",
{
defaultVariants: {
size: "xs",
},
variants: {
size: {
"icon-sm": "size-8 p-0 has-[>svg]:p-0",
"icon-xs":
"size-6 rounded-[calc(var(--radius)-3px)] p-0 has-[>svg]:p-0",
sm: "",
xs: "h-6 gap-1 rounded-[calc(var(--radius)-3px)] px-1.5 [&>svg:not([class*='size-'])]:size-3.5",
},
},
}
);
function InputGroupButton({
className,
type = "button",
variant = "ghost",
size = "xs",
...props
}: Omit<React.ComponentProps<typeof Button>, "size"> &
VariantProps<typeof inputGroupButtonVariants>) {
return (
<Button
className={cn(inputGroupButtonVariants({ size }), className)}
data-size={size}
type={type}
variant={variant}
{...props}
/>
);
}
function InputGroupText({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
className={cn(
"text-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex items-center gap-2 text-sm [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
/>
);
}
function InputGroupInput({
className,
...props
}: React.ComponentProps<"input">) {
return (
<Input
className={cn(
"flex-1 rounded-none border-0 bg-transparent shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
className
)}
data-slot="input-group-control"
{...props}
/>
);
}
function InputGroupTextarea({
className,
...props
}: React.ComponentProps<"textarea">) {
return (
<Textarea
className={cn(
"flex-1 resize-none rounded-none border-0 bg-transparent py-2 shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
className
)}
data-slot="input-group-control"
{...props}
/>
);
}
export {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupInput,
InputGroupText,
InputGroupTextarea,
};Update the import paths to match your project setup.
Usage
import {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupInput,
InputGroupText,
InputGroupTextarea,
} from "@/components/ui/input-group";<InputGroup>
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput placeholder="Search..." />
</InputGroup>Composition
InputGroup
├── InputGroupInput
├── InputGroupTextarea
├── InputGroupAddon
├── InputGroupButton
└── InputGroupTextExamples
Block end
align="block-end" stacks content below the control and lets the group grow taller automatically.
"use client";
import { ArrowUpIcon } from "lucide-react";
import {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupTextarea,
} from "@/components/ui/input-group";
export function InputGroupBlockEnd() {
return (
<div className="w-full max-w-md">
<InputGroup>
<InputGroupTextarea placeholder="Type a message" rows={2} />
<InputGroupAddon align="block-end" className="justify-end">
<InputGroupButton size="icon-sm" variant="default">
<ArrowUpIcon />
</InputGroupButton>
</InputGroupAddon>
</InputGroup>
</div>
);
}<InputGroup>
<InputGroupTextarea placeholder="Type a message" rows={2} />
<InputGroupAddon align="block-end" className="justify-end">
<InputGroupButton size="icon-sm" variant="default">
<ArrowUpIcon />
</InputGroupButton>
</InputGroupAddon>
</InputGroup>Block start
align="block-start" stacks content above the control — useful for a compact inline label.
"use client";
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
InputGroupText,
} from "@/components/ui/input-group";
export function InputGroupBlockStart() {
return (
<div className="w-full max-w-md">
<InputGroup>
<InputGroupAddon align="block-start">
<InputGroupText>Subject</InputGroupText>
</InputGroupAddon>
<InputGroupInput placeholder="Enter a subject" />
</InputGroup>
</div>
);
}<InputGroup>
<InputGroupAddon align="block-start">
<InputGroupText>Subject</InputGroupText>
</InputGroupAddon>
<InputGroupInput placeholder="Enter a subject" />
</InputGroup>Textarea
Swap InputGroupInput for InputGroupTextarea to keep the same shell around a multi-line control.
"use client";
import {
InputGroup,
InputGroupAddon,
InputGroupText,
InputGroupTextarea,
} from "@/components/ui/input-group";
export function InputGroupTextareaDemo() {
return (
<div className="w-full max-w-md">
<InputGroup>
<InputGroupAddon align="block-start">
<InputGroupText>Message</InputGroupText>
</InputGroupAddon>
<InputGroupTextarea placeholder="Write a reply..." rows={3} />
</InputGroup>
</div>
);
}<InputGroup>
<InputGroupAddon align="block-start">
<InputGroupText>Message</InputGroupText>
</InputGroupAddon>
<InputGroupTextarea placeholder="Write a reply..." rows={3} />
</InputGroup>Keyboard hint
Any element inside InputGroupAddon works — here a kbd shortcut hint on the trailing edge.
"use client";
import { Search } from "lucide-react";
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
} from "@/components/ui/input-group";
export function InputGroupKbd() {
return (
<div className="max-w-sm">
<InputGroup>
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput placeholder="Search..." />
<InputGroupAddon align="inline-end">
<kbd>Ctrl K</kbd>
</InputGroupAddon>
</InputGroup>
</div>
);
}<InputGroup>
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput placeholder="Search..." />
<InputGroupAddon align="inline-end">
<kbd>Ctrl K</kbd>
</InputGroupAddon>
</InputGroup>Disabled
Set data-disabled="true" on the group, or disabled on the control, to fade the inline text and make the controls non-interactive.
"use client";
import { Search } from "lucide-react";
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
} from "@/components/ui/input-group";
export function InputGroupDisabled() {
return (
<div className="max-w-sm">
<InputGroup data-disabled="true">
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput disabled placeholder="Disabled" />
</InputGroup>
</div>
);
}<InputGroup data-disabled="true">
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput placeholder="Disabled" disabled />
</InputGroup>Invalid
Set aria-invalid on the control to trigger the destructive border and ring on the group.
"use client";
import { Search } from "lucide-react";
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
} from "@/components/ui/input-group";
export function InputGroupInvalid() {
return (
<div className="max-w-sm">
<InputGroup>
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput
aria-invalid
defaultValue="Not found"
placeholder="Invalid"
/>
</InputGroup>
</div>
);
}<InputGroup>
<InputGroupAddon>
<Search />
</InputGroupAddon>
<InputGroupInput
placeholder="Invalid"
aria-invalid
defaultValue="Not found"
/>
</InputGroup>In Context
Search with icon
import { SearchIcon } from "lucide-react";
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
} from "@/components/ui/input-group";
export function InputGroupSearch() {
return (
<InputGroup className="mx-auto w-full max-w-sm">
<InputGroupAddon>
<SearchIcon />
</InputGroupAddon>
<InputGroupInput placeholder="Search…" />
</InputGroup>
);
}API Reference
InputGroup
Extends React.ComponentProps<"div">. Wraps a single input or textarea with the shared border, ring, and background shell.
InputGroupText
Extends React.ComponentProps<"span">. Static text inside an addon.
InputGroupAddon
| Prop | Type | Default | Description |
|---|---|---|---|
align | "inline-start""inline-end""block-start""block-end" | — | Position of the addon inside the group. |
InputGroupButton
Extends Frakment Button. Accepts all button props (variant, size, disabled, href, …). Additional compact sizes:
| Prop | Type | Default | Description |
|---|---|---|---|
size xs | "xs" | — | 6×24px — default for InputGroupButton. |
size icon-xs | "icon-xs" | — | 6×6px icon-only. |
size icon-sm | "icon-sm" | — | 8×8px icon-only. |
InputGroupInput / InputGroupTextarea
Extend native input / textarea props. Borders, ring, and background are stripped so the group provides the visual shell.
CSS Variables
| Variable | Default | Purpose |
|---|---|---|
--radius | theme default | Corner radius of the wrapper |
Data Attributes
| Attribute | Values |
|---|---|
data-slot | input-group, input-group-addon, input-group-button, input-group-text |
data-align | inline-start | inline-end | block-start | block-end |
data-disabled | true |
Accessibility
InputGroupwraps a single input or textarea. Do not nest multiple controls.- Addons are decorative; use
aria-labelon icon-only addons. - The focus ring applies to the group, not the inner input.
Best Practices
- One input per group. Multiple inputs need multiple groups.
- Addons align end or start. Never both around the input.
- Label the input inside. Addons are not labels.
- Keep addons visual. A button inside an addon is a full Button.
Related Components
- Input — plain input
- Field — label + description
- Button Group — grouped buttons
On This Page
InstallationUsageCompositionExamplesBlock endBlock startTextareaKeyboard hintDisabledInvalidIn ContextSearch with iconAPI ReferenceInputGroupInputGroupTextInputGroupAddonInputGroupButtonInputGroupInput / InputGroupTextareaCSS VariablesData AttributesAccessibilityBest PracticesRelated Components