Element
Elastyczny wiersz z polami na multimedia, tytuł, opis i akcję – przeznaczony do kanałów powiadomień, list ustawień i wierszy plików – w stylu neobrutalistycznym.
import { BadgeCheckIcon, ChevronRightIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Item to wiersz flex z nazwanymi slotami — media, treść, akcje — dla wzorca „listy rzeczy”, do którego prędzej czy później dochodzi każda aplikacja. Pod spodem nie ma bezgłowego prymitywu, tylko ostylowane elementy (plus useRender z Base UI dla propa render), wykończone zgodnie z neobrutalistyczną recepturą: obramowanie 2 px — widoczne w wariancie outline — i twardy, odsunięty pierścień fokusu.
Sięgnij po ten komponent, gdy:
- Kanały powiadomień i aktywności — awatar, wiadomość, znacznik czasu oraz przycisk zamknięcia lub akcji w każdym wierszu.
- Listy ustawień i integracji — ikona, nazwa, wiersz statusu, z przełącznikiem lub przyciskiem na końcowej krawędzi.
- Przeglądarki plików i wyniki wyszukiwania — miniatura lub ikona plus metadane, a cały wiersz jako link dzięki
render.
Komponent Item to prosty kontener flex, który może pomieścić niemal dowolny rodzaj treści. Użyj go, aby wyświetlić tytuł, opis i akcje. Zgrupuj go z komponentem ItemGroup, aby utworzyć listę elementów.
Instalacja#
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
Skopiuj i wklej poniższy kod do swojego projektu.
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,
}
Zaktualizuj ścieżki importu, aby pasowały do konfiguracji twojego projektu.
Użycie#
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>Kompozycja#
Użyj poniższej kompozycji, aby zbudować Item:
ItemGroup
└── Item
├── ItemHeader
├── ItemMedia
├── ItemContent
│ ├── ItemTitle
│ └── ItemDescription
├── ItemActions
└── ItemFooterItem vs Field#
Użyj Field, jeśli musisz wyświetlić pole formularza, takie jak checkbox, input, radio lub select.
Jeśli musisz wyświetlić tylko treść, taką jak tytuł, opis i akcje, użyj Item.
Variant#
Użyj propa variant, aby zmienić styl wizualny elementu.
import { InboxIcon } from "lucide-react"
import {Size#
Użyj propa size, aby zmienić rozmiar elementu. Dostępne rozmiary to default, sm i xs.
import { InboxIcon } from "lucide-react"
import {Przykłady#
Ikona#
Użyj ItemMedia z variant="icon", aby wyświetlić ikonę.
import { ShieldAlertIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Avatar#
Możesz użyć ItemMedia z variant="avatar", aby wyświetlić awatar.
import { Plus } from "lucide-react"
import {Obraz#
Użyj ItemMedia z variant="image", aby wyświetlić obraz.
import Image from "next/image"
import {Grupa#
Użyj ItemGroup, aby zgrupować powiązane elementy.
import * as React from "react"
import { PlusIcon } from "lucide-react"
Nagłówek#
Użyj ItemHeader, aby dodać nagłówek nad treścią elementu.
import Image from "next/image"
import {Link#
Użyj propa render, aby wyrenderować element jako link. Stany hover i focus zostaną zastosowane do elementu anchor.
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#
Aby włączyć obsługę RTL w Neobrutalism, zobacz przewodnik konfiguracji RTL.
"use client"
import * as React from "react"Dostępność#
Item jest prezentacyjny — ostylowane elementy bez własnego okablowania ARIA, choć ItemGroup renderuje role="list" (dodaj role="listitem" każdemu Item, jeśli struktura listy ma być ogłaszana). W interaktywnych wierszach nie wieszaj obsługi kliknięcia na divie — wyrenderuj prawdziwy element <a> lub <button> przez prop render, aby dostał natywny fokus i zachowania klawiaturowe; widoczny pierścień fokusu jest już ostylowany. Dekoracyjne ikony w slocie mediów oznaczaj aria-hidden, a mediom graficznym nadawaj sensowny tekst alt.
Referencja API#
Item#
Główny komponent do wyświetlania treści z mediami, tytułem, opisem i akcjami.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "muted" | "default" |
size | "default" | "sm" | "xs" | "default" |
render | React.ReactElement |
ItemGroup#
Kontener, który grupuje powiązane elementy ze spójnym stylem.
<ItemGroup>
<Item />
<Item />
</ItemGroup>ItemSeparator#
Separator między elementami w grupie.
<ItemGroup>
<Item />
<ItemSeparator />
<Item />
</ItemGroup>ItemMedia#
Użyj ItemMedia, aby wyświetlić treści multimedialne, takie jak ikony, obrazy lub awatary.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "icon" | "image" | "default" |
<ItemMedia variant="icon">
<Icon />
</ItemMedia><ItemMedia variant="image">
<img src="..." alt="..." />
</ItemMedia>ItemContent#
Otacza tytuł i opis elementu.
<ItemContent>
<ItemTitle>Title</ItemTitle>
<ItemDescription>Description</ItemDescription>
</ItemContent>ItemTitle#
Wyświetla tytuł elementu.
<ItemTitle>Item Title</ItemTitle>ItemDescription#
Wyświetla opis elementu.
<ItemDescription>Item description</ItemDescription>ItemActions#
Kontener na przyciski akcji lub inne elementy interaktywne.
<ItemActions>
<Button>Action</Button>
</ItemActions>ItemHeader#
Wyświetla nagłówek nad treścią elementu.
<Item>
<ItemHeader>Header</ItemHeader>
<ItemContent>...</ItemContent>
</Item>ItemFooter#
Wyświetla stopkę pod treścią elementu.
<Item>
<ItemContent>...</ItemContent>
<ItemFooter>Footer</ItemFooter>
</Item>