Components / Buttons / DropDownButton

Icon DropDownButton

You can enhance the textual content of the DropDownButton by adding image, predefined, or custom icons to it.

With a view to the web standards, it is better to use a background image because icons are used for decoration and not for representing structural content.

The DropDownButton provides options for:

  • Using the built-in Kendo UI icons. They are applied through the icon property and displayed as a background for the DropDownButton. To see the full list of the web font icons in Kendo UI, refer to the article on styles and layout.
  • Adding FontAwesome and other font icons. They are implemented by setting the required third-party CSS classes through the iconClass property.
  • Adding image icons. They are applied through the imageUrl property of the component.

The following example demonstrates how to use the different types of icons in a DropDownButton.

@Component({
    selector: 'my-app',
    template: `
        <div class="row example-wrapper">
          <div class="col-xs-12 col-sm-6 col-md-4 example-col">
            <p>Kendo UI font icon</p>
            <kendo-dropdownbutton [data]="settings" [icon]="icon">
                User Settings
            </kendo-dropdownbutton>
            <kendo-dropdownbutton [data]="settings" [icon]="icon"></kendo-dropdownbutton>
          </div>

          <div class="col-xs-12 col-sm-6 col-md-4 example-col">
            <p>FontAwsome icon</p>
            <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
            <kendo-dropdownbutton [data]="settings" [iconClass]="iconClass">
                User Settings
            </kendo-dropdownbutton>
            <kendo-dropdownbutton [data]="settings" [iconClass]="iconClass"></kendo-dropdownbutton>
          </div>

          <div class="col-xs-12 col-sm-6 col-md-4 example-col">
            <p>Image icon</p>
            <kendo-dropdownbutton [data]="bookmarks" [imageUrl]="imageUrl">
                Bookmarks
            </kendo-dropdownbutton>
            <kendo-dropdownbutton [data]="bookmarks" [imageUrl]="imageUrl"></kendo-dropdownbutton>
          </div>
        </div>
    `
})
class AppComponent {

    // Built-in Kendo UI icon
    icon: string = 'cog';
    settings: Array<any> = [{
        text: 'My Profile'
    }, {
        text: 'Friend Requests'
    }, {
        text: 'Account Settings'
    }, {
        text: 'Support'
    }, {
        text: 'Log Out'
    }];

    // FontAwesome icon
    iconClass: string = 'fa fa-cog fa-fw';

    // Image icon
    imageUrl: string = 'http://demos.telerik.com/kendo-ui/content/shared/icons/16/star.png';
    bookmarks: Array<any> = [{
        text: 'Show All'
    }, {
        text: 'Bookmark This Page'
    }, {
        text: 'Import'
    }, {
        text: 'Export'
    }];
}

In this article