@syncfusion/ej2-dropdowns 25.2.3 → 25.2.5-30068

package/src/drop-down-base/drop-down-base.js

@@ -1,22 +1,22 @@
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
 import { Component, EventHandler, addClass, append, Property, Event, L10n, compile } from '@syncfusion/ej2-base';
 import { setStyleAttribute, extend, removeClass, prepend, isNullOrUndefined, detach, getValue } from '@syncfusion/ej2-base';
 import { NotifyPropertyChanges, rippleEffect, ChildProperty, Complex } from '@syncfusion/ej2-base';
@@ -87,7 +87,6 @@ var DropDownBase = /** @class */ (function (_super) {
     function DropDownBase(options, element) {
         var _this = _super.call(this, options, element) || this;
         _this.preventChange = false;
-        _this.isAngular = false;
         _this.isPreventChange = false;
         _this.isDynamicDataChange = false;
         _this.addedNewItem = false;
@@ -130,6 +129,8 @@ var DropDownBase = /** @class */ (function (_super) {
         _this.appendUncheckList = false;
         _this.getInitialData = false;
         _this.preventPopupOpen = true;
+        _this.virtualSelectAllState = false;
+        _this.CurrentEvent = null;
         _this.virtualListInfo = {
             currentPageNumber: null,
             direction: null,
@@ -729,8 +730,8 @@ var DropDownBase = /** @class */ (function (_super) {
                                     if (!isWhereExist_1) {
                                         _this.remoteDataCount = e.count;
                                     }
-                                    _this.dataCount = e.count;
-                                    _this.totalItemCount = e.count;
+                                    _this.dataCount = !_this.virtualSelectAll ? e.count : _this.dataCount;
+                                    _this.totalItemCount = !_this.virtualSelectAll ? e.count : _this.totalItemCount;
                                     ulElement = _this.renderItems(listItems, fields);
                                     _this.appendUncheckList = false;
                                     _this.onActionComplete(ulElement, listItems, e);
@@ -756,6 +757,12 @@ var DropDownBase = /** @class */ (function (_super) {
                                     if (_this.isVirtualizationEnabled) {
                                         _this.getFilteringSkeletonCount();
                                     }
+                                    if (_this.virtualSelectAll && _this.virtualSelectAllData) {
+                                        _this.virtualSelectionAll(_this.virtualSelectAllState, _this.liCollections, _this.CurrentEvent);
+                                        _this.virtualSelectAllState = false;
+                                        _this.CurrentEvent = null;
+                                        _this.virtualSelectAll = false;
+                                    }
                                 }
                             });
                         }).catch(function (e) {
@@ -807,11 +814,11 @@ var DropDownBase = /** @class */ (function (_super) {
                                 }
                             }
                         }
-                        if (isReOrder && (!(_this.dataSource instanceof DataManager) && !_this.isCustomDataUpdated)) {
+                        if (isReOrder && (!(_this.dataSource instanceof DataManager) && !_this.isCustomDataUpdated) && !_this.virtualSelectAll) {
                             // eslint-disable @typescript-eslint/no-explicit-any
                             _this.dataCount = _this.totalItemCount = _this.virtualSelectAll ? listItems.length : listItems.count;
                         }
-                        listItems = _this.isVirtualizationEnabled && !_this.virtualSelectAll ? listItems.result : listItems;
+                        listItems = _this.isVirtualizationEnabled ? listItems.result : listItems;
                         // eslint-enable @typescript-eslint/no-explicit-any
                         var localDataArgs = { cancel: false, result: listItems };
                         _this.isPreventChange = _this.isAngular && _this.preventChange ? true : _this.isPreventChange;
@@ -850,6 +857,9 @@ var DropDownBase = /** @class */ (function (_super) {
     DropDownBase.prototype.updatePopupState = function () {
         // Used this method in component side.
     };
+    DropDownBase.prototype.virtualSelectionAll = function (state, li, event) {
+        // Used this method in component side.
+    };
     DropDownBase.prototype.updateRemoteData = function () {
         this.setListData(this.dataSource, this.fields, this.query);
     };
@@ -1147,10 +1157,14 @@ var DropDownBase = /** @class */ (function (_super) {
         }
     };
     DropDownBase.prototype.updateGroupFixedHeader = function (element, target) {
-        this.fixedHeaderElement.innerHTML = element.innerHTML;
-        this.fixedHeaderElement.style.position = 'fixed';
-        this.fixedHeaderElement.style.top = this.list.parentElement.offsetTop + this.list.offsetTop + 'px';
-        this.fixedHeaderElement.style.display = 'block';
+        if (this.fixedHeaderElement) {
+            if (!isNullOrUndefined(element.innerHTML)) {
+                this.fixedHeaderElement.innerHTML = element.innerHTML;
+            }
+            this.fixedHeaderElement.style.position = 'fixed';
+            this.fixedHeaderElement.style.top = (this.list.parentElement.offsetTop + this.list.offsetTop) - window.scrollY + 'px';
+            this.fixedHeaderElement.style.display = 'block';
+        }
     };
     DropDownBase.prototype.getValidLi = function () {
         if (this.isVirtualizationEnabled) {
@@ -1341,12 +1355,15 @@ var DropDownBase = /** @class */ (function (_super) {
      * @param {string | number | boolean} value - Specifies given value.
      * @returns {number} Returns the index of the item.
      */
-    DropDownBase.prototype.getIndexByValueFilter = function (value) {
+    DropDownBase.prototype.getIndexByValueFilter = function (value, ulElement) {
         var index;
-        var listItems = this.renderItems(this.selectData, this.fields);
-        if (listItems && listItems.children) {
-            for (var i = 0; i < listItems.children.length; i++) {
-                if (!isNullOrUndefined(value) && listItems.children[i].getAttribute('data-value') === value.toString()) {
+        if (!ulElement) {
+            return null;
+        }
+        var listItems = ulElement.querySelectorAll('li' + ':not(.e-list-group-item)');
+        if (listItems) {
+            for (var i = 0; i < listItems.length; i++) {
+                if (!isNullOrUndefined(value) && listItems[i].getAttribute('data-value') === value.toString()) {
                     index = i;
                     break;
                 }
@@ -1508,6 +1525,7 @@ var DropDownBase = /** @class */ (function (_super) {
         var group = this.element.querySelector('select>optgroup');
         if ((this.fields.groupBy || !isNullOrUndefined(group)) && !this.isGroupChecking) {
             EventHandler.add(this.list, 'scroll', this.setFloatingHeader, this);
+            EventHandler.add(document, 'scroll', this.updateGroupFixedHeader, this);
         }
         if (this.getModuleName() === 'dropdownbase') {
             if (this.element.getAttribute('tabindex')) {
@@ -1556,7 +1574,7 @@ var DropDownBase = /** @class */ (function (_super) {
      * @param { Object[] } items - Specifies an array of JSON data or a JSON data.
      * @param { number } itemIndex - Specifies the index to place the newly added item in the popup list.
      * @returns {void}
-
+     * @deprecated
      */
     DropDownBase.prototype.addItem = function (items, itemIndex) {
         if (!this.list || (this.list.textContent === this.noRecordsTemplate && this.getModuleName() !== 'listbox')) {
@@ -1761,12 +1779,15 @@ var DropDownBase = /** @class */ (function (_super) {
      * @returns {void}
      */
     DropDownBase.prototype.destroy = function () {
-        if (document.body.contains(this.list)) {
-            EventHandler.remove(this.list, 'scroll', this.setFloatingHeader);
-            if (!isNullOrUndefined(this.rippleFun)) {
-                this.rippleFun();
+        if (document) {
+            EventHandler.remove(document, 'scroll', this.updateGroupFixedHeader);
+            if (document.body.contains(this.list)) {
+                EventHandler.remove(this.list, 'scroll', this.setFloatingHeader);
+                if (!isNullOrUndefined(this.rippleFun)) {
+                    this.rippleFun();
+                }
+                detach(this.list);
             }
-            detach(this.list);
         }
         this.liCollections = null;
         this.ulElement = null;

package/src/drop-down-list/drop-down-list-model.d.ts

@@ -1,4 +1,4 @@
-import { EventHandler, Property, Event, compile, EmitType, KeyboardEvents, append, select, ModuleDeclaration } from '@syncfusion/ej2-base';import { attributes, isNullOrUndefined, getUniqueID, formatUnit, isUndefined, getValue } from '@syncfusion/ej2-base';import { Animation, AnimationModel, Browser, KeyboardEventArgs, NotifyPropertyChanges } from '@syncfusion/ej2-base';import { addClass, removeClass, closest, prepend, detach, classList } from '@syncfusion/ej2-base';import { Popup, isCollide, createSpinner, showSpinner, hideSpinner } from '@syncfusion/ej2-popups';import { IInput, Input, InputObject, FloatLabelType } from '@syncfusion/ej2-inputs';import { incrementalSearch, resetIncrementalSearchValues } from '../common/incremental-search';import { DropDownBase, dropDownBaseClasses, SelectEventArgs, FilteringEventArgs, PopupEventArgs } from '../drop-down-base/drop-down-base';import { FocusEventArgs, ResultData, BeforeOpenEventArgs } from '../drop-down-base/drop-down-base';import { FieldSettingsModel } from '../drop-down-base/drop-down-base-model';import { DataManager, Query, Predicate, DataOptions } from '@syncfusion/ej2-data';import {VirtualScroll, Offsets, ScrollDirection, SentinelType, VirtualInfo} from '../common/virtual-scroll';import { Skeleton } from '@syncfusion/ej2-notifications';
+import { EventHandler, Property, Event, compile, EmitType, KeyboardEvents, append, select, ModuleDeclaration } from '@syncfusion/ej2-base';
 import {ChangeEventArgs} from "./drop-down-list";
 import {DropDownBaseModel} from "../drop-down-base/drop-down-base-model";
 
@@ -8,269 +8,269 @@ import {DropDownBaseModel} from "../drop-down-base/drop-down-base-model";
 export interface DropDownListModel extends DropDownBaseModel{
 
     /**
-     * Sets CSS classes to the root element of the component that allows customization of appearance.
-     *
-     * @default null
-     */
-    cssClass?: string;
+     * Sets CSS classes to the root element of the component that allows customization of appearance.
+     *
+     * @default null
+     */
+    cssClass?: string;
 
     /**
-     * Specifies the width of the component. By default, the component width sets based on the width of
-     * its parent container. You can also set the width in pixel values.
-     *
-     * @default '100%'
-     * @aspType string
-     */
-    width?: string | number;
+     * Specifies the width of the component. By default, the component width sets based on the width of
+     * its parent container. You can also set the width in pixel values.
+     *
+     * @default '100%'
+     * @aspType string
+     */
+    width?: string | number;
 
     /**
-     * Specifies a value that indicates whether the component is enabled or not.
-     *
-     * @default true
-
-     */
-    enabled?: boolean;
+     * Specifies a value that indicates whether the component is enabled or not.
+     *
+     * @default true
+     * @deprecated
+     */
+    enabled?: boolean;
 
     /**
-     * Enable or disable persisting component's state between page reloads.
-     * If enabled, following list of states will be persisted.
-     * 1. value
-     *
-     * @default false
-
-     */
-    enablePersistence?: boolean;
+     * Enable or disable persisting component's state between page reloads.
+     * If enabled, following list of states will be persisted.
+     * 1. value
+     *
+     * @default false
+     * @deprecated
+     */
+    enablePersistence?: boolean;
 
     /**
-     * Specifies the height of the popup list.
-     * > For more details about the popup configuration refer to
-     * [`Popup Configuration`](../../drop-down-list/getting-started#configure-the-popup-list) documentation.
-     *
-     * @default '300px'
-     * @aspType string
-     */
-    popupHeight?: string | number;
+     * Specifies the height of the popup list.
+     * > For more details about the popup configuration refer to
+     * [`Popup Configuration`](../../drop-down-list/getting-started#configure-the-popup-list) documentation.
+     *
+     * @default '300px'
+     * @aspType string
+     */
+    popupHeight?: string | number;
 
     /**
-     * Specifies the width of the popup list. By default, the popup width sets based on the width of
-     * the component.
-     * > For more details about the popup configuration refer to
-     * [`Popup Configuration`](../../drop-down-list/getting-started#configure-the-popup-list) documentation.
-     *
-     * @default '100%'
-     * @aspType string
-     */
-    popupWidth?: string | number;
+     * Specifies the width of the popup list. By default, the popup width sets based on the width of
+     * the component.
+     * > For more details about the popup configuration refer to
+     * [`Popup Configuration`](../../drop-down-list/getting-started#configure-the-popup-list) documentation.
+     *
+     * @default '100%'
+     * @aspType string
+     */
+    popupWidth?: string | number;
 
     /**
-     * Specifies a short hint that describes the expected value of the DropDownList component.
-     *
-     * @default null
-     */
-    placeholder?: string;
+     * Specifies a short hint that describes the expected value of the DropDownList component.
+     *
+     * @default null
+     */
+    placeholder?: string;
 
     /**
-     * Accepts the value to be displayed as a watermark text on the filter bar.
-     *
-     * @default null
-     */
-    filterBarPlaceholder?: string;
+     * Accepts the value to be displayed as a watermark text on the filter bar.
+     *
+     * @default null
+     */
+    filterBarPlaceholder?: string;
 
     /**
-     * Allows additional HTML attributes such as title, name, etc., and
-     * accepts n number of attributes in a key-value pair format.
-     *
-     * {% codeBlock src='dropdownlist/htmlAttributes/index.md' %}{% endcodeBlock %}
-     *
-     * @default {}
-     */
-    htmlAttributes?: { [key: string]: string };
+     * Allows additional HTML attributes such as title, name, etc., and
+     * accepts n number of attributes in a key-value pair format.
+     *
+     * {% codeBlock src='dropdownlist/htmlAttributes/index.md' %}{% endcodeBlock %}
+     *
+     * @default {}
+     */
+    htmlAttributes?: { [key: string]: string };
 
     /**
-     * Accepts the external `Query`
-     * that execute along with data processing.
-     *
-     * {% codeBlock src='dropdownlist/query/index.md' %}{% endcodeBlock %}
-     *
-     * @default null
-
-     */
-    query?: Query;
+     * Accepts the external `Query`
+     * that execute along with data processing.
+     *
+     * {% codeBlock src='dropdownlist/query/index.md' %}{% endcodeBlock %}
+     *
+     * @default null
+     * @deprecated
+     */
+    query?: Query;
 
     /**
-     * Accepts the template design and assigns it to the selected list item in the input element of the component.
-     * For more details about the available template options refer to
-     * [`Template`](../../drop-down-list/templates) documentation.
-     *
-     * We have built-in `template engine`
-     * which provides options to compile template string into a executable function.
-     * For EX: We have expression evolution as like ES6 expression string literals.
-     *
-     * @default null
-     * @aspType string
-     */
-    valueTemplate?: string | Function;
+     * Accepts the template design and assigns it to the selected list item in the input element of the component.
+     * For more details about the available template options refer to
+     * [`Template`](../../drop-down-list/templates) documentation.
+     *
+     * We have built-in `template engine`
+     * which provides options to compile template string into a executable function.
+     * For EX: We have expression evolution as like ES6 expression string literals.
+     *
+     * @default null
+     * @aspType string
+     */
+    valueTemplate?: string | Function;
 
     /**
-     * Accepts the template design and assigns it to the header container of the popup list.
-     * > For more details about the available template options refer to [`Template`](../../drop-down-list/templates) documentation.
-     *
-     * @default null
-     * @aspType string
-     */
-    headerTemplate?: string | Function;
+     * Accepts the template design and assigns it to the header container of the popup list.
+     * > For more details about the available template options refer to [`Template`](../../drop-down-list/templates) documentation.
+     *
+     * @default null
+     * @aspType string
+     */
+    headerTemplate?: string | Function;
 
     /**
-     * Accepts the template design and assigns it to the footer container of the popup list.
-     * > For more details about the available template options refer to [`Template`](../../drop-down-list/templates) documentation.
-     *
-     * @default null
-     * @aspType string
-     */
-    footerTemplate?: string | Function;
+     * Accepts the template design and assigns it to the footer container of the popup list.
+     * > For more details about the available template options refer to [`Template`](../../drop-down-list/templates) documentation.
+     *
+     * @default null
+     * @aspType string
+     */
+    footerTemplate?: string | Function;
 
     /**
-     * When allowFiltering is set to true, show the filter bar (search box) of the component.
-     * The filter action retrieves matched items through the `filtering` event based on
-     * the characters typed in the search TextBox.
-     *
-     * If no match is found, the value of the `noRecordsTemplate` property will be displayed.
-     * > For more details about the filtering refer to [`Filtering`](../../drop-down-list/filtering) documentation.
-     *
-     * {% codeBlock src="dropdownlist/allow-filtering-api/index.ts" %}{% endcodeBlock %}
-     *
-     * {% codeBlock src="dropdownlist/allow-filtering-api/index.html" %}{% endcodeBlock %}
-     *
-     * @default false
-     */
-    allowFiltering?: boolean;
+     * When allowFiltering is set to true, show the filter bar (search box) of the component.
+     * The filter action retrieves matched items through the `filtering` event based on
+     * the characters typed in the search TextBox.
+     *
+     * If no match is found, the value of the `noRecordsTemplate` property will be displayed.
+     * > For more details about the filtering refer to [`Filtering`](../../drop-down-list/filtering) documentation.
+     *
+     * {% codeBlock src="dropdownlist/allow-filtering-api/index.ts" %}{% endcodeBlock %}
+     *
+     * {% codeBlock src="dropdownlist/allow-filtering-api/index.html" %}{% endcodeBlock %}
+     *
+     * @default false
+     */
+    allowFiltering?: boolean;
 
     /**
-     * When set to true, the user interactions on the component are disabled.
-     *
-     * @default false
-     */
-    readonly?: boolean;
+     * When set to true, the user interactions on the component are disabled.
+     *
+     * @default false
+     */
+    readonly?: boolean;
 
     /**
-     * Defines whether to enable virtual scrolling in the component. 
-     *
-     * @default false
-     */
-    enableVirtualization?: boolean;
+     * Defines whether to enable virtual scrolling in the component. 
+     *
+     * @default false
+     */
+    enableVirtualization?: boolean;
 
     /**
-     * Gets or sets the display text of the selected item in the component.
-     *
-     * @default null
-     * @aspType string
-     */
-    text?: string | null;
+     * Gets or sets the display text of the selected item in the component.
+     *
+     * @default null
+     * @aspType string
+     */
+    text?: string | null;
 
     /**
-     * Gets or sets the value of the selected item in the component.
-     *
-     * @default null
-     * @isGenericType true
-     */
-    value?: number | string | boolean | object | null;
+     * Gets or sets the value of the selected item in the component.
+     *
+     * @default null
+     * @isGenericType true
+     */
+    value?: number | string | boolean | object | null;
 
     /**
-    * Defines whether the object binding is allowed or not in the component.
-    *
-    * @default false
-    */
-    allowObjectBinding?: boolean; 
+    * Defines whether the object binding is allowed or not in the component.
+    *
+    * @default false
+    */
+    allowObjectBinding?: boolean; 
 
     /**
-     * Gets or sets the index of the selected item in the component.
-     *
-     * {% codeBlock src="dropdownlist/index-api/index.ts" %}{% endcodeBlock %}
-     *
-     * {% codeBlock src="dropdownlist/index-api/index.html" %}{% endcodeBlock %}
-     *
-     * @default null
-     * @aspType double
-     */
-    index?: number | null;
+     * Gets or sets the index of the selected item in the component.
+     *
+     * {% codeBlock src="dropdownlist/index-api/index.ts" %}{% endcodeBlock %}
+     *
+     * {% codeBlock src="dropdownlist/index-api/index.html" %}{% endcodeBlock %}
+     *
+     * @default null
+     * @aspType double
+     */
+    index?: number | null;
 
     /**
-     * Specifies whether to display the floating label above the input element.
-     * Possible values are:
-     * * Never: The label will never float in the input when the placeholder is available.
-     * * Always: The floating label will always float above the input.
-     * * Auto: The floating label will float above the input after focusing or entering a value in the input.
-     *
-     * {% codeBlock src="dropdownlist/float-label-type-api/index.ts" %}{% endcodeBlock %}
-     *
-     * {% codeBlock src="dropdownlist/float-label-type-api/index.html" %}{% endcodeBlock %}
-     *
-     * @default Syncfusion.EJ2.Inputs.FloatLabelType.Never
-     * @aspType Syncfusion.EJ2.Inputs.FloatLabelType
-     * @isEnumeration true
-     */
-    floatLabelType?: FloatLabelType;
+     * Specifies whether to display the floating label above the input element.
+     * Possible values are:
+     * * Never: The label will never float in the input when the placeholder is available.
+     * * Always: The floating label will always float above the input.
+     * * Auto: The floating label will float above the input after focusing or entering a value in the input.
+     *
+     * {% codeBlock src="dropdownlist/float-label-type-api/index.ts" %}{% endcodeBlock %}
+     *
+     * {% codeBlock src="dropdownlist/float-label-type-api/index.html" %}{% endcodeBlock %}
+     *
+     * @default Syncfusion.EJ2.Inputs.FloatLabelType.Never
+     * @aspType Syncfusion.EJ2.Inputs.FloatLabelType
+     * @isEnumeration true
+     */
+    floatLabelType?: FloatLabelType;
 
     /**
-     * Specifies whether to show or hide the clear button.
-     * When the clear button is clicked, `value`, `text`, and `index` properties are reset to null.
-     *
-     * @default false
-     */
-    showClearButton?: boolean;
+     * Specifies whether to show or hide the clear button.
+     * When the clear button is clicked, `value`, `text`, and `index` properties are reset to null.
+     *
+     * @default false
+     */
+    showClearButton?: boolean;
 
     /**
-     * Triggers on typing a character in the filter bar when the
-     * [`allowFiltering`](./#allowfiltering)
-     * is enabled.
-     * > For more details about the filtering refer to [`Filtering`](../../drop-down-list/filtering) documentation.
-     *
-     * @event filtering
-     */
-    filtering?: EmitType<FilteringEventArgs>;
+     * Triggers on typing a character in the filter bar when the
+     * [`allowFiltering`](./#allowfiltering)
+     * is enabled.
+     * > For more details about the filtering refer to [`Filtering`](../../drop-down-list/filtering) documentation.
+     *
+     * @event filtering
+     */
+    filtering?: EmitType<FilteringEventArgs>;
 
     /**
-     * Triggers when an item in a popup is selected or when the model value is changed by user.
-     * Use change event to
-     * [`Configure the Cascading DropDownList`](../../drop-down-list/how-to/cascading)
-     *
-     * @event change
-     */
-    change?: EmitType<ChangeEventArgs>;
+     * Triggers when an item in a popup is selected or when the model value is changed by user.
+     * Use change event to
+     * [`Configure the Cascading DropDownList`](../../drop-down-list/how-to/cascading)
+     *
+     * @event change
+     */
+    change?: EmitType<ChangeEventArgs>;
 
     /**
-     * Triggers when the popup before opens.
-     *
-     * @event beforeOpen
-     */
-    beforeOpen?: EmitType<Object>;
+     * Triggers when the popup before opens.
+     *
+     * @event beforeOpen
+     */
+    beforeOpen?: EmitType<Object>;
 
     /**
-     * Triggers when the popup opens.
-     *
-     * @event open
-     */
-    open?: EmitType<PopupEventArgs>;
+     * Triggers when the popup opens.
+     *
+     * @event open
+     */
+    open?: EmitType<PopupEventArgs>;
 
     /**
-     * Triggers when the popup is closed.
-     *
-     * @event close
-     */
-    close?: EmitType<PopupEventArgs>;
+     * Triggers when the popup is closed.
+     *
+     * @event close
+     */
+    close?: EmitType<PopupEventArgs>;
 
     /**
-     * Triggers when focus moves out from the component.
-     *
-     * @event blur
-     */
-    blur?: EmitType<Object>;
+     * Triggers when focus moves out from the component.
+     *
+     * @event blur
+     */
+    blur?: EmitType<Object>;
 
     /**
-     * Triggers when the component is focused.
-     *
-     * @event focus
-     */
-    focus?: EmitType<Object>;
+     * Triggers when the component is focused.
+     *
+     * @event focus
+     */
+    focus?: EmitType<Object>;
 
 }