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

package/esm2022/dropdownbutton/dropdownbutton.component.mjs

@@ -33,28 +33,26 @@ const DEFAULT_FILL_MODE = 'solid';
 /**
  * Represents the Kendo UI DropDownButton component for Angular.
  *
+ * Use the DropDownButton to display a button with a popup list of actions.
+ *
  * @example
  * ```ts
- * _@Component({
- * selector: 'my-app',
- * template: `
- *  <kendo-dropdownbutton [data]="data">
- *    User Settings
- *  </kendo-dropdownbutton>
- * `
+ * @Component({
+ *   selector: 'my-app',
+ *   template: `
+ *     <kendo-dropdownbutton [data]="data">
+ *       User Settings
+ *     </kendo-dropdownbutton>
+ *   `
  * })
  * class AppComponent {
- *   public data: Array<any> = [{
- *       text: 'My Profile'
- *   }, {
- *       text: 'Friend Requests'
- *   }, {
- *       text: 'Account Settings'
- *   }, {
- *       text: 'Support'
- *   }, {
- *       text: 'Log Out'
- *   }];
+ *   public data: Array<any> = [
+ *     { text: 'My Profile' },
+ *     { text: 'Friend Requests' },
+ *     { text: 'Account Settings' },
+ *     { text: 'Support' },
+ *     { text: 'Log Out' }
+ *   ];
  * }
  * ```
  */
@@ -62,35 +60,33 @@ export class DropDownButtonComponent extends ListButton {
     containerService;
     renderer;
     /**
-     * Allows showing the default arrow icon or providing alternative one instead.
+     * Displays the default arrow icon or a custom one.
      * @default false
      */
     arrowIcon = false;
     /**
-     * Defines the name of an existing icon in the Kendo UI theme.
+     * Specifies the name of an existing icon in the Kendo UI theme.
      */
     icon = '';
     /**
-     * Defines an [`SVGIcon`](slug:api_icons_svgicon) to be rendered within the button.
+     * Specifies an [`SVGIcon`](slug:api_icons_svgicon) to render within the button.
      */
     svgIcon;
     /**
-     * Defines the list of CSS classes which are used for styling the Button with custom icons.
+     * Specifies a list of CSS classes for styling the button with custom icons.
      */
     iconClass = '';
     /**
-     * Defines a URL for styling the button with a custom image.
+     * Specifies a URL for styling the button with a custom image.
      */
     imageUrl = '';
     /**
      * Sets the data item field that represents the item text.
-     * If the data contains only primitive values, do not define it.
+     * If the data contains only primitive values, leave this undefined.
      */
     textField;
     /**
-     * Sets or gets the data of the DropDownButton.
-     *
-     * > The data has to be provided in an array-like list.
+     * Sets or gets the data of the DropDownButton. Provide the data as an array-like list.
      */
     set data(data) {
         this._data = data || [];
@@ -99,38 +95,18 @@ export class DropDownButtonComponent extends ListButton {
         return this._data;
     }
     /**
-     * The size property specifies the padding of the DropDownButton
-     * ([see example]({% slug api_buttons_dropdownbuttoncomponent %}#toc-size)).
-     *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * Specifies the padding of the DropDownButton. See [DropDownButton Appearance](slug:appearance_dropdownbutton#size).
+     * @default 'medium'
      */
     size = 'medium';
     /**
-     * The rounded property specifies the border radius of the DropDownButton
-     * ([see example]({% slug api_buttons_dropdownbuttoncomponent %}#toc-rounded)).
-     *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `full`
-     * * `none`
+     * Specifies the border radius of the DropDownButton. See [DropDownButton Appearance](slug:appearance_dropdownbutton#roundness).
+     * @default 'medium'
      */
     rounded = 'medium';
     /**
-     * The fillMode property specifies the background and border styles of the DropDownButton
-     * ([see example]({% slug api_buttons_dropdownbuttoncomponent %}#toc-fillMode)).
-     *
-     * The available values are:
-     * * `solid` (default)
-     * * `flat`
-     * * `outline`
-     * * `link`
-     * * `none`
+     * Specifies the background and border styles of the DropDownButton. See [DropDownButton Appearance](slug:appearance_dropdownbutton#fill-mode).
+     * @default 'solid'
      */
     set fillMode(fillMode) {
         this._fillMode = fillMode === 'clear' ? 'flat' : fillMode;
@@ -139,27 +115,12 @@ export class DropDownButtonComponent extends ListButton {
         return this._fillMode;
     }
     /**
-     * The DropDownButton allows you to specify predefined theme colors.
-     * The theme color will be applied as a background and border color while also amending the text color accordingly
-     * ([see example]({% slug api_buttons_dropdownbuttoncomponent %}#toc-themeColor)).
-     *
-     * The possible values are:
-     * * `base` &mdash;Applies coloring based on the `base` theme color. (default)
-     * * `primary` &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 default CSS class (no class would be rendered).
+     * Specifies predefined theme colors for the DropDownButton. See [DropDownButton Appearance](slug:appearance_dropdownbutton#theme-colors).
+     * @default 'base'
      */
     themeColor = 'base';
     /**
-     * Sets attributes to the main button.
+     * Sets attributes for the main button.
      */
     set buttonAttributes(buttonAttributes) {
         const newButtonAttributes = buttonAttributes ? buttonAttributes : null;
@@ -170,15 +131,16 @@ export class DropDownButtonComponent extends ListButton {
         return this._buttonAttributes;
     }
     /**
-     * Fires each time the user clicks on a drop-down list item. The event data contains the data item bound to the clicked list item.
+     * Fires when the user clicks a drop-down list item.
+     * The event data contains the data item bound to the clicked list item.
      */
     itemClick = new EventEmitter();
     /**
-     * Fires each time the DropDownButton gets focused.
+     * Fires when the DropDownButton is focused.
      */
     onFocus = new EventEmitter();
     /**
-     * Fires each time the DropDownButton gets blurred.
+     * Fires when the DropDownButton is blurred.
      */
     onBlur = new EventEmitter();
     get focused() {
@@ -253,7 +215,7 @@ export class DropDownButtonComponent extends ListButton {
         }
     }
     /**
-     * Focuses the DropDownButton component.
+     * Focuses the DropDownButton.
      */
     focus() {
         if (isDocumentAvailable()) {
@@ -261,7 +223,7 @@ export class DropDownButtonComponent extends ListButton {
         }
     }
     /**
-     * Blurs the DropDownButton component.
+     * Blurs the DropDownButton.
      */
     blur() {
         if (isDocumentAvailable()) {

package/esm2022/dropdownbutton/dropdownbutton.module.mjs

@@ -12,12 +12,28 @@ import * as i1 from "./dropdownbutton.component";
 import * as i2 from "../listbutton/button-item-template.directive";
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
+ * Exports the package module.
  *
- * The exported package module.
+ * Required for adding DropDownButton features in NgModule-based Angular applications.
  *
- * The package exports:
- * - `DropDownButtonComponent`—The DropDownButtonComponent component class.
- * - `ButtonItemTemplateDirective`—The Button item template directive.
+ * The module includes:
+ * - `DropDownButtonComponent`—The component class for the DropDownButton.
+ * - `ButtonItemTemplateDirective`—The directive for the button item template.
+ *
+ * @example
+ * ```typescript
+ * import { DropDownButtonModule } from '@progress/kendo-angular-buttons';
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, DropDownButtonModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 export class DropDownButtonModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: DropDownButtonModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });

package/esm2022/floatingactionbutton/floatingactionbutton.component.mjs

@@ -57,10 +57,17 @@ const DEFAULT_ROUNDED = 'full';
 const DEFAULT_SIZE = 'medium';
 const DEFAULT_THEME_COLOR = 'primary';
 /**
+ * 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 class FloatingActionButtonComponent {
     renderer;
@@ -83,22 +90,8 @@ export class FloatingActionButtonComponent {
     dialItemTemplate;
     fabTemplate;
     /**
-     * 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) {
         const newThemeColor = themeColor ? themeColor : DEFAULT_THEME_COLOR;
@@ -109,14 +102,8 @@ export class FloatingActionButtonComponent {
         return this._themeColor;
     }
     /**
-     * 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) {
         const newSize = size ? size : DEFAULT_SIZE;
@@ -127,14 +114,9 @@ export class FloatingActionButtonComponent {
         return this._size;
     }
     /**
-     * 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) {
         const newRounded = rounded ? rounded : DEFAULT_ROUNDED;
@@ -146,6 +128,7 @@ export class FloatingActionButtonComponent {
     }
     /**
      * Specifies whether the FloatingActionButton is disabled.
+     * @default false
      */
     set disabled(disabled) {
         this._disabled = disabled;
@@ -154,15 +137,8 @@ export class FloatingActionButtonComponent {
         return this._disabled;
     }
     /**
-     * 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) {
         this._align = Object.assign(this._align, align);
@@ -171,11 +147,8 @@ export class FloatingActionButtonComponent {
         return this._align;
     }
     /**
-     * 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) {
         this._offset = Object.assign(this._offset, offset);
@@ -185,17 +158,12 @@ export class FloatingActionButtonComponent {
         return this._offset;
     }
     /**
-     * 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 = 'fixed';
     /**
      * 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;
     /**
@@ -203,8 +171,7 @@ export class FloatingActionButtonComponent {
      */
     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;
     /**
@@ -223,46 +190,37 @@ export class FloatingActionButtonComponent {
     text;
     /**
      * 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 = true;
     /**
      * Specifies the [`tabIndex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the FloatingActionButton.
+     * @default 0
      */
     tabIndex = 0;
     /**
-     * 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 = [];
     /**
-     * Fires each time the FloatingActionButton gets blurred.
+     * Fires when the FloatingActionButton is blurred.
      */
     onBlur = new EventEmitter();
     /**
-     * Fires each time the FloatingActionButton gets focused.
+     * Fires when the FloatingActionButton is focused.
      */
     onFocus = new EventEmitter();
     /**
-     * Fires each time a dial item is clicked.
+     * Fires when a dial item is clicked.
      */
     dialItemClick = new EventEmitter();
     /**
-     * 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 = new EventEmitter();
     /**
-     * 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 = new EventEmitter();

package/esm2022/floatingactionbutton/floatingactionbutton.module.mjs

@@ -11,33 +11,25 @@ import * as i0 from "@angular/core";
 import * as i1 from "./floatingactionbutton.component";
 import * as i2 from "./templates/dial-item-template.directive";
 import * as i3 from "./templates/fab-template.directive";
-//IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * 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 class FloatingActionButtonModule {

package/esm2022/floatingactionbutton/templates/dial-item-template.directive.mjs

@@ -5,10 +5,18 @@
 import { Directive, Optional, 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 class DialItemTemplateDirective {
     templateRef;

package/esm2022/floatingactionbutton/templates/fab-template.directive.mjs

@@ -6,9 +6,18 @@ import { Directive, Optional, 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 class FloatingActionButtonTemplateDirective {
     templateRef;

package/esm2022/listbutton/button-item-template.directive.mjs

@@ -5,49 +5,27 @@
 import { Directive, 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/esm2022/listbutton/list-button.mjs

@@ -58,6 +58,7 @@ export class ListButton extends MultiTabStop {
     container;
     /**
      * Sets the disabled state of the DropDownButton.
+     * When `true`, the button is disabled and cannot be interacted with.
      */
     set disabled(value) {
         if (value && this.openState) {
@@ -70,21 +71,24 @@ export class ListButton extends MultiTabStop {
     }
     /**
      * 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 = 0;
     /**
-     * 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;
     /**
-     * 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 = new EventEmitter();
     /**
-     * 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 = new EventEmitter();
     /**
@@ -108,12 +112,6 @@ export class ListButton extends MultiTabStop {
     }
     /**
      * Configures the popup of the DropDownButton.
-     *
-     * The available options are:
-     * - `animate: Boolean`—Controls the popup animation. By default, the open and close animations are enabled.
-     * - `popupClass: String`—Specifies a list of CSS classes that are used to style the popup.
-     * - `appendTo: "root" | "component" | ViewContainerRef`—Specifies the component to which the popup will be appended.
-     * - `align: "left" | "center" | "right"`—Specifies the alignment of the popup.
      */
     set popupSettings(settings) {
         this._popupSettings = Object.assign({ animate: true, popupClass: '' }, settings);
@@ -250,9 +248,9 @@ export class ListButton extends MultiTabStop {
     }
     /**
      * 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) {
         if (this.disabled) {