Label

Your email address

import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

export default function LabelDemo() {
  return (
    <div className="grid gap-2">
      <Label htmlFor="label-email">Your email address</Label>
      <Input id="label-email" type="email" placeholder="Email" />
    </div>
  )
}

Installation

npx logic2b@next add label

Working with an AI assistant? Copy this prompt into Claude Code, Cursor or Copilot — it carries the install steps, a no-CLI fallback and a verification checklist.

Add the "label" item from the logic2b ui registry (https://ui.logic2b.com) to this project. Follow every step and verify at the end.

## Steps

1. If the project has no `components.json` yet, set up logic2b ui first:

   ```bash
   npx logic2b@next init
   ```

2. Install the item (the CLI resolves registry dependencies automatically):

   ```bash
   npx logic2b@next add label
   ```

3. Install any npm dependencies the command prints.

## If the CLI is not available

Do it manually from the registry payload:

1. Fetch https://ui.logic2b.com/r/label.json.
2. Write every entry in `files[]` to its mapped project path (see below).
3. Repeat (recursively) for each name in `registryDependencies`.
4. Install every package listed in `dependencies` across those payloads.

## Registry reference

- Index of every item: https://ui.logic2b.com/r/index.json
- Item payload (full source): https://ui.logic2b.com/r/<name>.json
- Usage examples per item: https://ui.logic2b.com/r/demos/index.json → https://ui.logic2b.com/r/demos/<demo>.json
- Docs index for agents: https://ui.logic2b.com/llms.txt (full docs: https://ui.logic2b.com/llms-full.txt)
- Every docs page is Markdown when you append `.md` to its URL.

Registry file paths map to project paths like this:
- `ui/*` → `@/components/ui/*`
- `blocks/<name>/*` → `@/components/*`
- `charts/*` → `@/components/charts/*`
- `hooks/*` → `@/hooks/*`
- `lib/utils.ts` → `@/lib/utils.ts`
- `theme.css` → next to the project's Tailwind entry stylesheet

## Conventions (do not break these)

- Tailwind CSS v4 (CSS-first config; no tailwind.config.js needed) and React 19.
- All colors go through semantic tokens (`bg-primary`, `text-muted-foreground`,
  `border-border`, …). Never hardcode hex/oklch values in components.
- Dark mode is class-based: toggle `.dark` on `<html>`.
- Icons come from lucide-react.

## Verify before finishing

1. The dev server starts and the app renders without console errors.
2. TypeScript compiles (`tsc --noEmit` or the framework's check).
3. Components use the theme: a `<Button>` shows the primary token color,
   and toggling `.dark` on `<html>` switches the palette.

Install the dependencies:

npm install radix-ui

Copy into ui/label.tsx:

import * as React from "react"
import { Label as LabelPrimitive } from "radix-ui"

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

function Label({
  className,
  ...props
}: React.ComponentProps<typeof LabelPrimitive.Root>) {
  return (
    <LabelPrimitive.Root
      data-slot="label"
      className={cn(
        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
        className
      )}
      {...props}
    />
  )
}

export { Label }

Usage

import { Label } from "@/components/ui/label"

<Label htmlFor="email">Your email address</Label>

Usage notes

Label forwards every prop to the underlying Radix Label.Root (a native <label>), so all standard label attributes apply.

It also picks up peer-disabled and group-data-[disabled=true] styles automatically when placed next to a disabled control.

Examples

With a checkbox

Accept terms and conditions

import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"

export default function LabelCheckboxDemo() {
  return (
    <Label
      htmlFor="label-terms"
      className="flex items-center gap-3 rounded-md border p-3"
    >
      <Checkbox id="label-terms" defaultChecked />
      Accept terms and conditions
    </Label>
  )
}

Required field

Full name(required)

import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

export default function LabelRequiredDemo() {
  return (
    <div className="grid gap-2">
      <Label htmlFor="label-name">
        Full name
        <span className="text-muted-foreground font-normal">(required)</span>
      </Label>
      <Input id="label-name" placeholder="Ada Lovelace" required />
    </div>
  )
}

Live playground

Edit the component props and inspect the exact JSX before copying it. The preview loads only when this section enters the viewport.

Generated JSX

<Label
  htmlFor="workspace-name"
>
  <span>Workspace</span>
  <input
    type="text"
    defaultValue="logic2b"
    className="h-9 rounded-md border bg-background px-3 text-sm"
    id="workspace-name"
   />
</Label>

API reference

Generated from the public TypeScript exports in src/ui/label.tsx.

View JSON

Component

Props: React.ComponentProps<typeof LabelPrimitive.Root>

Accessibility contract

Machine-readable behavior and consumer responsibilities for label.

View JSON

Support: Native semantics
Pattern: form label; HTMLLabelElement

Built-in semantics

Uses native label semantics and forwards htmlFor to its labelled control.

Consumer responsibilities

Point htmlFor at exactly one labelable control and keep the label text visible.