Surfacesradix-uiclass-variance-authority
Item
shadcn's Item: a flexible row of media, title, description and actions — plain, outlined or filled, in groups.
Installation
pnpm dlx shadcn@latest add https://glasscn.app/r/item.jsonReact Native (iOS, Android and web through react-native-web) — same parts and props:
pnpm dlx shadcn@latest add https://glasscn.app/r/native-item.jsonOr with the namespace set up: shadcn add @glasscn-app/item
Props
| Prop | Type | Default |
|---|---|---|
| variant (Item) | "default" | "outline" | "muted" | "default" |
| size (Item) | "default" | "sm" | "default" |
| variant (ItemMedia) | "default" | "icon" | "image"icon is a filled tile; image a rounded thumbnail. | "default" |
Parts (shadcn's API): ItemGroup, Item (asChild for a link or button), ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemActions, ItemHeader, ItemFooter, ItemSeparator.
For iOS Settings-style inset lists (icon tiles, values, chevrons, inset hairlines) use GroupedList.
Source
components/glass/item.tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { cn } from "cn"
import { Slot } from "radix-ui"
import { Separator } from "@/components/glass/separator"
/**
* shadcn's Item: a flexible row — media, a title and description, actions. Free-standing
* (`variant="outline"` or `"muted"`) or stacked in an ItemGroup. For iOS Settings-style inset
* lists with icon tiles, values and chevrons use GroupedList; Item is the general-purpose row
* (a file, a person, an integration). `asChild` makes the whole row a link or button.
*/
function ItemGroup({ className, ...props }: React.ComponentProps<"div">) {
return <div role="list" data-slot="item-group" className={cn("group/item-group flex flex-col", className)} {...props} />
}
function ItemSeparator({ className, ...props }: React.ComponentProps<typeof Separator>) {
return <Separator data-slot="item-separator" orientation="horizontal" className={cn("my-0", className)} {...props} />
}
const itemVariants = cva(
"group/item flex flex-wrap items-center rounded-control text-sm transition-colors duration-(--glass-duration) ease-out glass-focus [a&]:hover:bg-fill [button&]:hover:bg-fill [button&]:text-start",
{
variants: {
variant: {
default: "bg-transparent",
outline: "inset-ring inset-ring-glass-border",
muted: "bg-fill",
},
size: {
default: "gap-4 p-[calc(1rem*var(--glass-density))]",
sm: "gap-2.5 px-pad-sm py-[calc(0.75rem*var(--glass-density))]",
},
},
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: "size-8 rounded-control-sm bg-fill [&_svg:not([class*='size-'])]:size-4",
image: "size-10 overflow-hidden rounded-control-sm [&_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 [&+[data-slot=item-content]]:flex-none", className)} {...props} />
}
function ItemTitle({ className, ...props }: React.ComponentProps<"div">) {
return <div data-slot="item-title" className={cn("flex w-fit items-center gap-2 text-sm leading-snug font-medium", className)} {...props} />
}
function ItemDescription({ className, ...props }: React.ComponentProps<"p">) {
return (
<p
data-slot="item-description"
className={cn("line-clamp-2 text-sm leading-normal font-normal text-balance text-muted-foreground [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary-ink", 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 }