Text Field
Champ de texte avec libelle regroupant description et message d'erreur. Installez Text Field depuis le registre VLLNT UI avec la CLI shadcn.
Champ de texte avec libelle regroupant description et message d'erreur. Fait partie de la famille form dans VLLNT UI, il est publie comme entree de registre lisible par machine — copiez la source directement dans votre application avec la CLI shadcn et possedez-la, sans dependance d'execution a une bibliotheque de composants.
Apercu
Basculez entre clair et sombre pour inspecter l'apercu Storybook integre.
Installation
Ajoutez Text Field a votre projet avec la CLI shadcn. La source arrive dans votre code, prete a etre adaptee :
pnpm dlx shadcn@latest add https://ui.vllnt.ai/r/text-field.jsonSource
"use client";
import * as React from "react";
import { cn } from "../../lib/utils";
import { Input } from "../input/input";
import { Label } from "../label/label";
/** Labelled text input bundling description and error message together. */
export type TextFieldProps = React.ComponentPropsWithoutRef<"input"> & {
description?: React.ReactNode;
error?: React.ReactNode;
label?: React.ReactNode;
labelClassName?: string;
rootClassName?: string;
};
const TextField = ({
className,
description,
error,
id,
label,
labelClassName,
ref,
rootClassName,
...props
}: TextFieldProps & { ref?: React.Ref<HTMLInputElement> }) => {
const generatedId = React.useId();
const inputId = id ?? generatedId;
const descriptionId = `${inputId}-description`;
const errorId = `${inputId}-error`;
const invalid = Boolean(error);
const describedBy =
[description ? descriptionId : null, error ? errorId : null]
.filter(Boolean)
.join(" ") || undefined;
return (
<div className={cn("flex flex-col gap-1.5", rootClassName)}>
{label ? (
<Label
className={cn(invalid && "text-destructive", labelClassName)}
htmlFor={inputId}
>
{label}
</Label>
) : null}
<Input
{...props}
aria-describedby={describedBy}
aria-invalid={invalid || undefined}
className={className}
id={inputId}
ref={ref}
/>
{description ? (
<p className="text-sm text-muted-foreground" id={descriptionId}>
{description}
</p>
) : null}
{error ? (
<p
className="text-sm font-medium text-destructive"
id={errorId}
role="alert"
>
{error}
</p>
) : null}
</div>
);
};
TextField.displayName = "TextField";
export { TextField };
Stories
Explorez chaque variante et etat dans le Storybook interactif :
Apercu
Basculez entre clair et sombre pour inspecter l'apercu Storybook integre.