# Item

List row with media, title, description and actions on pixel borders.

Source: https://www.ui95.dev/ui/item

## Examples

```tsx
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import {
  Item,
  ItemActions,
  ItemContent,
  ItemDescription,
  ItemGroup,
  ItemMedia,
  ItemSeparator,
  ItemTitle,
} from "@/components/ui/item"
import { DocumentGlyph } from "@/components/ui/pixel-glyphs"

import type { ShowcaseDemo } from "../types"

const VARIANTS = ["default", "outline", "muted"] as const
const SIZES = ["default", "sm", "xs"] as const

export const demo: ShowcaseDemo = {
  span: "wide",
  variants: [
    ...VARIANTS.map((variant) => ({
      label: variant,
      render: () => (
        <Item variant={variant} className="w-full max-w-80">
          <ItemMedia variant="icon">
            <DocumentGlyph />
          </ItemMedia>
          <ItemContent>
            <ItemTitle>Report.txt</ItemTitle>
            <ItemDescription>Updated today</ItemDescription>
          </ItemContent>
          <ItemActions>
            <Button size="sm" variant="outline">Open</Button>
          </ItemActions>
        </Item>
      ),
    })),
    ...SIZES.filter((size) => size !== "default").map((size) => ({
      label: size,
      render: () => (
        <Item variant="outline" size={size} className="w-full max-w-80">
          <ItemContent>
            <ItemTitle>Compact</ItemTitle>
            <ItemDescription>Size {size}</ItemDescription>
          </ItemContent>
          <Badge>new</Badge>
        </Item>
      ),
    })),
    {
      label: "group",
      render: () => (
        <ItemGroup className="w-full max-w-80">
          <Item variant="outline">
            <ItemContent>
              <ItemTitle>One</ItemTitle>
            </ItemContent>
          </Item>
          <ItemSeparator />
          <Item variant="outline">
            <ItemContent>
              <ItemTitle>Two</ItemTitle>
            </ItemContent>
          </Item>
        </ItemGroup>
      ),
    },
  ],
}
```

## Installation

```bash
npx shadcn@latest add https://www.ui95.dev/r/item.json
```

Run it in a Radix shadcn project that already has the UI95 theme.

Dependencies:

```bash
npm install class-variance-authority cn radix-ui
```

Add these items first:

- [separator](https://www.ui95.dev/ui/separator)

`components/ui/item.tsx`

```tsx
import { cva, type VariantProps } from "class-variance-authority"
import { cn } from "cn"
import { Slot } from "radix-ui"
import * as React from "react"

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 pixel-border text-xl leading-tight outline-none [a]:hover:bg-muted",
  {
    variants: {
      variant: {
        default: "border-transparent bg-transparent",
        outline: "border-border bg-card text-card-foreground",
        muted: "border-border bg-muted text-foreground",
      },
      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 pixel-border border-border 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 font-pixel text-sm leading-snug uppercase 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-lg leading-tight text-muted-foreground [&>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,
  ItemActions,
  ItemContent,
  ItemDescription,
  ItemFooter,
  ItemGroup,
  ItemHeader,
  ItemMedia,
  ItemSeparator,
  ItemTitle,
}
```

## API reference

### Item

| Prop | Type | Default |
| --- | --- | --- |
| `variant` | `"default" \| "outline" \| "muted"` | `"default"` |
| `size` | `"sm" \| "default" \| "xs"` | `"default"` |
| `asChild` | `boolean` | `false` |

### ItemActions

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemContent

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemDescription

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemFooter

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemGroup

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemHeader

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemMedia

| Prop | Type | Default |
| --- | --- | --- |
| `variant` | `"image" \| "default" \| "icon"` | `"default"` |

### ItemSeparator

No props of its own. It forwards the props of the element or primitive it wraps.

### ItemTitle

No props of its own. It forwards the props of the element or primitive it wraps.
