import { Search } from "lucide-react"
import {Input Group은 input 또는 textarea를 아이콘, 인라인 텍스트, 버튼, 키보드 힌트 같은 애드온과 하나의 테두리 컨트롤 안에 묶습니다. 이 라이브러리의 Input, Textarea, Button을 조합한 사내 컴포지션이며, 네오브루탈리즘 공식(두꺼운 테두리, 선명한 그림자, 굵은 서체)에 맞춰 스타일을 입혔습니다.
다음과 같은 경우에 사용합니다.
- 검색 필드 — 앞에 검색 아이콘, 뒤에
⌘K힌트나 지우기 버튼. - 접두·접미 입력 —
https://,@,.com처럼 고정 텍스트를 두고 사용자가 변하는 부분만 입력하게 합니다. - 채팅·프롬프트 작성기 —
block-end툴바와 전송 동작이 있는 textarea.
설치#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/input-group.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/input-group.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/input-group.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/input-group.json
다음 코드를 복사해 프로젝트에 붙여넣습니다.
"use client"
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { cn } from "@/lib/utils"
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Textarea } from "@/components/ui/textarea"
function InputGroup({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="input-group"
role="group"
className={cn(
"group/input-group relative flex h-8 w-full min-w-0 items-center rounded border-2 bg-input shadow-sm transition-colors outline-none in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0 has-disabled:bg-input/50 has-disabled:opacity-50 has-[[data-slot=input-group-control]:focus-visible]:outline-2 has-[[data-slot=input-group-control]:focus-visible]:outline-offset-2 has-[[data-slot=input-group-control]:focus-visible]:outline-primary has-[[data-slot][aria-invalid=true]]:border-destructive 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-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
)}
{...props}
/>
)
}
const inputGroupAddonVariants = cva(
"flex h-auto cursor-text items-center justify-center gap-2 py-1.5 text-sm font-medium text-muted-foreground select-none group-data-[disabled=true]/input-group:opacity-50 [&>kbd]:rounded-[calc(var(--radius)-5px)] [&>svg:not([class*='size-'])]:size-4",
{
variants: {
align: {
"inline-start":
"order-first pl-2 has-[>button]:ml-[-0.3rem] has-[>kbd]:ml-[-0.15rem]",
"inline-end":
"order-last pr-2 has-[>button]:mr-[-0.3rem] has-[>kbd]:mr-[-0.15rem]",
"block-start":
"order-first w-full justify-start px-2.5 pt-2 group-has-[>input]/input-group:pt-2 [.border-b]:pb-2",
"block-end":
"order-last w-full justify-start px-2.5 pb-2 group-has-[>input]/input-group:pb-2 [.border-t]:pt-2",
},
},
defaultVariants: {
align: "inline-start",
},
}
)
function InputGroupAddon({
className,
align = "inline-start",
...props
}: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>) {
return (
<div
role="group"
data-slot="input-group-addon"
data-align={align}
className={cn(inputGroupAddonVariants({ align }), className)}
onClick={(e) => {
if ((e.target as HTMLElement).closest("button")) {
return
}
e.currentTarget.parentElement?.querySelector("input")?.focus()
}}
{...props}
/>
)
}
const inputGroupButtonVariants = cva(
"flex items-center gap-2 text-sm shadow-none",
{
variants: {
size: {
xs: "h-6 gap-1 rounded-[calc(var(--radius)-3px)] px-1.5 [&>svg:not([class*='size-'])]:size-3.5",
sm: "",
"icon-xs":
"size-6 rounded-[calc(var(--radius)-3px)] p-0 has-[>svg]:p-0",
"icon-sm": "size-8 p-0 has-[>svg]:p-0",
},
},
defaultVariants: {
size: "xs",
},
}
)
function InputGroupButton({
className,
type = "button",
variant = "ghost",
size = "xs",
...props
}: Omit<React.ComponentProps<typeof Button>, "size"> &
VariantProps<typeof inputGroupButtonVariants>) {
return (
<Button
type={type}
data-size={size}
variant={variant}
className={cn(inputGroupButtonVariants({ size }), className)}
{...props}
/>
)
}
function InputGroupText({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
className={cn(
"flex items-center gap-2 text-sm text-muted-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
/>
)
}
function InputGroupInput({
className,
...props
}: React.ComponentProps<"input">) {
return (
<Input
data-slot="input-group-control"
className={cn(
"flex-1 rounded-none border-0 bg-transparent shadow-none outline-none focus-visible:outline-none disabled:bg-transparent aria-invalid:outline-none dark:bg-transparent dark:disabled:bg-transparent",
className
)}
{...props}
/>
)
}
function InputGroupTextarea({
className,
...props
}: React.ComponentProps<"textarea">) {
return (
<Textarea
data-slot="input-group-control"
className={cn(
"flex-1 resize-none rounded-none border-0 bg-transparent py-2 shadow-none outline-none focus-visible:outline-none disabled:bg-transparent aria-invalid:outline-none dark:bg-transparent dark:disabled:bg-transparent",
className
)}
{...props}
/>
)
}
export {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupText,
InputGroupInput,
InputGroupTextarea,
}
임포트 경로를 프로젝트 구성에 맞게 수정합니다.
사용법#
import {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupInput,
InputGroupText,
InputGroupTextarea,
} from "@/components/ui/input-group"<InputGroup>
<InputGroupInput placeholder="Search..." />
<InputGroupAddon>
<SearchIcon />
</InputGroupAddon>
</InputGroup>구성#
InputGroup 을 구축하려면 다음 구성을 사용합니다.
InputGroup
├── InputGroupInput or InputGroupTextarea
├── InputGroupAddon
├── InputGroupButton
└── InputGroupText배치#
InputGroupAddon 의 align prop 을 사용해 애드온을 입력에 상대적으로 배치합니다.
포커스를 적절히 관리하려면 InputGroupAddon 은 DOM에서 항상
InputGroupInput 또는 InputGroupTextarea 뒤에 배치해야 합니다.
애드온을 시각적으로 배치하려면 align prop 을 사용합니다.
inline-start#
align="inline-start" 를 사용해 애드온을 입력의 시작 부분에 배치합니다. 이것이 기본값입니다.
import { SearchIcon } from "lucide-react"
import {inline-end#
align="inline-end" 를 사용해 애드온을 입력의 끝부분에 배치합니다.
import { EyeOffIcon } from "lucide-react"
import {block-start#
align="block-start" 를 사용해 애드온을 입력 위에 배치합니다.
import { CopyIcon, FileCodeIcon } from "lucide-react"
import {block-end#
align="block-end" 를 사용해 애드온을 입력 아래에 배치합니다.
import {
Field,
FieldDescription,예제#
아이콘#
import {
CheckIcon,
CreditCardIcon,텍스트#
import {
InputGroup,
InputGroupAddon,버튼#
"use client"
import * as React from "react"Kbd#
import { SearchIcon } from "lucide-react"
import {드롭다운#
"use client"
import { ChevronDownIcon, MoreHorizontal } from "lucide-react"Spinner#
import { LoaderIcon } from "lucide-react"
import {Textarea#
import {
IconBrandJavascript,
IconCopy,커스텀 입력#
포커스 상태를 자동으로 처리하려면 커스텀 입력에 data-slot="input-group-control" 속성을 추가합니다.
서드파티 라이브러리의 커스텀 크기 조정 가능한 텍스트영역 예제입니다.
"use client"
import TextareaAutosize from "react-textarea-autosize"RTL#
Neobrutalism에서 RTL 지원을 활성화하는 방법은 RTL 설정 가이드를 참고하세요.
"use client"
import * as React from "react"접근성#
input group용 ARIA 위젯 패턴은 없습니다. 래퍼는 role="group"을 렌더링해 보조 기술이 애드온을 컨트롤과 연결하게 하고, 키보드는 네이티브입니다. Tab이 DOM 순서로 input과 모든 InputGroupButton에 도달하므로, 애드온은 input 뒤에 두고 시각 위치만 align으로 잡습니다. 두 가지는 직접 챙겨야 합니다. https:// 같은 애드온 텍스트는 시각용이지 프로그래밍 레이블이 아니므로 input에 여전히 <Label> 또는 aria-label이 필요하고, 아이콘만 있는 버튼에는 aria-label이 필요합니다. 애드온 클릭이 input에 포커스하는 것은 포인터 편의이며 키보드 경로가 아닙니다.
API 참조#
InputGroup#
입력과 애드온을 감싸는 메인 컴포넌트입니다.
| Prop | Type | Default |
|---|---|---|
className | string |
<InputGroup>
<InputGroupInput />
<InputGroupAddon />
</InputGroup>InputGroupAddon#
아이콘, 텍스트, 버튼, 기타 콘텐츠를 입력과 나란히 표시합니다.
포커스 내비게이션을 적절히 처리하려면 InputGroupAddon
컴포넌트는 입력 뒤에 배치해야 합니다. 애드온을 배치하려면 align
prop 을 설정합니다.
| Prop | Type | Default |
|---|---|---|
align | "inline-start" | "inline-end" | "block-start" | "block-end" | "inline-start" |
className | string |
<InputGroupAddon align="inline-end">
<SearchIcon />
</InputGroupAddon><InputGroupInput /> 에는 inline-start 또는 inline-end 배치를 사용합니다. <InputGroupTextarea /> 에는 block-start 또는 block-end 배치를 사용합니다.
InputGroupAddon 컴포넌트에는 여러 개의 InputGroupButton 컴포넌트와 아이콘을 포함할 수 있습니다.
<InputGroupAddon>
<InputGroupButton>Button</InputGroupButton>
<InputGroupButton>Button</InputGroupButton>
</InputGroupAddon>InputGroupButton#
입력 그룹 안에 버튼을 표시합니다.
| Prop | Type | Default |
|---|---|---|
size | "xs" | "icon-xs" | "sm" | "icon-sm" | "xs" |
variant | "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | "ghost" |
className | string |
<InputGroupButton>Button</InputGroupButton>
<InputGroupButton size="icon-xs" aria-label="Copy">
<CopyIcon />
</InputGroupButton>InputGroupInput#
입력 그룹을 구축할 때 <Input /> 을 대체하는 컴포넌트입니다. 이 컴포넌트에는 입력 그룹 스타일이 미리 적용되어 있으며, 포커스 상태 처리에는 통일된 data-slot="input-group-control" 을 사용합니다.
| Prop | Type | Default |
|---|---|---|
className | string |
그 외 모든 prop 은 내부의 <Input /> 컴포넌트로 그대로 전달됩니다.
<InputGroup>
<InputGroupInput placeholder="Enter text..." />
<InputGroupAddon>
<SearchIcon />
</InputGroupAddon>
</InputGroup>InputGroupTextarea#
입력 그룹을 구축할 때 <Textarea /> 를 대체하는 컴포넌트입니다. 이 컴포넌트에는 텍스트영역 그룹 스타일이 미리 적용되어 있으며, 포커스 상태 처리에는 통일된 data-slot="input-group-control" 을 사용합니다.
| Prop | Type | Default |
|---|---|---|
className | string |
그 외 모든 prop 은 내부의 <Textarea /> 컴포넌트로 그대로 전달됩니다.
<InputGroup>
<InputGroupTextarea placeholder="Enter message..." />
<InputGroupAddon align="block-end">
<InputGroupButton>Send</InputGroupButton>
</InputGroupAddon>
</InputGroup>