Field.
The relationship around an input.
Field connects labels, controls, help and errors. TextField adds the richer input visuals; Field.Control remains the low-level input contract. Horizontal layout keeps help and errors with the control.
Make it yours
Preparing the example…
Composition
AnatomyField connects labels, controls, help and errors. TextField adds the richer input visuals; Field.Control remains the low-level input contract. Horizontal layout keeps help and errors with the control.
Field.Root (name, invalid, disabled)
├── Field.Label
├── TextField or Field.Control
├── Field.Description
└── Field.ErrorA place to start
UsageImport the stylesheet once at your application root. This complete example reflects the properties selected above.
Loading example…
Details that make a difference
Examples & statesOrientation
The owning primitive controls layout and keyboard behavior as documented above.
Loading source…
The finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native and Base UI Field props are forwarded; this table covers the options Dixy adds.
FieldRoot
| Prop | Type / description | Default |
|---|---|---|
orientation | "horizontal" | "vertical"Arrange a field and its label. | vertical |
TextField
| Prop | Type / description | Default |
|---|---|---|
size | "sm" | "md" | "lg"The height and type size of the control. | md |
variant | "soft" | "outline"The visual surface treatment. | outline |
radius | "none" | "sm" | "md" | "lg" | "full"Input rounding. | Theme.radius |
material | "matte" | "glossy" | "soft" | "metal" | "paper"Optional static finish; import materials.css. | Theme.material |
Built from the same foundations
Styling tokensChange Theme settings above to compare appearance, accent, neutral, radius, spacing density, motion and direction. Override component aliases on a Theme root so custom properties follow portaled content too. The wrapper merges className, style, refs and render composition with its owning primitive.
| Token | Purpose |
|---|---|
--dixy-input-border | The component-specific starting point. |
--dixy-font-label-md | Control label font and line height; body roles remain readable in text inputs. |
--dixy-color-background-selected | Selected surfaces use semantic color across appearances. |
--dixy-color-border-focus | Focus indication remains visible independently of shadows. |
--dixy-spacing-inset-sm | Density-aware component padding. |
--dixy-motion-transition-feedback | Short state feedback, reduced by the inherited motion setting. |
Consider everyone
AccessibilityField.Label and Field.Description establish accessible relationships. Field.Error describes recovery; never rely on border color alone.
Target: WCAG 2.2 AA. Automated tests cover selected behavior; manual screen-reader, contrast, and zoom validation remain part of the release checklist.
Build it. Then understand it.
Field is a relationship between parts. Control and Item retain registration and validation context; Validity exposes the current validation state without rendering a control. Visual settings follow Dixy shirt sizes, contextual radii and semantic tokens where applicable. Static finishes are optional, and reduced motion is immediate. Base UI keeps refs, state, events, keyboard and presence; this implementation pass does not establish WCAG conformance.
--dixy-input-border