Label Overview
The Label component enables you to provide a label functionality to React components. It supports labelling both form elements (e.g.: input
element) and custom focusable elements. It can contain Kendo React Input components such as KendoReact DropDownList
and NumericTextBox
, or HTML elements like input
.
Basic Usage
Add the Label component and the desired editor next to it. Then set the editorId
property of the Label and the id
property of the editor.
Labelling components without form element
By default the target editor is associated with the label
element only if it's a form element (e.g.: input
, select
element). Custom components that do not contain form element (e.g.: KendoReact DropDownList
) would require setting additional properties to allow screen readers to correcly read the label. These properties are:
id
property of the Labelaria-labelledby
attribute of the editor (KendoReact components provide it asariaLabelledBy
property)
Additionally you can forward the click
events from the Label to the editor by setting the editorRef
property. On click
events the Label component will look for focus
method or activeElement
property (to call its click
method) on the editor ref. This functionality is already supported on all KendoReact form components (e.g.: DropDownList
).
Editors with invalid state
The Label component supports invalid styles by setting the editorValid
to false
.
Marking the Label as optional
The Label component supports marking the label as optional by setting the optional
to true
.