Элемент
Гибкая строка с полями для мультимедиа, заголовка, описания и действия, предназначенная для лент уведомлений, списков настроек и строк с файлами — в стиле необрутализма.
import { BadgeCheckIcon, ChevronRightIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Item — flex-строка с именованными слотами (media, content, actions) для паттерна «список вещей», к которому приходит каждое приложение. Под капотом нет headless-примитива — только стилизованные элементы (плюс useRender из Base UI для пропа render), доведённые до рецепта необрутализма: 2px-рамка — видимая на варианте outline — и жёсткое смещённое focus ring.
Когда это пригодится:
- Ленты уведомлений и активности — аватар, сообщение, время и кнопка dismiss/действия в каждой строке.
- Списки настроек и интеграций — иконка, имя, статус, switch или button на trailing-крае.
- Файловые браузеры и результаты поиска — thumbnail или иконка плюс метаданные; вся строка — ссылка через
render.
Компонент Item — это простой flex-контейнер, который может вместить практически любое содержимое. Используйте его, чтобы показать заголовок, описание и действия. Группируйте его с компонентом ItemGroup, чтобы создать список элементов.
Установка#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/item.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/item.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/item.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/item.json
Скопируйте и вставьте следующий код в свой проект.
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"
import { cn } from "@/lib/utils"
import { Separator } from "@/components/ui/separator"
function ItemGroup({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
role="list"
data-slot="item-group"
className={cn(
"group/item-group flex w-full flex-col gap-4 has-data-[size=sm]:gap-2.5 has-data-[size=xs]:gap-2",
className
)}
{...props}
/>
)
}
function ItemSeparator({
className,
...props
}: React.ComponentProps<typeof Separator>) {
return (
<Separator
data-slot="item-separator"
orientation="horizontal"
className={cn("my-2", className)}
{...props}
/>
)
}
const itemVariants = cva(
"group/item flex w-full flex-wrap items-center rounded border-2 text-sm transition-colors duration-100 outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary [a]:transition-colors [a]:hover:bg-accent",
{
variants: {
variant: {
default: "border-transparent",
outline: "border-border",
muted: "border-transparent bg-muted/50",
},
size: {
default: "gap-2.5 px-3 py-2.5",
sm: "gap-2.5 px-3 py-2.5",
xs: "gap-2 px-2.5 py-2 in-data-[slot=dropdown-menu-content]:p-0",
},
},
defaultVariants: {
variant: "default",
size: "default",
},
}
)
function Item({
className,
variant = "default",
size = "default",
asChild = false,
...props
}: React.ComponentProps<"div"> &
VariantProps<typeof itemVariants> & { asChild?: boolean }) {
const Comp = asChild ? Slot.Root : "div"
return (
<Comp
data-slot="item"
data-variant={variant}
data-size={size}
className={cn(itemVariants({ variant, size, className }))}
{...props}
/>
)
}
const itemMediaVariants = cva(
"flex shrink-0 items-center justify-center gap-2 group-has-data-[slot=item-description]/item:translate-y-0.5 group-has-data-[slot=item-description]/item:self-start [&_svg]:pointer-events-none",
{
variants: {
variant: {
default: "bg-transparent",
icon: "[&_svg:not([class*='size-'])]:size-4",
image:
"size-10 overflow-hidden rounded-sm group-data-[size=sm]/item:size-8 group-data-[size=xs]/item:size-6 [&_img]:size-full [&_img]:object-cover",
},
},
defaultVariants: {
variant: "default",
},
}
)
function ItemMedia({
className,
variant = "default",
...props
}: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>) {
return (
<div
data-slot="item-media"
data-variant={variant}
className={cn(itemMediaVariants({ variant, className }))}
{...props}
/>
)
}
function ItemContent({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="item-content"
className={cn(
"flex flex-1 flex-col gap-1 group-data-[size=xs]/item:gap-0 [&+[data-slot=item-content]]:flex-none",
className
)}
{...props}
/>
)
}
function ItemTitle({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="item-title"
className={cn(
"line-clamp-1 flex w-fit items-center gap-2 text-sm leading-snug font-medium underline-offset-4",
className
)}
{...props}
/>
)
}
function ItemDescription({ className, ...props }: React.ComponentProps<"p">) {
return (
<p
data-slot="item-description"
className={cn(
"line-clamp-2 text-left text-sm leading-normal font-normal text-muted-foreground group-data-[size=xs]/item:text-xs [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary",
className
)}
{...props}
/>
)
}
function ItemActions({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="item-actions"
className={cn("flex items-center gap-2", className)}
{...props}
/>
)
}
function ItemHeader({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="item-header"
className={cn(
"flex basis-full items-center justify-between gap-2",
className
)}
{...props}
/>
)
}
function ItemFooter({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="item-footer"
className={cn(
"flex basis-full items-center justify-between gap-2",
className
)}
{...props}
/>
)
}
export {
Item,
ItemMedia,
ItemContent,
ItemActions,
ItemGroup,
ItemSeparator,
ItemTitle,
ItemDescription,
ItemHeader,
ItemFooter,
}
Обновите пути импорта в соответствии с настройками вашего проекта.
Использование#
import {
Item,
ItemActions,
ItemContent,
ItemDescription,
ItemMedia,
ItemTitle,
} from "@/components/ui/item"<Item>
<ItemMedia variant="icon">
<Icon />
</ItemMedia>
<ItemContent>
<ItemTitle>Title</ItemTitle>
<ItemDescription>Description</ItemDescription>
</ItemContent>
<ItemActions>
<Button>Action</Button>
</ItemActions>
</Item>Композиция#
Используйте следующую композицию, чтобы собрать Item:
ItemGroup
└── Item
├── ItemHeader
├── ItemMedia
├── ItemContent
│ ├── ItemTitle
│ └── ItemDescription
├── ItemActions
└── ItemFooterItem vs Field#
Используйте Field, если нужно показать элемент формы — например, чекбокс, поле ввода, радиокнопку или select.
Если нужно показать только содержимое — заголовок, описание и действия — используйте Item.
Variant#
Используйте проп variant, чтобы изменить визуальный стиль элемента.
import { InboxIcon } from "lucide-react"
import {Size#
Используйте проп size, чтобы изменить размер элемента. Доступные размеры — default, sm и xs.
import { InboxIcon } from "lucide-react"
import {Примеры#
Иконка#
Используйте ItemMedia с variant="icon", чтобы показать иконку.
import { ShieldAlertIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Avatar#
Вы можете использовать ItemMedia с variant="avatar", чтобы показать аватар.
import { Plus } from "lucide-react"
import {Изображение#
Используйте ItemMedia с variant="image", чтобы показать изображение.
import Image from "next/image"
import {Группа#
Используйте ItemGroup, чтобы сгруппировать связанные элементы.
import * as React from "react"
import { PlusIcon } from "lucide-react"
Заголовок#
Используйте ItemHeader, чтобы добавить заголовок над содержимым элемента.
import Image from "next/image"
import {Ссылка#
Используйте проп render, чтобы отрендерить элемент как ссылку. Состояния hover и focus будут применены к элементу-якорю.
import { ChevronRightIcon, ExternalLinkIcon } from "lucide-react"
import {<Item render={<a href="/dashboard" />}>
<ItemMedia variant="icon">
<HomeIcon />
</ItemMedia>
<ItemContent>
<ItemTitle>Dashboard</ItemTitle>
<ItemDescription>Overview of your account and activity.</ItemDescription>
</ItemContent>
</Item>Dropdown#
"use client"
import { ChevronDownIcon } from "lucide-react"RTL#
Чтобы включить поддержку RTL в Neobrutalism, см. руководство по настройке RTL.
"use client"
import * as React from "react"Доступность#
Item — презентационный: стилизованные элементы без собственной ARIA-обвязки, хотя ItemGroup рендерит role="list" (добавьте role="listitem" каждому Item, если структуру списка нужно объявлять). Для интерактивных строк не вешайте click-handler на div — рендерите настоящий <a> или <button> через проп render, чтобы получить нативный фокус и клавиатуру; видимое focus ring уже стилизовано. Декоративные icon media пометьте aria-hidden, а image media дайте осмысленный alt.
Справочник API#
Item#
Основной компонент для отображения содержимого с медиа, заголовком, описанием и действиями.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "muted" | "default" |
size | "default" | "sm" | "xs" | "default" |
render | React.ReactElement |
ItemGroup#
Контейнер, который группирует связанные элементы с единообразным стилем.
<ItemGroup>
<Item />
<Item />
</ItemGroup>ItemSeparator#
Разделитель между элементами в группе.
<ItemGroup>
<Item />
<ItemSeparator />
<Item />
</ItemGroup>ItemMedia#
Используйте ItemMedia, чтобы показать медиа-содержимое — иконки, изображения или аватары.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "icon" | "image" | "default" |
<ItemMedia variant="icon">
<Icon />
</ItemMedia><ItemMedia variant="image">
<img src="..." alt="..." />
</ItemMedia>ItemContent#
Оборачивает заголовок и описание элемента.
<ItemContent>
<ItemTitle>Title</ItemTitle>
<ItemDescription>Description</ItemDescription>
</ItemContent>ItemTitle#
Показывает заголовок элемента.
<ItemTitle>Item Title</ItemTitle>ItemDescription#
Показывает описание элемента.
<ItemDescription>Item description</ItemDescription>ItemActions#
Контейнер для кнопок действий или других интерактивных элементов.
<ItemActions>
<Button>Action</Button>
</ItemActions>ItemHeader#
Показывает заголовок над содержимым элемента.
<Item>
<ItemHeader>Header</ItemHeader>
<ItemContent>...</ItemContent>
</Item>ItemFooter#
Показывает подвал под содержимым элемента.
<Item>
<ItemContent>...</ItemContent>
<ItemFooter>Footer</ItemFooter>
</Item>