Getting Started with the Kendo UI for Angular Ripple

The Ripple directive provides the Material ink ripple effect for the Kendo UI components for Angular and is fully compatible with all available Kendo UI themes.

The effect gets applied to all components that are located inside the kendoRippleContainer element.

Basic Usage

The following example demonstrates how to use the Ripple container element and add the ripple effect to buttons.

Example
View Source
Edit In Stackblitz  
Change Theme:

Installation

Either use the quick setup (Angular CLI) or manually add the package.

Quick Setup with Angular CLI

Angular CLI 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-ripple

Manual Setup

  1. Download and install the package.

       npm install --save @progress/kendo-angular-ripple @progress/kendo-angular-common @progress/kendo-licensing
  2. Once installed, import the RippleModule in your application root or feature module.

    import { NgModule } from '@angular/core';
    import { BrowserModule } from '@angular/platform-browser';
    import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
    import { RippleModule } from '@progress/kendo-angular-ripple';
    import { AppComponent } from './app.component';
    
    @NgModule({
        bootstrap:    [AppComponent],
        declarations: [AppComponent],
        imports:      [BrowserModule, BrowserAnimationsModule, RippleModule]
    })
    export class AppModule {
    }
  3. Follow the instructions on the Kendo UI for Angular My License page to activate your license. You can skip this step if your application already contains a Kendo UI license file.

Dependencies

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

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