@progress/kendo-angular-buttons 19.1.1-develop.2 → 19.1.2-develop.1

package/floatingactionbutton/floatingactionbutton.component.d.ts

@@ -23,10 +23,17 @@ import { SVGIcon } from '@progress/kendo-svg-icons';
 import { DialItem } from './models/item.interface';
 import * as i0 from "@angular/core";
 /**
+ * Represents the Kendo UI FloatingActionButton component for Angular.
+ * Use it to represent the primary or most common action in an application.
  *
- * Represents the [Kendo UI FloatingActionButton component for Angular]({% slug overview_floatingactionbutton %}).
- * Used to specify the primary or the most common action in an application.
- *
+ * @example
+ * ```html
+ * <kendo-floatingactionbutton
+ *     [icon]="'plus'"
+ *     [text]="'Add'"
+ *     [align]="{ horizontal: 'end', vertical: 'bottom' }">
+ * </kendo-floatingactionbutton>
+ * ```
  */
 export declare class FloatingActionButtonComponent implements AfterViewInit, OnDestroy {
     renderer: Renderer2;
@@ -45,88 +52,49 @@ export declare class FloatingActionButtonComponent implements AfterViewInit, OnD
     dialItemTemplate: DialItemTemplateDirective;
     fabTemplate: FloatingActionButtonTemplateDirective;
     /**
-     * Specifies the theme color of the FloatingActionButton
-     * ([see example](slug:appearance_floatingactionbutton#toc-theme-colors)).
-     * The theme color will be applied as background color of the component.
-     *
-     * The possible values are:
-     * * `primary` (Default)&mdash;Applies coloring based on the `primary` theme color.
-     * * `secondary`&mdash;Applies coloring based on the `secondary` theme color.
-     * * `tertiary`&mdash; Applies coloring based on the `tertiary` theme color.
-     * * `info`&mdash;Applies coloring based on the `info` theme color.
-     * * `success`&mdash; Applies coloring based on the `success` theme color.
-     * * `warning`&mdash; Applies coloring based on the `warning` theme color.
-     * * `error`&mdash; Applies coloring based on the `error` theme color.
-     * * `dark`&mdash; Applies coloring based on the `dark` theme color.
-     * * `light`&mdash; Applies coloring based on the `light` theme color.
-     * * `inverse`&mdash; Applies coloring based on the `inverse` theme color.
-     * * `none`&mdash; Removes the built in theme color.
+     * Specifies the theme color of the FloatingActionButton ([see example](slug:appearance_floatingactionbutton#theme-colors)).
+     * @default "primary"
      */
     set themeColor(themeColor: ButtonThemeColor);
     get themeColor(): ButtonThemeColor;
     /**
-     * Specifies the size of the FloatingActionButton
-     * ([see example]({% slug appearance_floatingactionbutton %}#toc-size)).
-     *
-     * The possible values are:
-     * * `small`
-     * * `medium` (Default)
-     * * `large`
-     * * `none`
+     * Specifies the size of the FloatingActionButton ([see example](slug:appearance_floatingactionbutton#size)).
+     * @default "medium"
      */
     set size(size: ButtonSize);
     get size(): ButtonSize;
     /**
-     * The rounded property specifies the border radius of the FloatingActionButton.
+     * Specifies the border radius of the FloatingActionButton ([see example](slug:appearance_floatingactionbutton#roundness)).
      *
-     * The possible values are:
-     * * `small`
-     * * `medium`
-     * * `large`
-     * * `full` (default)
-     * * `none`
+     * @default "full"
      */
     set rounded(rounded: ButtonRounded);
     get rounded(): ButtonRounded;
     /**
      * Specifies whether the FloatingActionButton is disabled.
+     * @default false
      */
     set disabled(disabled: boolean);
     get disabled(): boolean;
     /**
-     * Specifies the horizontal and vertical alignment of the FloatingActionButton
-     * ([see example](slug:positioning_floatingactionbutton#toc-alignment)).
-     *
-     * The possible values are:
-     * * `{ horizontal: 'start'|'center'|'end', vertical: 'top'|'middle'|'bottom' }`
-     *
-     * The default value is:
-     * * `{ horizontal: 'end', vertical: 'bottom' }`
-     *
+     * Specifies the alignment of the FloatingActionButton ([see example](slug:positioning_floatingactionbutton#alignment)).
+     * @default { horizontal: 'end', vertical: 'top' }
      */
     set align(align: FabAlign);
     get align(): FabAlign;
     /**
-     * Specifies the horizontal and vertical offset position of the FloatingActionButton
-     * ([see example]({% slug positioning_floatingactionbutton %}#toc-offset)).
-     *
-     * * The default value is:
-     * * `{ x: '16px', y: '16px' }`
+     * Specifies the offset position of the FloatingActionButton ([see example]({% slug positioning_floatingactionbutton %}#offset)).
+     * @default { x: '16px', y: '16px' }
      */
     set offset(offset: FabOffset);
     get offset(): FabOffset;
     /**
-     * Specifies the positionMode of the FloatingActionButton
-     * ([see example](slug:positioning_floatingactionbutton#toc-position-mode)).
-     *
-     * * The possible values are:
-     * * `absolute`&mdash;Positions the FloatingActionButton absolutely to its first positioned parent element.
-     * * `fixed` (Default)&mdash;Positions the FloatingActionButton relative to the viewport. It always stays in the same place even if the page is scrolled.
+     * Specifies the position mode of the FloatingActionButton ([see example](slug:positioning_floatingactionbutton#position-mode)).
+     * @default "fixed"
      */
     positionMode: FabPositionMode;
     /**
      * Defines the name of an existing icon in a Kendo UI theme.
-     * If provided, the icon will be rendered inside the FloatingActionButton by a `span.k-icon` element.
      */
     icon: string;
     /**
@@ -134,8 +102,7 @@ export declare class FloatingActionButtonComponent implements AfterViewInit, OnD
      */
     svgIcon: SVGIcon;
     /**
-     * Defines a CSS class or multiple classes separated by spaces which are applied to a `span` element.
-     * Allows the usage of custom icons, rendered inside the FloatingActionButton by a `span` element.
+     * Defines a CSS class or multiple classes for custom icons.
      */
     iconClass: string;
     /**
@@ -154,46 +121,37 @@ export declare class FloatingActionButtonComponent implements AfterViewInit, OnD
     text: string;
     /**
      * Specifies the animation settings of the FloatingActionButton dial items.
-     * ([see example]({% slug dialitems_floatingactionbutton %}#toc-animation)).
-     *
-     * The possible values are:
-     * * Boolean
-     *    * (Default) `true`&mdash;Applies the default [`DialItemAnimation`]({% slug api_buttons_dialitemanimation %}) settings.
-     *    * `false`
-     * * `DialItemAnimation`
-     *    * `duration`&mdash;Specifies the animation duration in milliseconds for each dial item. Defaults to `180ms`.
-     *    * `gap`&mdash;Specifies the animation duration gap in milliseconds after each dial item is animated. Defaults to `90ms`.
+     * @default true
      */
     dialItemAnimation: boolean | DialItemAnimation;
     /**
      * Specifies the [`tabIndex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the FloatingActionButton.
+     * @default 0
      */
     tabIndex: number;
     /**
-     * Specifies the collection of the dial items that will be rendered in the FloatingActionButton popup.
+     * Specifies the collection of dial items rendered in the FloatingActionButton popup.
      */
     dialItems: DialItem[];
     /**
-     * Fires each time the FloatingActionButton gets blurred.
+     * Fires when the FloatingActionButton is blurred.
      */
     onBlur: EventEmitter<any>;
     /**
-     * Fires each time the FloatingActionButton gets focused.
+     * Fires when the FloatingActionButton is focused.
      */
     onFocus: EventEmitter<any>;
     /**
-     * Fires each time a dial item is clicked.
+     * Fires when a dial item is clicked.
      */
     dialItemClick: EventEmitter<DialItemClickEvent>;
     /**
-     * Fires each time the popup is about to open.
-     * This event is preventable. If you cancel the event, the popup will remain closed
-     * ([more information and example](slug:events_floatingactionbutton)).
+     * Fires when the popup is about to open. This event is preventable
+     *  ([more information and example](slug:events_floatingactionbutton)).
      */
     open: EventEmitter<PreventableEvent>;
     /**
-     * Fires each time the popup is about to close.
-     * This event is preventable. If you cancel the event, the popup will remain open
+     * Fires when the popup is about to close. This event is preventable
      * ([more information and example](slug:events_floatingactionbutton)).
      */
     close: EventEmitter<PreventableEvent>;

package/floatingactionbutton/floatingactionbutton.module.d.ts

@@ -7,31 +7,24 @@ import * as i1 from "./floatingactionbutton.component";
 import * as i2 from "./templates/dial-item-template.directive";
 import * as i3 from "./templates/fab-template.directive";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the FloatingActionButton component.
+ * Represents the NgModule definition for the FloatingActionButton component.
  *
- * @example
+ * Required for adding FloatingActionButton features in NgModule-based Angular applications.
  *
- * ```ts-no-run
- * // Import the FloatingActionButton module
+ * @example
+ * ```ts
  * import { FloatingActionButtonModule } from '@progress/kendo-angular-buttons';
- *
- * // The browser platform with a compiler
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
  * import { AppComponent } from './app.component';
+ * import { BrowserModule } from '@angular/platform-browser';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, FloatingActionButtonModule], // import FloatingActionButton module
- *     bootstrap:    [AppComponent]
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports: [BrowserModule, FloatingActionButtonModule],
+ *     bootstrap: [AppComponent]
  * })
  * export class AppModule {}
- *
  * ```
  */
 export declare class FloatingActionButtonModule {

package/floatingactionbutton/models/align.d.ts

@@ -4,7 +4,12 @@
 *-------------------------------------------------------------------------------------------*/
 /**
  * Specifies the horizontal and vertical alignment of the FloatingActionButton relative to the viewport or parent element
- * ([see example](slug:positioning_floatingactionbutton#toc-alignment)).
+ * ([see example](slug:positioning_floatingactionbutton#alignment)).
+ *
+ * @example
+ * ```typescript
+ * const align: FabAlign = { vertical: 'top', horizontal: 'start' };
+ * ```
  */
 export interface FabAlign {
     /**

package/floatingactionbutton/models/item-animation.interface.d.ts

@@ -4,7 +4,12 @@
 *-------------------------------------------------------------------------------------------*/
 /**
  * Specifies the animation settings for the dial items of the FloatingActionButton
- * ([see example]({% slug dialitems_floatingactionbutton %}#toc-animation)).
+ * ([see example]({% slug dialitems_floatingactionbutton %}#animation)).
+ *
+ * @example
+ * ```typescript
+ * const animation: DialItemAnimation = { duration: 200, gap: 100 };
+ * ```
  */
 export interface DialItemAnimation {
     /**

package/floatingactionbutton/models/item-click.event.d.ts

@@ -3,8 +3,15 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Arguments for the `click` event of the dial item
+ * Arguments for the `click` event of a dial item
  * ([see example](slug:events_floatingactionbutton)).
+ *
+ * @example
+ * ```typescript
+ * function onDialItemClick(event: DialItemClickEvent): void {
+ *     console.log(event.item, event.index);
+ * }
+ * ```
  */
 export interface DialItemClickEvent {
     /**

package/floatingactionbutton/models/item.interface.d.ts

@@ -5,7 +5,7 @@
 import { SVGIcon } from "@progress/kendo-svg-icons";
 /**
  * An interface for the dial items of the FloatingActionButton
- * ([see example]({% slug dialitems_floatingactionbutton %}#toc-dial-items)).
+ * ([see example]({% slug dialitems_floatingactionbutton %}#dial-items)).
  */
 export interface DialItem {
     /**
@@ -24,21 +24,21 @@ export interface DialItem {
     disabled?: boolean;
     /**
      * Defines the name of an existing icon in a Kendo UI theme.
-     * If provided, the icon will be rendered inside the dial item by a `span.k-icon` element, instead of the default numeric or text content.
+     * If set, the icon is rendered inside the dial item by a `span.k-icon` element instead of the default numeric or text content.
      */
     icon?: string;
     /**
-     * Defines a CSS class or multiple classes separated by spaces which are applied to a span element.
-     * Allows the usage of custom icons, rendered inside the dial item instead of the default numeric or text content.
+     * Defines a CSS class or multiple classes separated by spaces applied to a `span` element.
+     * Enables the use of custom icons rendered inside the dial item instead of the default numeric or text content.
      */
     iconClass?: string;
     /**
-     * Defines an [`SVGIcon`](slug:api_icons_svgicon) to be rendered within the dial item.
+     * Defines an [`SVGIcon`](slug:api_icons_svgicon) to render within the dial item.
      */
     svgIcon?: SVGIcon;
     /**
      * Specifies the `title` attribute of the dial item.
-     * If provided, the `title` value will be rendered in `aria-label` attribute on the element of the dial item.
+     * If set, the `title` value is rendered in the `aria-label` attribute on the dial item's element.
      */
     itemTitle?: string;
     /**

package/floatingactionbutton/models/offset.d.ts

@@ -3,8 +3,13 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the horizontal and vertical offset position of the FloatingActionButton
- * ([see example]({% slug positioning_floatingactionbutton %}#toc-offset)).
+ * Specifies the horizontal and vertical offset positions of the FloatingActionButton
+ * ([see example]({% slug positioning_floatingactionbutton %}#offset)).
+ *
+ * @example
+ * ```typescript
+ * const offset: FabOffset = { x: '10px', y: '20px' };
+ * ```
  */
 export interface FabOffset {
     /**

package/floatingactionbutton/models/position-mode.d.ts

@@ -3,11 +3,11 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the positionMode of the FloatingActionButton
- * ([see example](slug:positioning_floatingactionbutton#toc-position-mode)).
+ * Specifies the `positionMode` of the FloatingActionButton
+ * ([see example](slug:positioning_floatingactionbutton#position-mode)).
  *
- * * The possible values are:
- * * `absolute`—Positions the FloatingActionButton absolutely to its first positioned parent element.
- * * `fixed` (Default)—Positions the FloatingActionButton relative to the viewport. It always stays in the same place even if the page is scrolled.
+ * The possible values are:
+ * - `absolute`—Positions the FloatingActionButton absolutely to its first positioned parent element.
+ * - `fixed` (Default)—Positions the FloatingActionButton relative to the viewport. It remains in the same place even when the page scrolls.
  */
 export type FabPositionMode = 'absolute' | 'fixed';

package/floatingactionbutton/templates/dial-item-template.directive.d.ts

@@ -5,10 +5,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the content of the whole dial item.
- * To define the template, nest an `<ng-template>` tag
- * with the `kendoDialItemTemplate` directive inside the `<kendo-floatingactionbutton>` tag
- * ([see example]({% slug templates_floatingactionbutton %}#toc-dial-item-template)).
+ * Represents a template that defines the content of a dial item.
+ * To define the template, nest an `<ng-template>` tag with the `kendoDialItemTemplate` directive inside the `<kendo-floatingactionbutton>` tag
+ *([see example]({% slug templates_floatingactionbutton %}#dial-item-template)).
+ *
+ * @example
+ * ```html
+ * <kendo-floatingactionbutton>
+ *     <ng-template kendoDialItemTemplate let-item="item">
+ *         {{ item.label }}
+ *     </ng-template>
+ * </kendo-floatingactionbutton>
+ * ```
  */
 export declare class DialItemTemplateDirective {
     templateRef: TemplateRef<any>;

package/floatingactionbutton/templates/fab-template.directive.d.ts

@@ -6,9 +6,18 @@ import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
  * Represents a template that defines the content of the FloatingActionButton.
- * To define the template, nest an `<ng-template>` tag
- * with the `kendoFloatingActionButtonTemplate` directive inside the `<kendo-floatingactionbutton>` tag
- * ([see example]({% slug templates_floatingactionbutton %}#toc-floatingactionbutton-template)).
+ * To define the template, nest an `<ng-template>` tag with the `kendoFloatingActionButtonTemplate` directive inside the `<kendo-floatingactionbutton>` tag
+ *
+ * ([see example](slug:templates_floatingactionbutton#floatingactionbutton-template)).
+ *
+ * @example
+ * ```html
+ * <kendo-floatingactionbutton>
+ *     <ng-template kendoFloatingActionButtonTemplate>
+ *         Custom Content
+ *     </ng-template>
+ * </kendo-floatingactionbutton>
+ * ```
  */
 export declare class FloatingActionButtonTemplateDirective {
     templateRef: TemplateRef<any>;

package/listbutton/button-item-template.directive.d.ts

@@ -5,49 +5,27 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Used for rendering the list item content.
+ * Renders the list item content.
  *
  * To define the item template, nest a `<ng-template>` tag with the `kendo<ComponentName>ItemTemplate` directive inside the component tag.
  *
- * For the DropDownButton, use the `kendoDropDownButtonItemTemplate` directive.
- * For the SplitButton, use the `kendoSplitButtonItemTemplate` directive.
+ * - Use the `kendoDropDownButtonItemTemplate` directive for the DropDownButton.
+ * - Use the `kendoSplitButtonItemTemplate` directive for the SplitButton.
  *
- * The template context is set to the current component. To get a reference to the current data item, use the `let-dataItem` directive.
+ * The template context is set to the current component. Use the `let-dataItem` directive to reference the current data item.
  *
  * @example
- * ```ts
- * _@Component({
- * selector: 'my-app',
- * template: `
- *  <kendo-splitbutton [data]="listItems">
- *    <ng-template kendoSplitButtonItemTemplate let-dataItem>
- *      <span>{{dataItem}} option</span>
- *    </ng-template>
- *  </kendo-splitbutton>
- *  <kendo-dropdownbutton [data]="listItems">
- *    <ng-template kendoDropDownButtonItemTemplate let-dataItem>
- *      <span>{{dataItem}} option</span>
- *    </ng-template>
- *  </kendo-dropdownbutton>
- * `
- * })
- * class AppComponent {
- *   public listItems: Array<any> = [{
- *      text: 'item1',
- *      icon: 'arrow-rotate-cw',
- *      disabled: false,
- *      click: (dataItem: any) => {
- *          //action
- *      }
- *  }, {
- *      text: 'item2',
- *      icon: 'arrow-rotate-cw',
- *      disabled: false,
- *      click: (dataItem: any) => {
- *          //action
- *      }
- *  }]
- * }
+ * ```html
+ * <kendo-splitbutton [data]="listItems">
+ *   <ng-template kendoSplitButtonItemTemplate let-dataItem>
+ *     <span>{{dataItem}} option</span>
+ *   </ng-template>
+ * </kendo-splitbutton>
+ * <kendo-dropdownbutton [data]="listItems">
+ *   <ng-template kendoDropDownButtonItemTemplate let-dataItem>
+ *     <span>{{dataItem}} option</span>
+ *   </ng-template>
+ * </kendo-dropdownbutton>
  * ```
  *
  * For more examples, refer to the article on the [DropDownButton templates](slug:itemstemplates_dropdownbutton).

package/listbutton/list-button.d.ts

@@ -49,26 +49,30 @@ export declare class ListButton extends MultiTabStop implements OnDestroy {
     container: ViewContainerRef;
     /**
      * Sets the disabled state of the DropDownButton.
+     * When `true`, the button is disabled and cannot be interacted with.
      */
     set disabled(value: boolean);
     get disabled(): boolean;
     /**
      * Specifies the [`tabIndex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
+     * Determines the order of focus when navigating with the keyboard.
+     *
+     * @default 0
      */
     tabIndex: number;
     /**
-     * The CSS classes that will be rendered on the main button.
-     * Supports the type of values that are supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
+     * The CSS classes applied to the main button.
+     * Supports the same values as [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     buttonClass: any;
     /**
-     * Fires each time the popup is about to open.
-     * This event is preventable. If you cancel the event, the popup will remain closed.
+     * Fires when the popup is about to open.
+     * This event is preventable. Canceling the event keeps the popup closed.
      */
     open: EventEmitter<PreventableEvent>;
     /**
-     * Fires each time the popup is about to close.
-     * This event is preventable. If you cancel the event, the popup will remain open.
+     * Fires when the popup is about to close.
+     * This event is preventable. Canceling the event keeps the popup open.
      */
     close: EventEmitter<PreventableEvent>;
     /**
@@ -84,12 +88,6 @@ export declare class ListButton extends MultiTabStop implements OnDestroy {
     private get appendTo();
     /**
      * Configures the popup of the DropDownButton.
-     *
-     * The available options are:
-     * - `animate: Boolean`&mdash;Controls the popup animation. By default, the open and close animations are enabled.
-     * - `popupClass: String`&mdash;Specifies a list of CSS classes that are used to style the popup.
-     * - `appendTo: "root" | "component" | ViewContainerRef`&mdash;Specifies the component to which the popup will be appended.
-     * - `align: "left" | "center" | "right"`&mdash;Specifies the alignment of the popup.
      */
     set popupSettings(settings: PopupSettings);
     get popupSettings(): PopupSettings;
@@ -129,9 +127,9 @@ export declare class ListButton extends MultiTabStop implements OnDestroy {
     protected subscribeNavigationEvents(): void;
     /**
      * Toggles the visibility of the popup.
-     * If the `toggle` method is used to open or close the popup, the `open` and `close` events will not be fired.
+     * If the `toggle` method is used, the `open` and `close` events are not fired.
      *
-     * @param open - The state of the popup.
+     * @param open - The desired state of the popup.
      */
     toggle(open: boolean): void;
     /**

package/listbutton/list-item-model.d.ts

@@ -8,15 +8,15 @@ import { SVGIcon } from "@progress/kendo-svg-icons";
  *
  * @example
  *
- * ```ts-preview
- * _@Component({
+ * ```typescript
+ * @Component({
  * selector: 'my-app',
  * template: `
- *  <kendo-splitbutton [data]="listItems">SplitButton</kendo-splitbutton>
+ *  <kendo-splitbutton [data]="items">SplitButton</kendo-splitbutton>
  * `
  * })
  * class AppComponent {
- *   public listItems: ListItemModel[] = [{
+ *   public items: ListItemModel[] = [{
  *      text: 'item1',
  *      icon: 'arrow-rotate-cw',
  *      click: (dataItem: any) => {
@@ -28,18 +28,6 @@ import { SVGIcon } from "@progress/kendo-svg-icons";
  *      click: (dataItem: any) => {
  *          //action
  *      }
- *  }, {
- *      text: 'item3',
- *      imageUrl: 'https://demos.telerik.com/kendo-ui/content/web/toolbar/upload.png',
- *      click: (dataItem: any) => {
- *          //action
- *      }
- *  }, {
- *      text: 'item4',
- *      disabled: true,
- *      click: (dataItem: any) => {
- *          //action
- *      }
  *  }]
  * }
  * ```
@@ -50,35 +38,35 @@ export interface ListItemModel {
      */
     text?: string;
     /**
-     * Defines an icon to be rendered next to the title.
+     * Defines an icon rendered next to the title.
      */
     icon?: string;
     /**
-     * Defines an [SVGIcon](slug:api_icons_svgicon) to be rendered next to the title.
+     * Defines an [SVGIcon](slug:api_icons_svgicon) rendered next to the title.
      */
     svgIcon?: SVGIcon;
     /**
-     * Defines an icon with a custom CSS class to be rendered next to the title.
+     * Defines an icon with a custom CSS class rendered next to the title.
      */
     iconClass?: string;
     /**
-     * Defines the location of an image to be displayed next to the title.
+     * Specifies the location of an image displayed next to the title.
      */
     imageUrl?: string;
     /**
-     * Defines the value of the image element `alt` attribute.
+     * Specifies the value of the image element `alt` attribute.
      */
     imageAlt?: string;
     /**
-     * When set to `true`, disables a button list item.
+     * Disables the button list item when set to `true`.
      */
     disabled?: boolean;
     /**
-     * The CSS classes that will be rendered on the item element. Supports the type of values that are supported by ngClass.
+     * Specifies the CSS classes rendered on the item element. Supports the same values as `ngClass`.
      */
     cssClass?: any;
     /**
-     * An event handler that is emitted when an item is clicked.
+      * Emits an event when the item is clicked.
      */
     click?: (dataItem?: any) => void;
 }