Components / Forms
Input Group
Composes inputs, textareas and addons into one control surface.
<div class="input-group" role="group" aria-label="Search">
<input class="input" type="search" placeholder="Search components..." aria-label="Search components">
<span data-slot="addon" data-align="inline-start" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg></span>
</div>Installation
pnpm dlx loseta add input-groupnpx loseta add input-groupExamples
Inline addons
<div class="input-group" role="group" aria-label="Email">
<input class="input" id="demo-input-group-email" type="email" placeholder="you@example.com" aria-label="Email">
<span data-slot="addon" data-align="inline-start" aria-hidden="true">@</span>
<span data-slot="addon" data-align="inline-end">
<button type="button" class="btn" data-variant="ghost" data-size="icon-xs" aria-label="Copy email"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg></button>
</span>
</div>Block addons
Username
6/20 characters
<div style="width: 100%; max-width: 28rem">
<div class="input-group" role="group" aria-label="Username">
<input class="input" id="demo-input-group-username" value="loseta" aria-label="Username">
<span data-slot="addon" data-align="block-start">Username</span>
<span data-slot="addon" data-align="block-end">6/20 characters</span>
</div>
</div>Textarea
Message
0/280 characters
<div style="width: 100%; max-width: 28rem">
<div class="input-group" role="group" aria-label="Message">
<textarea class="textarea" id="demo-input-group-message" placeholder="Type your message here." aria-label="Message"></textarea>
<span data-slot="addon" data-align="block-start">Message</span>
<span data-slot="addon" data-align="block-end">
<span>0/280 characters</span>
<button type="button" class="btn" data-size="icon-xs" aria-label="Send message" style="margin-inline-start: auto"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 12h14"/><path d="m12 5 7 7-7 7"/></svg></button>
</span>
</div>
</div>Buttons
<div style="display: flex; flex-direction: column; gap: 0.5rem; width: 100%; max-width: 28rem">
<div class="input-group" role="group" aria-label="Search">
<input class="input" type="search" placeholder="Search..." aria-label="Search">
<span data-slot="addon" data-align="inline-start">
<button type="button" class="btn" data-variant="secondary" data-size="xs">Search</button>
</span>
</div>
<div class="input-group" role="group" aria-label="Email">
<input class="input" id="demo-input-group-subscribe" type="email" placeholder="you@example.com" aria-label="Email">
<span data-slot="addon" data-align="inline-end">
<button type="button" class="btn" data-variant="ghost" data-size="icon-xs" aria-label="Copy email"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg></button>
<button type="button" class="btn" data-variant="secondary" data-size="xs">Subscribe</button>
</span>
</div>
</div>Keyboard shortcut
12 results
⌘K
<div class="input-group" role="group" aria-label="Search documentation">
<input class="input" id="demo-input-group-docs" type="search" placeholder="Search documentation..." aria-label="Search documentation">
<span data-slot="addon" data-align="inline-start" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg></span>
<span data-slot="addon" data-align="inline-end">12 results</span>
<span data-slot="addon" data-align="inline-end"><span class="kbd">⌘K</span></span>
</div>Loading
Saving...
<div class="input-group" role="group" aria-label="Workspace name">
<input class="input" id="demo-input-group-loading" value="acme" aria-label="Workspace name">
<span data-slot="addon" data-align="inline-start" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/></svg></span>
<span data-slot="addon" data-align="inline-end" role="status">
<span class="spinner" data-size="sm" aria-hidden="true"></span>
Saving...
</span>
</div>States
This field is currently disabled.
Username may only contain letters and numbers.
<div style="display: flex; flex-direction: column; gap: 1rem; width: 100%; max-width: 28rem">
<div class="field">
<label class="label" for="demo-input-group-disabled">Email</label>
<div class="input-group" role="group" aria-label="Email">
<input class="input" id="demo-input-group-disabled" type="email" value="ada@example.com" disabled>
<span data-slot="addon" data-align="inline-start" aria-hidden="true">@</span>
</div>
<p>This field is currently disabled.</p>
</div>
<div class="field">
<label class="label" for="demo-input-group-invalid">Username</label>
<div class="input-group" role="group" aria-label="Username">
<input class="input" id="demo-input-group-invalid" value="invalid name" aria-invalid="true" aria-describedby="demo-input-group-invalid-error">
<span data-slot="addon" data-align="inline-end" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><line x1="12" x2="12" y1="8" y2="12"/><line x1="12" x2="12.01" y1="16" y2="16"/></svg></span>
</div>
<p id="demo-input-group-invalid-error" role="alert">Username may only contain letters and numbers.</p>
</div>
</div>Custom control
Build me a landing page for a CSS registry.
<div style="width: 100%; max-width: 28rem">
<div class="input-group" role="group" aria-label="Message">
<div role="textbox" contenteditable="true" aria-label="Message" aria-multiline="true" data-slot="input-group-control" spellcheck="false">Build me a landing page for a CSS registry.</div>
<span data-slot="addon" data-align="inline-start" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/></svg></span>
<span data-slot="addon" data-align="inline-end">
<button type="button" class="btn" data-size="icon-xs" aria-label="Send message"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 12h14"/><path d="m12 5 7 7-7 7"/></svg></button>
</span>
</div>
</div>Right-to-left
١٢ نتيجة
<div dir="rtl" lang="ar" style="width: 100%; max-width: 28rem">
<div class="input-group" role="group" aria-label="البحث في المكوّنات">
<input class="input" type="search" placeholder="ابحث في المكوّنات..." aria-label="ابحث في المكوّنات">
<span data-slot="addon" data-align="inline-start" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg></span>
<span data-slot="addon" data-align="inline-end">١٢ نتيجة</span>
</div>
</div>Accessibility and behavior
- role="group" root. Place addons after the input or textarea in the DOM so the control keeps its tab order; data-align="inline-start|inline-end|block-start|block-end" positions them visually and defaults to inline-start. Addons use [data-slot="addon"]; custom controls opt into the group geometry and focus ring with data-slot="input-group-control". The group owns the border, disabled tint and focus ring; inner controls are borderless and addon buttons keep their own focus ring. Clicking an addon does not focus the control; that is consumer JavaScript.
Files
components/input-group.cssbasestyles/nova/input-group.cssstyleInstall contract
The CLI writes the base file under components/, the visual file for the selected style under styles/<name>/, and any primitive dependency underprimitives/. The generated index.css imports them in the right layer order.