import { Search } from "lucide-react"
import {输入组把输入框或文本域与附加件——图标、行内文字、按钮、快捷键提示——包进同一个带边框的控件。它是对本库 Input、Textarea 与 Button 的内部组合,并按新粗野主义的配方设计:粗边框、硬阴影、加粗字体。
适合以下场景:
- 搜索框——前导搜索图标,加上尾部的
⌘K提示或清除按钮。 - 带前缀 / 后缀的输入——固定的
https://、@或.com文字,让用户只输入可变部分。 - 聊天与提示词编辑器——文本域底部(
block-end)放一排工具按钮与发送操作。
安装#
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 属性,将插件元素相对于输入框进行定位。
为了正确管理焦点,InputGroupAddon 在 DOM 中应始终放置在
InputGroupInput 或 InputGroupTextarea 之后。使用 align
属性来对插件元素进行视觉定位。
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" 属性,即可自动处理焦点状态。
以下是一个来自第三方库的可调整大小的自定义 textarea 示例。
"use client"
import TextareaAutosize from "react-textarea-autosize"RTL#
若要在 Neobrutalism 中启用 RTL 支持,请参阅 RTL 配置指南。
"use client"
import * as React from "react"无障碍#
输入组没有对应的 ARIA 小组件模式——包装层渲染 role="group",以便辅助技术把附加件与控件关联起来;键盘访问则走原生路径:Tab 按 DOM 顺序到达输入框和任意 InputGroupButton,因此附加件应放在输入框之后(用 align 做视觉定位)。还有两点需要您自行处理:像 https:// 这样的附加文字只是视觉提示,不是程序化标签,输入框仍需要 <Label> 或 aria-label;纯图标按钮需要 aria-label——点击附加件会聚焦输入框,但这只是指针便捷操作,不是键盘路径。
API 参考#
InputGroup#
包裹输入控件和插件元素的主组件。
| Prop | Type | Default |
|---|---|---|
className | string |
<InputGroup>
<InputGroupInput />
<InputGroupAddon />
</InputGroup>InputGroupAddon#
在输入框旁边显示图标、文本、按钮或其他内容。
为了实现正确的焦点导航,InputGroupAddon
组件应放置在输入框之后。设置 align
属性来对插件元素进行定位。
| 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 |
其余所有属性都会透传给底层的 <Input /> 组件。
<InputGroup>
<InputGroupInput placeholder="Enter text..." />
<InputGroupAddon>
<SearchIcon />
</InputGroupAddon>
</InputGroup>InputGroupTextarea#
构建输入组时用于替代 <Textarea /> 的组件。该组件已预先应用 textarea 组样式,并使用统一的 data-slot="input-group-control" 来处理焦点状态。
| Prop | Type | Default |
|---|---|---|
className | string |
其余所有属性都会透传给底层的 <Textarea /> 组件。
<InputGroup>
<InputGroupTextarea placeholder="Enter message..." />
<InputGroupAddon align="block-end">
<InputGroupButton>Send</InputGroupButton>
</InputGroupAddon>
</InputGroup>