Components
    • Animation
    • Buttons
    • Charts
    • Common Utilities
    • Conversational UI
    • Data Query
    • Data Tools
    • Date Inputs
    • Date Math
    • Dialogs
    • Drawing
    • Dropdowns
    • Editor
    • Excel Export
    • File Saver
    • Form
    • Gantt
    • Gauges
    • Grid
    • Indicators
    • Inputs
    • Labels
    • Layout
    • ListView
    • Notification
    • PDF Processing
    • Popup
    • Progress Bars
    • Ripple
    • Scheduler
    • Sortable
    • Tooltip
    • TreeList
    • TreeView
    • Upload
    Sample Applications
    Styling & Themes
    Common Features
    Project Setup
    Changelog

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.

Example
View Source
Edit In Stackblitz  
Change Theme:

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 Label
  • aria-labelledby attribute of the editor (KendoReact components provide it as ariaLabelledBy 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).

Example
View Source
Edit In Stackblitz  
Change Theme:

Editors with invalid state

The Label component supports invalid styles by setting the editorValid to false.

Example
View Source
Edit In Stackblitz  
Change Theme:

Marking the Label as optional

The Label component supports marking the label as optional by setting the optional to true.

Example
View Source
Edit In Stackblitz  
Change Theme: