Labels Overview

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

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

  1. Download and install the package.

    npm install --save @progress/kendo-angular-label @progress/kendo-angular-common
  2. 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 {
    }
  3. 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.

Dependencies

The Label package requires you to install the following peer dependencies in your application:

  • @angular/common
  • @angular/core
  • @progress/kendo-angular-common
  • rxjs

Functionality and Features

The Label provides association to Angular components and HTML elements.

The FloatingLabel provides floating label functionality for Kendo UI for Angular and regular HTML Input elements.

In this article