Input

InstallTerminal

npm install github:A3S-Lab/UI#d2799d3914d2d291fbf0c2c3e638e2380ce266c0

<input class="input" type="email" aria-label="Email" placeholder="Email" />

import "@a3s-lab/ui/a3s.css";
import "@a3s-lab/ui/all";

Usage

Include CSS

Import Tailwind and one full A3S UI style bundle.

@import "tailwindcss";
@import "@a3s-lab/ui/a3s.css";

Or import only the base CSS, Input component CSS, and one style pack.

@import "tailwindcss";
@import "@a3s-lab/ui/base.css";
@import "@a3s-lab/ui/components/input.css";
@import "@a3s-lab/ui/styles/a3s.css";

Using CDN or bundler imports? See the Installation page.

Add your input HTML

Add class="input" to supported <input> elements. Inputs inside a class="field" container also receive the same styling automatically for common text-like input types.

Use native HTML attributes for behavior: disabled for disabled inputs, required for required fields, and aria-invalid="true" for invalid state styling.

<input class="input" type="email" aria-label="Email" placeholder="Email" />

Examples

Basic

Field

Use field with a label and description to create an accessible field.

Enter your email address.

Field group

First name

Last name

<div class="grid gap-4">
  <div role="group" class="field">
    <label for="input-first-name">First name</label>
    <input id="input-first-name" type="text" placeholder="Jane" />
  </div>
  <div role="group" class="field">
    <label for="input-last-name">Last name</label>
    <input id="input-last-name" type="text" placeholder="Doe" />
  </div>
</div>

Disabled

Invalid

File

Inline

Grid

<div class="grid gap-4 md:grid-cols-2">
  <input class="input" type="text" aria-label="First name" placeholder="First name" />
  <input class="input" type="text" aria-label="Last name" placeholder="Last name" />
  <input class="input md:col-span-2" type="email" aria-label="Email" placeholder="Email" />
</div>

Required

Username *

<div role="group" class="field">
  <label for="input-required">Username <span class="text-destructive">*</span></label>
  <input id="input-required" type="text" placeholder="hunvreus" required />
</div>

Badge

Email Recommended

<div role="group" class="field">
  <label for="input-badge" class="flex w-full items-center gap-2">
    Email
    <span class="badge ml-auto" data-variant="secondary">Recommended</span>
  </label>
  <input id="input-badge" type="email" placeholder="m@example.com" />
</div>

Input group

Use the Input Group patterns to add icons, text, or buttons inside an input.

<div class="relative">
  <input class="input ps-9" type="search" aria-label="Search" placeholder="Search..." />
  <div class="pointer-events-none absolute start-3 top-1/2 -translate-y-1/2 text-muted-foreground [&>svg]:size-4"><svg class="lucide lucide-search" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m21 21-4.34-4.34" /><circle cx="11" cy="11" r="8" /></svg>
  </div>
</div>

Button group

Use Button Group when an input should be grouped with adjacent buttons.

<div role="group" aria-label="Search" class="button-group">
  <input class="input" type="search" aria-label="Search" placeholder="Search..." />
  <button type="submit" class="btn" data-variant="outline" data-size="icon" aria-label="Search"><svg class="lucide lucide-search" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m21 21-4.34-4.34" /><circle cx="11" cy="11" r="8" /></svg></button>
</div>

Form

<form class="space-y-6">
  <div role="group" class="field">
    <label for="input-form-username">Username</label>
    <input id="input-form-username" type="text" placeholder="hunvreus" required />
    <p>This is your public display name.</p>
  </div>
  <div role="group" class="field">
    <label for="input-form-email">Email</label>
    <input id="input-form-email" type="email" placeholder="m@example.com" required />
  </div>
  <button type="submit" class="btn">Submit</button>
</form>

RTL

Inputs support right-to-left layouts through native browser direction handling. Add dir="rtl" to the input, field, or an ancestor.

مفتاح API

مفتاح API الخاص بك مشفر ومخزن بأمان.

<div role="group" class="field" dir="rtl">
  <label for="input-rtl-api-key">مفتاح API</label>
  <input id="input-rtl-api-key" type="password" placeholder="sk-..." />
  <p>مفتاح API الخاص بك مشفر ومخزن بأمان.</p>
</div>

#Input

#Usage

Include CSS

Add your input HTML

#Examples

#Basic

#Field

#Field group

#Disabled

#Invalid

#File

#Inline

#Grid

#Required

#Badge

#Input group

#Button group

#Form

#RTL