COMPONENTS/INPUTS

Label.

A clear name for every field.

In practice

Connect htmlFor to the input id. Placeholder text is not a substitute for a label.

Installation

Install Coal once. Components and TypeScript declarations are included. React 19 and React DOM 19 are peer dependencies.

Terminal · local package
npm install http://localhost:3100/downloads/chlohal-coal-ui-0.5.0.tgz

This installs the local package. It is not yet published on npm. See installation for stylesheet setup and integration.

Usage

example.tsx
"use client";
import * as React from "react";
import "@chlohal/coal-ui/styles.css";
import { Input, Label } from "@chlohal/coal-ui";
export default function Example() {
    const id = React.useId();
    return (<div>
          <Label htmlFor={id}>
            Project name{" "}
            <span>(required)</span>
          </Label>
          <Input id={id} required placeholder="Untitled, for now"/>
        </div>);
}

Source

The original Coal implementation. Use the package export to integrate it.

packages/react/src/label.tsx
import * as React from "react";
import { cn } from "./internal.js";
export type LabelProps = React.ComponentPropsWithRef<"label">;
export function Label({ className, ...props }: LabelProps) {
  return <label className={cn("coal-label", className)} {...props} />;
}

Accessibility checklist

  • Provide an accessible name for controls, including icon-only buttons.
  • Check keyboard navigation, visible focus and disabled states in your application.
  • Do not rely on color alone to communicate status.