@syncfusion/ej2-dropdowns 23.2.7 → 24.1.41-566987

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 { 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

@@ -178,6 +178,11 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
         [key: string]: Object;
     }[] | string[] | boolean[] | number[];
     protected ulElement: HTMLElement;
+    protected incrementalLiCollections: HTMLElement[];
+    protected incrementalListData: {
+        [key: string]: Object;
+    }[] | string[] | boolean[] | number[];
+    protected incrementalUlElement: HTMLElement;
     protected liCollections: HTMLElement[];
     private bindEvent;
     private scrollTimer;
@@ -223,6 +228,14 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
     private virtualizedItemsCount;
     protected totalItemCount: number;
     protected dataCount: number;
+    protected isRemoteDataUpdated: boolean;
+    protected virtualGroupDataSource: {
+        [key: string]: Object;
+    }[] | DataManager | string[] | number[] | boolean[];
+    protected isIncrementalRequest: boolean;
+    protected itemCount: number;
+    /**
+
     /**
      * 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.
@@ -243,7 +256,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * ```
      *
      * @default {text: null, value: null, iconCss: null, groupBy: null}
-
+     * @deprecated
      */
     fields: FieldSettingsModel;
     /**
@@ -255,7 +268,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default null
      * @aspType string
-
+     * @deprecated
      */
     itemTemplate: string | Function;
     /**
@@ -263,7 +276,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default null
      * @aspType string
-
+     * @deprecated
      */
     groupTemplate: string | Function;
     /**
@@ -272,7 +285,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default 'No records found'
      * @aspType string
-
+     * @deprecated
      */
     noRecordsTemplate: string | Function;
     /**
@@ -281,7 +294,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      *
      * @default 'Request failed'
      * @aspType string
-
+     * @deprecated
      */
     actionFailureTemplate: string | Function;
     /**
@@ -293,7 +306,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * @default null
      * @asptype object
      * @aspjsonconverterignore
-
+     * @deprecated
      */
     sortOrder: SortOrder;
     /**
@@ -302,7 +315,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * `DataManager`.
      *
      * @default []
-
+     * @deprecated
      */
     dataSource: {
         [key: string]: Object;
@@ -312,7 +325,7 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * which will execute along with the data processing.
      *
      * @default null
-
+     * @deprecated
      */
     query: Query;
     /**
@@ -345,7 +358,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;
     /**
@@ -353,27 +366,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;
     /**
@@ -490,6 +503,8 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
      * @returns {void}
      */
     private setListData;
+    protected updatePopupState(): void;
+    protected updateRemoteData(): void;
     private bindChildItems;
     protected updateListValues(): void;
     protected findListElement(list: HTMLElement, findNode: string, attribute: string, value: string | boolean | number): HTMLElement;
@@ -532,7 +547,10 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
         [key: string]: Object;
     }[] | string[] | number[] | boolean[], fields: FieldSettingsModel): FieldSettingsModel;
     protected setFloatingHeader(e: Event): void;
-    protected scrollStop(e?: Event): void;
+    protected scrollStop(e?: Event, isDownkey?: boolean): void;
+    protected getPageCount(returnExactCount?: boolean): number;
+    private updateGroupHeader;
+    private updateGroupFixedHeader;
     protected getValidLi(): HTMLElement;
     /**
      * To render the list items
@@ -544,6 +562,8 @@ export declare class DropDownBase extends Component<HTMLElement> implements INot
     protected renderItems(listData: {
         [key: string]: Object;
     }[], fields: FieldSettingsModel): HTMLElement;
+    private createVirtualContent;
+    private updateListElements;
     protected templateListItem(dataSource: {
         [key: string]: Object;
     }[], fields: FieldSettingsModel): HTMLElement;
@@ -560,14 +580,14 @@ 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 getIndexByValue(value: string | number | boolean): number;
     /**
      * Return the index of item which matched with given value in data source
      *
      * @param {string | number | boolean} value - Specifies given value.
      * @returns {number} Returns the index of the item.
      */
-    protected getIndexByValue(value: string | number | boolean): number;
+    protected getIndexByValueFilter(value: string | number | boolean): number;
     /**
      * To dispatch the event manually
      *
@@ -638,7 +658,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;
@@ -710,7 +730,7 @@ export interface PopupEventArgs {
     /**
      * Specifies the popup Object.
      *
-
+     * @deprecated
      */
     popup: Popup;
     /**