Skip to main content

Starwind UI v3.0 is now available! Migration guide

Installation

Usage

---
import { Input } from "@/components/starwind/input";
---
<Input placeholder="Type something..." />

Sizes

Disabled

Input Types

API Reference

Styled Component API

These props are added or materially changed by the installed styled component. Standard HTML attributes remain available through the inherited interfaces noted below. Expand a prop to see named type definitions and framework-specific imports. Follow the Primitive and Runtime links for lower-level behavior props.

Input

Inherits input attributes. Omits `children`, `defaultValue`, `size`, and `value`.

Contains the following additional props:

Prop Type Default Toggle details
defaultValue string | number | string[]
Description
Sets the initial value when the component is uncontrolled.
Classification
Primitive override
Type imports
React import type { InputValue } from "@starwind-ui/react";
Primitive prop
input.Root.defaultValue
size "sm" | "md" | "lg" "md"
Description
Selects the component's visual size.
Classification
Styled variant
value string | number | string[]
Description
Controls or identifies the component value.
Classification
Primitive override
Type imports
React import type { InputValue } from "@starwind-ui/react";
Primitive prop
input.Root.value

Primitive And Runtime API

Use these references when you need the lower-level behavior APIs behind Input.

Primitive API

Runtime API

Input primitive
createInput from @starwind-ui/runtime/input

Changelog

View version history v2.0.1 8 releases

v2.0.1

  • Updated React Runtime state synchronization so canceled proposals stay uncommitted and accepted changes remain aligned.

v2.0.0

  • Rebuilt Input on Starwind Runtime for value synchronization while retaining native input attributes.
  • See the Input Primitive for the underlying unstyled anatomy and behavior API.

v1.3.3

  • Refactor tailwind variants functions into separate variants.ts file

v1.3.1

  • add aria-invalid styling

v1.3.0

  • style and focus state updates

v1.2.0

  • Add data-slot attribute to enable global styling updates

v1.1.1

  • Add eslint disable comment for allowing the label to not have an associated control (this is user responsibility)
  • Adjust component to use type VariantProps from tailwind-variants. This provides greater type safety and cleans up component frontmatter.

v1.1.0

  • tailwind-variants now implemented. This uses tailwind-merge under the hood to merge Tailwind classes without style conflicts, allowing you to override any existing classes using the “class” prop.