Components / Labels

Labels Overview

The Label package contains the Label directive and the FloatingLabel component.

A component that associates a focusable component or HTML element with a HTML Label element

A component that enables the floating label functionality for Kendo UI and HTML Input elements.

Basic Usage

The following example demonstrates the Label directive in action.

@Component({
    selector: 'my-app',
    template: `
        <div class="example-config">
              Click on the label text to focus the associated input.
        </div>
        <div class="row">
            <div class="col-xs-12 col-md-6 example-col">
                  <label [for]="datepicker">DatePicker: </label>
                <kendo-datepicker #datepicker></kendo-datepicker>
            </div>
            <div class="col-xs-12 col-md-6 example-col">
                <label [for]="'input'">Input: </label>
                <input id="input" />
            </div>
        </div>
        <div class="example-config">
            Focus the inputs to trigger the floating label functionality
        </div>
        <kendo-floatinglabel text="Enter date">
            <kendo-datepicker [(ngModel)]="date" placeholder="" name="date">
            </kendo-datepicker>
        </kendo-floatinglabel>
        <kendo-floatinglabel text="Enter Age">
            <kendo-numerictextbox [(ngModel)]="age" name="age"></kendo-numerictextbox>
        </kendo-floatinglabel>
        <kendo-floatinglabel text="Select value">
            <kendo-dropdownlist [(ngModel)]="comboBoxValue" [data]="data">
            </kendo-dropdownlist>
        </kendo-floatinglabel>
  `
})
class AppComponent {
    public date: Date;
    public data: string[] = ['foo', 'bar', 'baz'];
    public comboBoxValue: string;
    public age: number;
}

Installation

Either use the quick setup (Angular CLI v6 or later) or manually add the package (Angular CLI v5 or earlier).

Quick Setup with Angular CLI v6 or Later

Angular CLI v6 supports the addition of packages through the ng add command which executes in one step the set of otherwise individually needed commands.

ng add @progress/kendo-angular-label

Manual Setup

Download and install the package.

npm install --save @progress/kendo-angular-label @progress/kendo-angular-common

Once installed, import the LabelModule in your application root or feature module.

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { LabelModule } from '@progress/kendo-angular-label';
import { AppComponent } from './app.component';

@NgModule({
   bootstrap:    [AppComponent],
   declarations: [AppComponent],
   imports:      [BrowserModule, LabelModule]
})
export class AppModule {
}

You are required to install one of the Kendo UI themes for Angular to style your component. For more information on how to add the styles, refer to the section on styling.