For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
FrakmentFrakment

Input Group

A composable input wrapper with inline addons, buttons, and text groups.

Web
Frakment
https://
input-group.tsx
"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

Usage

input-group.tsx
import {
  InputGroup,
  InputGroupAddon,
  InputGroupButton,
  InputGroupInput,
  InputGroupText,
  InputGroupTextarea,
} from "@/components/ui/input-group";
input-group.tsx
<InputGroup>
  <InputGroupAddon>
    <Search />
  </InputGroupAddon>
  <InputGroupInput placeholder="Search..." />
</InputGroup>

Composition

InputGroup
├── InputGroupInput
├── InputGroupTextarea
├── InputGroupAddon
├── InputGroupButton
└── InputGroupText

Examples

Block end

align="block-end" stacks content below the control and lets the group grow taller automatically.

input-group-block-end.tsx
"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>
  );
}
tsx
<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.

Subject
input-group-block-start.tsx
"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>
  );
}
tsx
<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.

Message
input-group-textarea.tsx
"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>
  );
}
tsx
<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.

Ctrl K
input-group-kbd.tsx
"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>
  );
}
tsx
<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.

input-group-disabled.tsx
"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>
  );
}
tsx
<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.

input-group-invalid.tsx
"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>
  );
}
tsx
<InputGroup>
  <InputGroupAddon>
    <Search />
  </InputGroupAddon>
  <InputGroupInput
    placeholder="Invalid"
    aria-invalid
    defaultValue="Not found"
  />
</InputGroup>

In Context

Search with icon

input-group-search.tsx
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

PropTypeDefaultDescription
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:

PropTypeDefaultDescription
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

VariableDefaultPurpose
--radiustheme defaultCorner radius of the wrapper

Data Attributes

AttributeValues
data-slotinput-group, input-group-addon, input-group-button, input-group-text
data-aligninline-start | inline-end | block-start | block-end
data-disabledtrue

Accessibility

  • InputGroup wraps a single input or textarea. Do not nest multiple controls.
  • Addons are decorative; use aria-label on 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.