Delta Components

Docs

Tags Input

A flexible tag input component with multiple trigger keys, variants, and Zod validation support.

Preview

Code

Overview

The Tags Input component enables efficient collection and management of multiple text values with an intuitive tagging interface, essential for categorization, keyword entry, and multi-value form fields. It supports various trigger keys (Enter, Space, Comma), configurable limits, and both default and pill variants with comprehensive validation. Perfect for skill tags, categories, search filters, and any scenario requiring organized multi-value input with excellent user experience.

Installation

pnpm dlx shadcn@latest add https://deltacomponents.dev/r/tags-input.json

Usage

"use client"
 
import { TagsInput } from "@/registry/inputs/tags-input"
 
export function Component() {
  return (
    <TagsInput
      label="Skills"
      name="skills"
      description="Add your technical skills"
      triggerKey="Enter"
      maxTags={10}
      onChange={(tags) => console.log("Tags:", tags)}
    />
  )
}

API Reference

Props

Prop	Type	Default	Description
`label`	`string`	-	Label text for the input (required)
`name`	`string`	-	Form field name for submission (required)
`description`	`string`	`undefined`	Description text below the label
`hint`	`string`	`undefined`	Hint text below the input
`error`	`string`	`undefined`	Error message to display
`required`	`boolean`	`false`	Whether the field is required
`pending`	`boolean`	`false`	Whether the field is in a loading state
`defaultValue`	`string[]`	`[]`	Default tags array (uncontrolled)
`value`	`string[]`	`undefined`	Controlled tags array
`disabled`	`boolean`	`false`	Whether the input is disabled
`id`	`string`	`name`	ID for the input element
`variant`	`"default" \| "pill"`	`"default"`	Input styling variant
`coloredBorder`	`boolean`	`false`	Show colored border (pill variant only)
`labelVariant`	`"default" \| "muted"`	`"default"`	Label text styling variant
`containerClassName`	`string`	`""`	CSS classes for the container
`labelClassName`	`string`	`""`	CSS classes for the label
`triggerKey`	`"Enter" \| "Space" \| "Comma"`	`"Enter"`	Key that triggers tag addition
`maxTags`	`number`	`undefined`	Maximum number of tags allowed
`schema`	`ZodType<string[]>`	`undefined`	Zod schema for validation
`onValidate`	`(isValid: boolean, value: string[], error?: string) => void`	`undefined`	Validation callback
`onChange`	`(tags: string[]) => void`	`undefined`	Callback when tags change