Input

Text input field component with variant support and two-way binding.

The Input component provides a styled text input field with support for all standard HTML input types, two-way binding, and focus/blur events.

Installation

bash
shellui add input

Usage

Basic

<div class="w-full max-w-sm">
  <Input Placeholder="Enter your name" />
</div>

Input Types

<div class="w-full max-w-sm">
  <Input Placeholder="email@example.com" Type="email" />
  <Input Placeholder="Enter password" Type="password" />
  <Input Placeholder="Enter amount" Type="number" />
  <Input Placeholder="Search..." Type="search" />
</div>

With Label

<div class="w-full max-w-sm space-y-2">
  <Label For="email">Email</Label>
  <Input Placeholder="email@example.com" Type="email" />
</div>

Two-way Binding

<div class="w-full max-w-sm">
  <Input @bind-Value="email" Placeholder="Enter email" Type="email" />
</div>

@code {
    private string email = "";
}

ValueChanged Callback

<div class="w-full max-w-sm">
  <Input Value="@email" ValueChanged="@HandleEmailChanged" Placeholder="Enter email" />
</div>

@code {
    private string email = "";

    private void HandleEmailChanged(string value)
    {
        email = value;
    }
}

Error

Set Variant="InputVariant.Error" to mark an invalid value. Pair it with a message and aria-invalid.

Enter a valid email address.

<div class="w-full max-w-sm space-y-2">
  <Label For="error-email">Email</Label>
  <Input id="error-email" Variant="InputVariant.Error" Value="not-an-email" Type="email" aria-invalid="true" />
  <p class="text-sm text-destructive">Enter a valid email address.</p>
</div>
Changed in 0.4.0-alpha.3 (CLI)

InputVariant now comes from the input-variants template in Components/UI/Variants, like ButtonVariant, so Input.InputVariant.Error becomes InputVariant.Error. shellui update installs the template, and shellui migrate input (0.4.0) rewrites the references in your pages. The NuGet package is unchanged.

Disabled and ReadOnly

<div class="w-full max-w-sm">
  <Input Placeholder="Disabled input" Disabled="true" />
  <Input Value="Read-only value" ReadOnly="true" />
</div>

Custom Class

@
<div class="w-full max-w-sm relative">
  <span class="absolute left-3 top-1/2 -translate-y-1/2 text-muted-foreground">@@</span>
  <Input Class="pl-10" Placeholder="Email" Type="email" />
</div>

API Reference

Parameter Type Default Description
Variant InputVariant Default Default or Error
Type string "text" HTML input type attribute
Value string "" Current input value
Placeholder string "" Placeholder text
Disabled bool false Disables the input
ReadOnly bool false Makes input read-only
Class string? null Additional CSS classes
ValueChanged EventCallback<string> — Fires when value changes
OnFocus EventCallback<FocusEventArgs> — Fires when input gains focus
OnBlur EventCallback<FocusEventArgs> — Fires when input loses focus

Accessibility

  • Proper label association via For / Id attributes
  • ARIA attributes for validation states
  • Keyboard navigation support
  • Screen reader compatible

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.