Components / Buttons / SplitButton

SplitButton Overview

The SplitButton component allows the user to execute a default action which is bound to a Button or to choose a predefined action from a drop-down list.

Basic Usage

The following example demonstrates the SplitButton in action.

@Component({
    selector: 'my-app',
    template: `
        <div class="row">
          <div class="col-xs-12 col-sm-6 col-lg-3 example-col">
            <p>Default Button</p>
            <kendo-splitbutton (buttonClick)="onPaste()" [data]="data" [icon]="paste">
                Paste
            </kendo-splitbutton>
          </div>

          <div class="col-xs-12 col-sm-6 col-lg-3 example-col">
            <p>Flat Button</p>
            <kendo-splitbutton (buttonClick)="onPaste()" [data]="data" [icon]="paste" [look]="'flat'">
                Paste
            </kendo-splitbutton>
          </div>

          <div class="col-xs-12 col-sm-6 col-lg-3 example-col">
            <p>Outline Button</p>
            <kendo-splitbutton (buttonClick)="onPaste()" [data]="data" [icon]="paste" [look]="'outline'">
                Paste
            </kendo-splitbutton>
          </div>
        </div>
    `
})
class AppComponent {
    public data: Array<any> = [{
        text: 'Keep Text Only',
        icon: 'paste-plain-text',
        click: () => { console.log('Keep Text Only'); }
    }, {
        text: 'Paste as HTML',
        icon: 'paste-as-html',
        click: () => { console.log('Paste as HTML'); }
    }, {
        text: 'Paste Markdown',
        icon: 'paste-markdown',
        click: () => { console.log('Paste Markdown'); }
    }, {
        text: 'Set Default Paste',
        click: () => { console.log('Set Default Paste'); }
    }];

    public onPaste(): void {
        console.log('Paste');
    }
}

Functionality and Features

Events

The following example demonstrates basic SplitButton events.

import { Component } from '@angular/core';

@Component({
    selector: 'my-app',
    template: `
        <kendo-splitbutton
            [data]="data"
            (itemClick)="onClick()"
            (focus)="onFocus()"
            (blur)="onBlur()"
            (open)="onOpen()"
            (close)="onClose()"
            >
            User settings
        </kendo-splitbutton>
        <event-log title="Event log" [events]="events"></event-log>
    `
})

export class AppComponent {
    public events: string[] = [];
    public data: Array<any> = [
        { text: 'My Profile' },
        { text: 'Friend Requests' },
        { text: 'Account Settings' },
        { text: 'Support' },
        { text: 'Log Out' }
    ];

    public onClick(): void {
        this.log('click');
    }

    public onFocus(): void {
        this.log('focus');
    }

    public onBlur(): void {
        this.log('blur');
    }

    public onOpen(): void {
        this.log('open');
    }

    public onClose(): void {
        this.log('close');
    }

    private log(event: string): void {
        this.events.push(`${event}`);
    }
}

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
import { ButtonsModule } from '@progress/kendo-angular-buttons';
import { AppComponent } from './app.component';
import { EventLogComponent } from './event-log.component';

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

import { Component, Input } from '@angular/core';

@Component({
  selector: 'event-log',
  template: `
    <div class="example-config">
      <h5>{{ title }}</h5>
      <ul class="event-log">
        <li *ngFor="let event of events.reverse()">{{ event }}</li>
      </ul>
    </div>
  `
})
export class EventLogComponent {
  @Input() title: string;
  @Input() events: string[];
}

import { AppModule } from './app.module';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';

const platform = platformBrowserDynamic();
platform.bootstrapModule(AppModule, { preserveWhitespaces: true });

In this article