Skip to content
wdj

Input

Implemented Input

Text field with label, description, leading/trailing icons.

Kumo reference: kumo-ui.com/components/input/

Presentation commands show demo feedback. Read the interaction guide to connect real actions.

Basic

We'll never share your email

Show template
{% load wdj %}
<div class="inline-flex max-w-full">
{% include "wdj/components/input.html" with name="input_basic" label="Email" type="email" placeholder="you@example.com" description="We'll never share your email" only %}
</div>

Label

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_label" label="Username" placeholder="Choose a username" only %}
</div>

Description

Use your work email.

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_description" label="Email" type="email" description="Use your work email." only %}
</div>

Required

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_required" label="Project name" required=True only %}
</div>

Disabled

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_disabled" label="Disabled field" value="Locked" disabled=True only %}
</div>

Read only

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_read_only" label="Resource ID" value="demo-123" readonly=True only %}
</div>

Error

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_error" label="Email" value="invalid" error="Enter a valid email." only %}
</div>

Leading icon

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_leading_icon" label="Search" leading_icon="search" only %}
</div>

Trailing icon

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_trailing_icon" label="Verified value" trailing_icon="check" only %}
</div>

Password

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_password" label="Password" type="password" only %}
</div>

Number

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_number" label="Concurrency" type="number" min=0 max=100 value=0 only %}
</div>

Clearable

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_clearable" label="Search query" value="edge worker" clearable=True only %}
</div>

Small

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_small" label="Small field" size="sm" only %}
</div>

Large

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_large" label="Large field" size="lg" only %}
</div>

Extra small

Show template
{% load wdj %}
<div class="grid w-full max-w-lg gap-4">
{% include "wdj/components/input.html" with name="input_extra_small" label="Compact field" size="xs" only %}
</div>

Optional field

Show template
{% load wdj %}
{% include "wdj/components/input.html" with id="audit-input-optional-field" name="workspace" optional=True label="Workspace name" only %}

Label tooltip

Use the name shown to other team members.
Show template
{% load wdj %}
{% include "wdj/components/input.html" with id="audit-input-label-tooltip" name="workspace" label_tooltip="Use the name shown to other team members." label="Workspace name" only %}

Bare error field

Show template
{% load wdj %}
{% include "wdj/components/input.html" with id="audit-input-bare-error-field" name="workspace" error="This value is unavailable." aria_label="Workspace name" label="" only %}

Password manager isolation

Show template
{% load wdj %}
{% include "wdj/components/input.html" with id="audit-input-password-manager-isolation" name="workspace" type="password" attrs=audit_password_attrs label="Workspace name" only %}

Controlled local input

Show template
{% load wdj %}
<div x-data="{ name: 'Demo' }">{% include "wdj/components/input.html" with id="audit-controlled-input" label="Workspace" attrs=audit_input_model only %}<p class="mt-2 text-base" x-text="name"></p></div>

API Reference

Prop Type Default Description
string unset Name; pass the documented value shown in the examples.
string unset Value; pass the documented value shown in the examples.
string text Type; pass the documented value shown in the examples.
string base Size; pass the documented value shown in the examples.
string component-specific Variant; pass the documented value shown in the examples.
string unset Visible accessible label. Supply an explicit aria-label via attrs when the control is bare.
bool False Optional; pass the documented value shown in the examples.
string unset Label tooltip; pass the documented value shown in the examples.
string unset Description; pass the documented value shown in the examples.
string unset Validation message; implies error styling and accessible error association.
bool False Required; pass the documented value shown in the examples.
bool False Disabled; pass the documented value shown in the examples.
bool False Readonly; pass the documented value shown in the examples.
string unset Placeholder; pass the documented value shown in the examples.
string unset Autocomplete; pass the documented value shown in the examples.
string unset Inputmode; pass the documented value shown in the examples.
string unset Pattern; pass the documented value shown in the examples.
number 0 (Slider/Meter) Min; pass the documented value shown in the examples.
number 100 (Slider/Meter) Max; pass the documented value shown in the examples.
number 1 (Slider) Step; pass the documented value shown in the examples.
string unset Maxlength; pass the documented value shown in the examples.
bool False Clearable; pass the documented value shown in the examples.
string unset Leading icon; pass the documented value shown in the examples.
string unset Trailing icon; pass the documented value shown in the examples.
string unset Stable unique DOM ID; important for HTMX targets and focus restoration.
dict {} Dictionary of escaped native, HTMX or Alpine attributes. Literal Tailwind classes only.
string unset Field class; pass the documented value shown in the examples.

Accessibility notes

Every interactive component keeps real semantics and keyboard support: native controls where possible, ARIA only where necessary, and a visible focus ring. See the Accessibility page for the shared contract.

Read the accessibility contract

Components

Components overview
AutocompleteFree-form input with local or HTMX-filtered suggestions.
BadgeSolid, tinted, outline and dot status labels.
BannerInline message bar with variants and optional action.
BreadcrumbsTrail navigation in two sizes.
ButtonVariants, sizes, shapes, icons and loading state.
ButtonGroupJoins a small set of tightly-coupled buttons into a single control (split buttons).
CheckboxSingle checkbox and indeterminate state.
ClipboardTextRead-only text field with a one-click copy-to-clipboard button.
Code / CodeHighlightedEscaped Pygments grammar highlighting, multiline tokens, line numbers, highlighted lines and localized copying.
CollapsibleComposable disclosure component for showing and hiding content.
Combobox / AutocompleteKumo-styled input/button triggers, search inside the popup, grouped local choices and debounced HTMX search.
CommandPaletteAccessible spotlight search overlay with Cmd+K keyboard shortcut.
DatePickerKumo-styled date and datetime popups; inline single, multiple and range calendars with bounds/presets.
DateRangePickerStyled popup or inline range calendar with bounds, presets and separately named form values.
DialogNative <dialog> modal with focus management.
DrawerEdge-anchored modal panel. LayerDialog has its own layered component.
DropdownMenuNative details menu with delegated keyboard navigation and dismissal.
EmptyEmpty-state placeholder with icon and action.
FieldLabel + description + error wrapper. Built into each control.
FlowDirected diagrams with branches, SVG connectors, custom anchors and responsive local scrolling.
GridResponsive CSS grid layout container with preset column configurations.
InlineCopyTextCompact borderless copy control for IDs and short values.
InputText field with label, description, leading/trailing icons.
InputAreaMulti-line textarea with auto-resize option.
InputGroupInput field with seamless prefix, suffix, and addon attachments.
LabelForm field label, optional marker and tooltip.
LayerCardCompound surface card with distinct primary and secondary layers.
LayerDialogLayered native modal with actions, forms, nested dialogs and pending states.
LinkInline, current and plain text links.
LoaderAnimated spinner in three sizes.
MenuBarCompact view selector using native radio semantics.
MeterProgress bar showing a measured value within a known range.
PaginationA page navigation component for navigating through paginated content.
PopoverAnchored popup with interactive content.
RadioRadio group, vertical and horizontal.
SelectKumo-styled Alpine dropdown with groups, rich options and multiple selection; native form values and fallback.
SensitiveInputPassword/secret input with reveal toggle and copy button.
SeparatorHorizontal / vertical rules with optional label.
SidebarRecursive navigation groups, account/zone views, search, loading, resize and full-screen mobile breadcrumbs.
SkeletonShimmer placeholder.
SliderInset single/range selection with vertical grips, value badges, endpoint labels and native keyboard/form behavior.
SurfaceBordered surface panel with header slot.
SwitchOn/off toggle in three sizes.
TableServer-driven table: sort, filter, select and paginate the full dataset.
Table of contentsPage section navigation tree with active link indicator.
TabsSegmented and underline tabs with a sliding indicator, responsive overflow and local Alpine or URL/HTMX state.
TagInputMulti-value badge input for tags and recipients.
TextHeading, body, secondary, success, error and mono text.
ToastyExpandable notification stack with variants, paused expiry and a live region.
ToolbarCompact grouped controls with shared borders, composed filters and keyboard arrow navigation.
TooltipHover and focus tooltip with grouped delays, Escape dismissal and viewport bounds.
↑ ↓ Navigate ↵ Select