Empty

PreviousNext

Displays an empty state with optional illustration, title, and description.

Docs
opticscomponent

Preview

Loading preview…
registry/optics/empty.jsx
import { cva } from "class-variance-authority";

import { cn } from "@/lib/utils"

function Empty({
  className = "",
  ...props
}) {
  return (
    <div
      data-slot="empty"
      className={cn(
        "gap-4 rounded-xl border-dashed p-6 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance",
        className
      )}
      {...props} />
  );
}

function EmptyHeader({
  className = "",
  ...props
}) {
  return (
    <div
      data-slot="empty-header"
      className={cn("gap-1 flex max-w-sm flex-col items-center", className)}
      {...props} />
  );
}

const emptyMediaVariants = cva(
  "mb-2 flex shrink-0 items-center justify-center [&_svg]:pointer-events-none [&_svg]:shrink-0",
  {
    variants: {
      variant: {
        default: "bg-transparent",
        icon: "bg-muted text-foreground flex size-8 shrink-0 items-center justify-center rounded-md [&_svg:not([class*='size-'])]:size-4",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function EmptyMedia({
  className = "",
  variant = "default",
  ...props
}) {
  return (
    <div
      data-slot="empty-icon"
      data-variant={variant}
      className={cn(emptyMediaVariants({ variant, className }))}
      {...props} />
  );
}

function EmptyTitle({
  className = "",
  ...props
}) {
  return (
    <div
      data-slot="empty-title"
      className={cn("text-sm font-medium tracking-tight", className)}
      {...props} />
  );
}

function EmptyDescription({
  className = "",
  ...props
}) {
  return (
    <div
      data-slot="empty-description"
      className={cn(
        "text-xs/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4",
        className
      )}
      {...props} />
  );
}

function EmptyContent({
  className = "",
  ...props
}) {
  return (
    <div
      data-slot="empty-content"
      className={cn(
        "gap-2 text-xs/relaxed flex w-full max-w-sm min-w-0 flex-col items-center text-balance",
        className
      )}
      {...props} />
  );
}

export {
  Empty,
  EmptyHeader,
  EmptyTitle,
  EmptyDescription,
  EmptyContent,
  EmptyMedia,
}

Installation

npx shadcn@latest add @optics/empty

Usage

import { Empty } from "@/components/empty"
<Empty />