Skip to the content

Controls and surfaces

label

The text name of a control. Clicking it focuses or toggles the control it points to.

Choices

When to use it

Every control needs one. Point it at a control with htmlFor, or wrap a checkbox, radio or switch in it so the whole row is the hit area. Inside field, use FieldLabel, which wires htmlFor for you.

See it working

The demonstration the browser checks drive, with the keyboard as well as the pointer. More of it is on the Choices page.

Chips: filters and suggestions

Under 50This weekendOutdoors

Asked: nothing yet

Chips: choosing

Mood (several)

Chosen: calm

Time of day (one, uncontrolled)

Segmented control

View: list

Number stepper

Nights: 2

Tiles

What kind of day? (several)

Chosen: quiet

Add it

npx shadcn@latest add @rivier-ui/label

The registry is named once in components.json: see Installation.

Example

Import it from @/components/ui/label.

<Label htmlFor="email">Email</Label>
<Input id="email" type="email" />
<Label><Checkbox /> Remember me</Label>

What it needs

A client component: it uses state, effects or browser behaviour. Packages: radix-ui.

It imports

It is used by

Source

The whole file. Once copied it is yours: the registry item holds the same text.

src/components/ui/label.tsx
"use client";
/**
 * @name label
 * @category ui
 * @description The text name of a control. Clicking it focuses or toggles the control it points to.
 * @when Every control needs one. Point it at a control with htmlFor, or wrap a checkbox, radio or switch in it so the whole row is the hit area. Inside field, use FieldLabel, which wires htmlFor for you.
 * @example
 * <Label htmlFor="email">Email</Label>
 * <Input id="email" type="email" />
 * <Label><Checkbox /> Remember me</Label>
 */
import { Label as LabelPrimitive } from "radix-ui";
import type { ComponentProps } from "react";
import { cn } from "@/lib/cn";

export function Label({ className, ...props }: ComponentProps<typeof LabelPrimitive.Root>) {
  return (
    <LabelPrimitive.Root
      data-slot="label"
      className={cn(
        "flex items-center gap-2 text-sm font-medium leading-tight text-foreground select-none peer-disabled:pointer-events-none peer-disabled:opacity-50 has-disabled:pointer-events-none has-disabled:opacity-50 has-data-disabled:pointer-events-none has-data-disabled:opacity-50",
        className,
      )}
      {...props}
    />
  );
}