@syncfusion/ej2-dropdowns 25.2.3 → 25.2.5-30068

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

@@ -1,4 +1,4 @@
-import { Component, EventHandler, addClass, append, Property, Event, KeyboardEvents, EmitType, L10n, compile, KeyboardEventArgs } from '@syncfusion/ej2-base';import { setStyleAttribute, extend, removeClass, prepend, isNullOrUndefined, detach, getValue, AnimationModel } from '@syncfusion/ej2-base';import { NotifyPropertyChanges, INotifyPropertyChanged, rippleEffect, RippleOptions, ChildProperty, Complex } from '@syncfusion/ej2-base';import { DataManager, Query, DataOptions, DataUtil } from '@syncfusion/ej2-data';import { ListBase, SortOrder } from '@syncfusion/ej2-lists';import { Popup } from '@syncfusion/ej2-popups';import { remove, select, selectAll } from '@syncfusion/ej2-base';import { VirtualInfo, VirtualScroll } from '../common/virtual-scroll';import { GeneratedData } from '../drop-down-list';import { Skeleton } from '@syncfusion/ej2-notifications';
+import { Component, EventHandler, addClass, append, Property, Event, KeyboardEvents, EmitType, L10n, compile, KeyboardEventArgs } from '@syncfusion/ej2-base';
 import {FilterType,SelectEventArgs} from "./drop-down-base";
 import {ComponentModel} from '@syncfusion/ej2-base';
 
@@ -8,40 +8,40 @@ import {ComponentModel} from '@syncfusion/ej2-base';
 export interface FieldSettingsModel {
 
     /**
-     * Maps the text column from data table for each list item
-     *
-     * @default null
-     */
-    text?: string;
+     * Maps the text column from data table for each list item
+     *
+     * @default null
+     */
+    text?: string;
 
     /**
-     * Maps the value column from data table for each list item
-     *
-     * @default null
-     */
-    value?: string;
+     * Maps the value column from data table for each list item
+     *
+     * @default null
+     */
+    value?: string;
 
     /**
-     * Maps the icon class column from data table for each list item.
-     *
-     * @default null
-     */
-    iconCss?: string;
+     * Maps the icon class column from data table for each list item.
+     *
+     * @default null
+     */
+    iconCss?: string;
 
     /**
-     * Group the list items with it's related items by mapping groupBy field.
-     *
-     * @default null
-     */
-    groupBy?: string;
+     * Group the list items with it's related items by mapping groupBy field.
+     *
+     * @default null
+     */
+    groupBy?: string;
 
     /**
-     * Allows additional attributes such as title, disabled, etc., to configure the elements
-     * in various ways to meet the criteria.
-     *
-     * @default null
-     */
-    htmlAttributes?: string;
+     * Allows additional attributes such as title, disabled, etc., to configure the elements
+     * in various ways to meet the criteria.
+     *
+     * @default null
+     */
+    htmlAttributes?: string;
 
 }
 
@@ -51,216 +51,216 @@ export interface FieldSettingsModel {
 export interface DropDownBaseModel extends ComponentModel{
 
     /**
-     * The `fields` property maps the columns of the data table and binds the data to the component.
-     * * text - Maps the text column from data table for each list item.
-     * * value - Maps the value column from data table for each list item.
-     * * iconCss - Maps the icon class column from data table for each list item.
-     * * groupBy - Group the list items with it's related items by mapping groupBy field.
-     * ```html
-     * <input type="text" tabindex="1" id="list"> </input>
-     * ```
-     * ```typescript
-     *   let customers: DropDownList = new DropDownList({
-     *      dataSource:new DataManager({ url:'http://js.syncfusion.com/demos/ejServices/Wcf/Northwind.svc/' }),
-     *      query: new Query().from('Customers').select(['ContactName', 'CustomerID']).take(5),
-     *      fields: { text: 'ContactName', value: 'CustomerID' },
-     *      placeholder: 'Select a customer'
-     *   });
-     *   customers.appendTo("#list");
-     * ```
-     *
-     * @default {text: null, value: null, iconCss: null, groupBy: null}
-
-     */
-    fields?: FieldSettingsModel;
+     * The `fields` property maps the columns of the data table and binds the data to the component.
+     * * text - Maps the text column from data table for each list item.
+     * * value - Maps the value column from data table for each list item.
+     * * iconCss - Maps the icon class column from data table for each list item.
+     * * groupBy - Group the list items with it's related items by mapping groupBy field.
+     * ```html
+     * <input type="text" tabindex="1" id="list"> </input>
+     * ```
+     * ```typescript
+     *   let customers: DropDownList = new DropDownList({
+     *      dataSource:new DataManager({ url:'http://js.syncfusion.com/demos/ejServices/Wcf/Northwind.svc/' }),
+     *      query: new Query().from('Customers').select(['ContactName', 'CustomerID']).take(5),
+     *      fields: { text: 'ContactName', value: 'CustomerID' },
+     *      placeholder: 'Select a customer'
+     *   });
+     *   customers.appendTo("#list");
+     * ```
+     *
+     * @default {text: null, value: null, iconCss: null, groupBy: null}
+     * @deprecated
+     */
+    fields?: FieldSettingsModel;
 
     /**
-     * Accepts the template design and assigns it to each list item present in the popup.
-     * 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
-
-     */
-    itemTemplate?: string | Function;
+     * Accepts the template design and assigns it to each list item present in the popup.
+     * 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
+     * @deprecated
+     */
+    itemTemplate?: string | Function;
 
     /**
-     * Accepts the template design and assigns it to the group headers present in the popup list.
-     *
-     * @default null
-     * @aspType string
-
-     */
-    groupTemplate?: string | Function;
+     * Accepts the template design and assigns it to the group headers present in the popup list.
+     *
+     * @default null
+     * @aspType string
+     * @deprecated
+     */
+    groupTemplate?: string | Function;
 
     /**
-     * Accepts the template design and assigns it to popup list of component
-     * when no data is available on the component.
-     *
-     * @default 'No records found'
-     * @aspType string
-
-     */
-    noRecordsTemplate?: string | Function;
+     * Accepts the template design and assigns it to popup list of component
+     * when no data is available on the component.
+     *
+     * @default 'No records found'
+     * @aspType string
+     * @deprecated
+     */
+    noRecordsTemplate?: string | Function;
 
     /**
-     * Accepts the template and assigns it to the popup list content of the component
-     * when the data fetch request from the remote server fails.
-     *
-     * @default 'Request failed'
-     * @aspType string
-
-     */
-    actionFailureTemplate?: string | Function;
+     * Accepts the template and assigns it to the popup list content of the component
+     * when the data fetch request from the remote server fails.
+     *
+     * @default 'Request failed'
+     * @aspType string
+     * @deprecated
+     */
+    actionFailureTemplate?: string | Function;
 
     /**
-     * Specifies the `sortOrder` to sort the data source. The available type of sort orders are
-     * * `None` - The data source is not sorting.
-     * * `Ascending` - The data source is sorting with ascending order.
-     * * `Descending` - The data source is sorting with descending order.
-     *
-     * @default null
-     * @asptype object
-     * @aspjsonconverterignore
-
-     */
-    sortOrder?: SortOrder;
+     * Specifies the `sortOrder` to sort the data source. The available type of sort orders are
+     * * `None` - The data source is not sorting.
+     * * `Ascending` - The data source is sorting with ascending order.
+     * * `Descending` - The data source is sorting with descending order.
+     *
+     * @default null
+     * @asptype object
+     * @aspjsonconverterignore
+     * @deprecated
+     */
+    sortOrder?: SortOrder;
 
     /**
-     * Accepts the list items either through local or remote service and binds it to the component.
-     * It can be an array of JSON Objects or an instance of
-     * `DataManager`.
-     *
-     * @default []
-
-     */
-    dataSource?: { [key: string]: Object }[] | DataManager | string[] | number[] | boolean[];
+     * Accepts the list items either through local or remote service and binds it to the component.
+     * It can be an array of JSON Objects or an instance of
+     * `DataManager`.
+     *
+     * @default []
+     * @deprecated
+     */
+    dataSource?: { [key: string]: Object }[] | DataManager | string[] | number[] | boolean[];
 
     /**
-     * Accepts the external `Query`
-     * which will execute along with the data processing.
-     *
-     * @default null
-
-     */
-    query?: Query;
+     * Accepts the external `Query`
+     * which will execute along with the data processing.
+     *
+     * @default null
+     * @deprecated
+     */
+    query?: Query;
 
     /**
-     * Determines on which filter type, the component needs to be considered on search action.
-     * The `FilterType` and its supported data types are
-     *
-     * <table>
-     * <tr>
-     * <td colSpan=1 rowSpan=1>
-     * FilterType<br/></td><td colSpan=1 rowSpan=1>
-     * Description<br/></td><td colSpan=1 rowSpan=1>
-     * Supported Types<br/></td></tr>
-     * <tr>
-     * <td colSpan=1 rowSpan=1>
-     * StartsWith<br/></td><td colSpan=1 rowSpan=1>
-     * Checks whether a value begins with the specified value.<br/></td><td colSpan=1 rowSpan=1>
-     * String<br/></td></tr>
-     * <tr>
-     * <td colSpan=1 rowSpan=1>
-     * EndsWith<br/></td><td colSpan=1 rowSpan=1>
-     * Checks whether a value ends with specified value.<br/><br/></td><td colSpan=1 rowSpan=1>
-     * <br/>String<br/></td></tr>
-     * <tr>
-     * <td colSpan=1 rowSpan=1>
-     * Contains<br/></td><td colSpan=1 rowSpan=1>
-     * Checks whether a value contains with specified value.<br/><br/></td><td colSpan=1 rowSpan=1>
-     * <br/>String<br/></td></tr>
-     * </table>
-     *
-     * The default value set to `StartsWith`, all the suggestion items which contain typed characters to listed in the suggestion popup.
-     *
-     * @default 'StartsWith'
-
-     */
-    filterType?: FilterType;
+     * Determines on which filter type, the component needs to be considered on search action.
+     * The `FilterType` and its supported data types are
+     *
+     * <table>
+     * <tr>
+     * <td colSpan=1 rowSpan=1>
+     * FilterType<br/></td><td colSpan=1 rowSpan=1>
+     * Description<br/></td><td colSpan=1 rowSpan=1>
+     * Supported Types<br/></td></tr>
+     * <tr>
+     * <td colSpan=1 rowSpan=1>
+     * StartsWith<br/></td><td colSpan=1 rowSpan=1>
+     * Checks whether a value begins with the specified value.<br/></td><td colSpan=1 rowSpan=1>
+     * String<br/></td></tr>
+     * <tr>
+     * <td colSpan=1 rowSpan=1>
+     * EndsWith<br/></td><td colSpan=1 rowSpan=1>
+     * Checks whether a value ends with specified value.<br/><br/></td><td colSpan=1 rowSpan=1>
+     * <br/>String<br/></td></tr>
+     * <tr>
+     * <td colSpan=1 rowSpan=1>
+     * Contains<br/></td><td colSpan=1 rowSpan=1>
+     * Checks whether a value contains with specified value.<br/><br/></td><td colSpan=1 rowSpan=1>
+     * <br/>String<br/></td></tr>
+     * </table>
+     *
+     * The default value set to `StartsWith`, all the suggestion items which contain typed characters to listed in the suggestion popup.
+     *
+     * @default 'StartsWith'
+     * @deprecated
+     */
+    filterType?: FilterType;
 
     /**
-     * When set to ‘false’, consider the `case-sensitive` on performing the search to find suggestions.
-     * By default consider the casing.
-     *
-     * @default true
-
-     */
-    ignoreCase?: boolean;
+     * When set to ‘false’, consider the `case-sensitive` on performing the search to find suggestions.
+     * By default consider the casing.
+     *
+     * @default true
+     * @deprecated
+     */
+    ignoreCase?: boolean;
 
     /**
-     * specifies the z-index value of the component popup element.
-     *
-     * @default 1000
-
-     */
-    zIndex?: number;
+     * specifies the z-index value of the component popup element.
+     *
+     * @default 1000
+     * @deprecated
+     */
+    zIndex?: number;
 
     /**
-     * ignoreAccent set to true, then ignores the diacritic characters or accents when filtering.
-     *
-
-     */
-    ignoreAccent?: boolean;
+     * ignoreAccent set to true, then ignores the diacritic characters or accents when filtering.
+     *
+     * @deprecated
+     */
+    ignoreAccent?: boolean;
 
     /**
-     * Overrides the global culture and localization value for this component. Default global culture is 'en-US'.
-     *
-     * @default 'en-US'
-
-     */
-    locale?: string;
+     * Overrides the global culture and localization value for this component. Default global culture is 'en-US'.
+     *
+     * @default 'en-US'
+     * @deprecated
+     */
+    locale?: string;
 
     /**
-     * Triggers before fetching data from the remote server.
-     *
-     * @event actionBegin
-     */
-    actionBegin?: EmitType<Object>;
+     * Triggers before fetching data from the remote server.
+     *
+     * @event actionBegin
+     */
+    actionBegin?: EmitType<Object>;
 
     /**
-     * Triggers after data is fetched successfully from the remote server.
-     *
-     * @event actionComplete
-     */
-    actionComplete?: EmitType<Object>;
+     * Triggers after data is fetched successfully from the remote server.
+     *
+     * @event actionComplete
+     */
+    actionComplete?: EmitType<Object>;
 
     /**
-     * Triggers when the data fetch request from the remote server fails.
-     *
-     * @event actionFailure
-     */
-    actionFailure?: EmitType<Object>;
+     * Triggers when the data fetch request from the remote server fails.
+     *
+     * @event actionFailure
+     */
+    actionFailure?: EmitType<Object>;
 
     /**
-     * Triggers when an item in the popup is selected by the user either with mouse/tap or with keyboard navigation.
-     *
-     * @event select
-     */
-    select?: EmitType<SelectEventArgs>;
+     * Triggers when an item in the popup is selected by the user either with mouse/tap or with keyboard navigation.
+     *
+     * @event select
+     */
+    select?: EmitType<SelectEventArgs>;
 
     /**
-     * Triggers when data source is populated in the popup list..
-     *
-     * @event dataBound
-     */
-    dataBound?: EmitType<Object>;
+     * Triggers when data source is populated in the popup list..
+     *
+     * @event dataBound
+     */
+    dataBound?: EmitType<Object>;
 
     /**
-     * Triggers when the component is created.
-     *
-     * @event created
-     */
-    created?: EmitType<Object>;
+     * Triggers when the component is created.
+     *
+     * @event created
+     */
+    created?: EmitType<Object>;
 
     /**
-     * Triggers when the component is destroyed.
-     *
-     * @event destroyed
-     */
-    destroyed?: EmitType<Object>;
+     * Triggers when the component is destroyed.
+     *
+     * @event destroyed
+     */
+    destroyed?: EmitType<Object>;
 
 }

package/src/drop-down-base/drop-down-base.d.ts

@@ -220,7 +220,6 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
     protected noRecordsTemplateId: string;
     protected actionFailureTemplateId: string;
     protected preventChange: boolean;
-    protected isAngular: boolean;
     protected isPreventChange: boolean;
     protected isDynamicDataChange: boolean;
     protected addedNewItem: boolean;
@@ -280,15 +279,17 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
     protected preventPopupOpen: boolean;
     protected setCurrentView: boolean;
     protected customFilterQuery: Query;
+    protected virtualSelectAllState: boolean;
+    protected CurrentEvent: KeyboardEventArgs | MouseEvent;
     protected virtualSelectAllData: {
         [key: string]: Object;
-    }[] | DataManager | string[] | number[] | boolean[];
+    }[] | string[] | number[] | boolean[];
     protected firstItem: string | number | boolean | object;
     protected virtualListInfo: VirtualInfo;
     protected viewPortInfo: VirtualInfo;
     protected selectedValueInfo: VirtualInfo;
     /**
-
+
     /**
      * The `fields` property maps the columns of the data table and binds the data to the component.
      * * text - Maps the text column from data table for each list item.
@@ -309,7 +310,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * ```
      *
      * @default {text: null, value: null, iconCss: null, groupBy: null}
-
+     * @deprecated
      */
     fields: FieldSettingsModel;
     /**
@@ -321,7 +322,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default null
      * @aspType string
-
+     * @deprecated
      */
     itemTemplate: string | Function;
     /**
@@ -329,7 +330,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default null
      * @aspType string
-
+     * @deprecated
      */
     groupTemplate: string | Function;
     /**
@@ -338,7 +339,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default 'No records found'
      * @aspType string
-
+     * @deprecated
      */
     noRecordsTemplate: string | Function;
     /**
@@ -347,7 +348,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default 'Request failed'
      * @aspType string
-
+     * @deprecated
      */
     actionFailureTemplate: string | Function;
     /**
@@ -359,7 +360,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * @default null
      * @asptype object
      * @aspjsonconverterignore
-
+     * @deprecated
      */
     sortOrder: SortOrder;
     /**
@@ -368,7 +369,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * `DataManager`.
      *
      * @default []
-
+     * @deprecated
      */
     dataSource: {
         [key: string]: Object;
@@ -378,7 +379,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * which will execute along with the data processing.
      *
      * @default null
-
+     * @deprecated
      */
     query: Query;
     /**
@@ -411,7 +412,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * The default value set to `StartsWith`, all the suggestion items which contain typed characters to listed in the suggestion popup.
      *
      * @default 'StartsWith'
-
+     * @deprecated
      */
     filterType: FilterType;
     /**
@@ -419,27 +420,27 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * By default consider the casing.
      *
      * @default true
-
+     * @deprecated
      */
     ignoreCase: boolean;
     /**
      * specifies the z-index value of the component popup element.
      *
      * @default 1000
-
+     * @deprecated
      */
     zIndex: number;
     /**
      * ignoreAccent set to true, then ignores the diacritic characters or accents when filtering.
      *
-
+     * @deprecated
      */
     ignoreAccent: boolean;
     /**
      * Overrides the global culture and localization value for this component. Default global culture is 'en-US'.
      *
      * @default 'en-US'
-
+     * @deprecated
      */
     locale: string;
     /**
@@ -567,6 +568,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
     private setListData;
     protected handleVirtualKeyboardActions(e: KeyboardEventArgs, pageCount: number): void;
     protected updatePopupState(): void;
+    protected virtualSelectionAll(state: boolean, li: NodeListOf<HTMLElement> | HTMLElement[], event: MouseEvent | KeyboardEventArgs): void;
     protected updateRemoteData(): void;
     private bindChildItems;
     protected isObjectInArray(objectToFind: any, array: any[]): boolean;
@@ -606,7 +608,9 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * @param {FieldSettingsModel} fields - Maps the columns of the data table and binds the data to the component.
      * @returns {HTMLElement} Return the ul li list items.
      */
-    private createListItems;
+    protected createListItems(dataSource: {
+        [key: string]: Object;
+    }[], fields: FieldSettingsModel): HTMLElement;
     protected listOption(dataSource: {
         [key: string]: Object;
     }[] | string[] | number[] | boolean[], fields: FieldSettingsModel): FieldSettingsModel;
@@ -651,7 +655,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * @param {string | number | boolean} value - Specifies given value.
      * @returns {number} Returns the index of the item.
      */
-    protected getIndexByValueFilter(value: string | number | boolean): number;
+    protected getIndexByValueFilter(value: string | number | boolean, ulElement: HTMLElement): number | null;
     /**
      * To dispatch the event manually
      *
@@ -724,7 +728,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * @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
      */
     addItem(items: {
         [key: string]: Object;
@@ -796,7 +800,7 @@ export interface PopupEventArgs {
     /**
      * Specifies the popup Object.
      *
-
+     * @deprecated
      */
     popup: Popup;
     /**