01
Overview
Accessible form label that associates descriptive text with its input element.
Usage
02
When to use
Use when
- Building a hand-rolled field that wraps multiple inputs needing one shared label.
- Matching the disabled or required visual treatment of cinder inputs on a custom control.
Avoid when
- Labelling a built-in input that already renders its own label prop — pass label instead.
03
Props
| Name | Type | Default | Required | Bindable | Description |
|---|---|---|---|---|---|
for | text | req | The id of the form control this label labels. Sets for on the rendered <label>. | ||
required | boolean | false | When true, append a visual indicator that the field is required. | ||
disabled | boolean | false | When true, render the label in the disabled color treatment. | ||
children | snippet | req | The label text or composed content. |