KasyKasy

Control Field

Live preview and documentation for the Control Field component.

Preview

componentPreview.loading

About

Generic "control + title + description + error" layout — the row that KasyCheckbox and KasyRadio already assemble internally for their own control. Extracted so any control (KasySwitch, a custom slot, any widget) gets the same text treatment without reimplementing it.

  • control: the control widget itself (checkbox, radio, switch, or any custom widget).
  • title / description: text next to the control. Without either, it returns just the bare control (no text column).
  • errorText: error message below the description; also applies the invalid color to the title and description even without isInvalid.
  • isInvalid: forces the invalid color without needing errorText.
  • isDisabled: applies a "muted" color to the title.
  • size: sm, md (default), lg — text scale that matches KasyRadio/KasyCheckbox's rhythm.
  • controlTopOffset: adjusts the control to center on the title's first line (default 2; 0 for controls that already sit on the baseline, like KasyCheckbox).
  • titleWeight: title weight (KasyCheckbox uses w600, KasyRadio uses w500).

Last updated on 08/23/2026

On this page