Input

Displays a form input field or a component that looks like an input field.

Enter your email address.

Installation

CLI

Install the component using the StarUI CLI:

star add input

Examples

With Icon

Inputs with leading icons using absolute positioning

With Button

Combine an input with an action button

Reactive Validation

Real-time input validation using signals and regex

Must be at least 3 characters, letters/numbers/underscores only

Username is available

States

Disabled, read-only, and required inputs

This field is required

File Upload

Custom file input with a styled trigger button

PNG, JPG up to 2MB

Debounced Search

Filtered list with typing delay using event modifiers [.with_(debounce), data_on_input]

starhtmlModern web framework for Python
staruiAccessible UI component library
datastarReactive frontend via HTML attributes
fastcoreCore utilities and functional tools
starletteLightweight ASGI framework

API Reference

Props

Prop Type Default Description
type InputType text Input type (text, email, password, number, etc.)
placeholder str | None None Placeholder text shown when empty
signal str | None None Datastar signal for reactive binding
validation str | None None JS expression to set <signal>_valid on input
value str | None None Initial value for non-reactive usage
disabled bool False Disable the input and style accordingly
readonly bool False Make input read-only without disabling
required bool False Mark the input as required
cls str '' Additional CSS classes for layout/styling