@syncfusion/ej2-dropdowns 24.1.44 → 24.1.45-12082

package/src/combo-box/combo-box-model.d.ts

@@ -1,4 +1,4 @@
-import { EventHandler, Property, Event, EmitType, addClass, Browser, KeyboardEventArgs, removeClass, detach } from '@syncfusion/ej2-base';import { isNullOrUndefined, NotifyPropertyChanges, getValue, setValue } from '@syncfusion/ej2-base';import { DropDownList, dropDownListClasses } from '../drop-down-list/drop-down-list';import { FilteringEventArgs } from '../drop-down-base/drop-down-base';import { FieldSettingsModel } from '../drop-down-base/drop-down-base-model';import { Search } from '../common/incremental-search';import { createSpinner, showSpinner, hideSpinner } from '@syncfusion/ej2-popups';import { Input, InputObject, FloatLabelType } from '@syncfusion/ej2-inputs';import { DataManager, Query } from '@syncfusion/ej2-data';
+import { EventHandler, Property, Event, EmitType, addClass, Browser, KeyboardEventArgs, removeClass, detach } from '@syncfusion/ej2-base';
 import {CustomValueSpecifierEventArgs} from "./combo-box";
 import {DropDownListModel} from "../drop-down-list/drop-down-list-model";
 
@@ -8,228 +8,228 @@ import {DropDownListModel} from "../drop-down-list/drop-down-list-model";
 export interface ComboBoxModel extends DropDownListModel{
 
     /**
-     * Specifies whether suggest a first matched item in input when searching. No action happens when no matches found.
-     *
-     * @default false
-     */
-    autofill?: boolean;
-
-    /**
-     * Specifies whether the component allows user defined value which does not exist in data source.
-     *
-     * @default true
-     */
-    allowCustom?: boolean;
-
-    /**
-     * Allows additional HTML attributes such as title, name, etc., and
-     * accepts n number of attributes in a key-value pair format.
-     *
-     * {% codeBlock src='combobox/htmlAttributes/index.md' %}{% endcodeBlock %}
-     *
-     * @default {}
-
-     */
-    htmlAttributes?: { [key: string]: string };
-
-    /**
-     * 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.
-     *
-     * {% codeBlock src="combobox/allow-filtering-api/index.ts" %}{% endcodeBlock %}
-     *
-     * {% codeBlock src="combobox/allow-filtering-api/index.html" %}{% endcodeBlock %}
-     *
-     * @default false
-
-     */
-    allowFiltering?: boolean;
-
-    /**
-     * Accepts the external `Query`
-     * that execute along with [`data processing`](../../combo-box/data-binding).
-     *
-     * {% codeBlock src='combobox/query/index.md' %}{% endcodeBlock %}
-     *
-     * @default null
-
-     */
-    query?: Query;
-
-    /**
-     * Gets or sets the index of the selected item in the component.
-     *
-     * {% codeBlock src="combobox/index-api/index.ts" %}{% endcodeBlock %}
-     *
-     * {% codeBlock src="combobox/index-api/index.html" %}{% endcodeBlock %}
-     *
-     * @default null
-
-     */
-    index?: number;
-
-    /**
-     * 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 true
-     */
-    showClearButton?: boolean;
-
-    /**
-     * Enable or disable rendering component in right to left direction.
-     *
-     * @default false
-
-     */
-    enableRtl?: boolean;
-
-    /**
-     * Triggers on set a
-     * [`custom value`](../../combo-box/getting-started#custom-values) to this component.
-     *
-     * @event customValueSpecifier
-     */
-    customValueSpecifier?: EmitType<CustomValueSpecifierEventArgs>;
-
-    /**
-     * Triggers on typing a character in the component.
-     * > For more details about the filtering refer to [`Filtering`](../../combo-box/filtering) documentation.
-     *
-     * @event filtering
-     */
-    filtering?: EmitType<FilteringEventArgs>;
-
-    /**
-     * Not applicable to this component.
-     *
-     * @default null
-     * @aspType string
-     * @private
-     */
-    valueTemplate?: string | Function;
-
-    /**
-     * 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="combobox/float-label-type-api/index.ts" %}{% endcodeBlock %}
-     *
-     * {% codeBlock src="combobox/float-label-type-api/index.html" %}{% endcodeBlock %}
-     *
-     * @default Syncfusion.EJ2.Inputs.FloatLabelType.Never
-     * @aspType Syncfusion.EJ2.Inputs.FloatLabelType
-     * @isEnumeration true
-
-     */
-    floatLabelType?: FloatLabelType;
-
-    /**
-     * Not applicable to this component.
-     *
-     * @default null
-     * @private
-
-     */
-    filterBarPlaceholder?: string;
-
-    /**
-     * Sets CSS classes to the root element of the component that allows customization of appearance.
-     *
-     * @default null
-
-     */
-    cssClass?: string;
-
-    /**
-     * 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;
-
-    /**
-     * Specifies a short hint that describes the expected value of the DropDownList component.
-     *
-     * @default null
-
-     */
-    placeholder?: 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 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;
-
-    /**
-     * When set to true, the user interactions on the component are disabled.
-     *
-     * @default false
-
-     */
-    readonly?: boolean;
-
-    /**
-     * Gets or sets the display text of the selected item in the component.
-     *
-     * @default null
-
-     */
-    text?: string;
-
-    /**
-     * Gets or sets the value of the selected item in the component.
-     *
-     * @default null
-     * @isGenericType true
-
-     */
-    value?: number | string | boolean;
+     * Specifies whether suggest a first matched item in input when searching. No action happens when no matches found.
+     *
+     * @default false
+     */
+    autofill?: boolean;
+
+    /**
+     * Specifies whether the component allows user defined value which does not exist in data source.
+     *
+     * @default true
+     */
+    allowCustom?: boolean;
+
+    /**
+     * Allows additional HTML attributes such as title, name, etc., and
+     * accepts n number of attributes in a key-value pair format.
+     *
+     * {% codeBlock src='combobox/htmlAttributes/index.md' %}{% endcodeBlock %}
+     *
+     * @default {}
+     * @deprecated
+     */
+    htmlAttributes?: { [key: string]: string };
+
+    /**
+     * 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.
+     *
+     * {% codeBlock src="combobox/allow-filtering-api/index.ts" %}{% endcodeBlock %}
+     *
+     * {% codeBlock src="combobox/allow-filtering-api/index.html" %}{% endcodeBlock %}
+     *
+     * @default false
+     * @deprecated
+     */
+    allowFiltering?: boolean;
+
+    /**
+     * Accepts the external `Query`
+     * that execute along with [`data processing`](../../combo-box/data-binding).
+     *
+     * {% codeBlock src='combobox/query/index.md' %}{% endcodeBlock %}
+     *
+     * @default null
+     * @deprecated
+     */
+    query?: Query;
+
+    /**
+     * Gets or sets the index of the selected item in the component.
+     *
+     * {% codeBlock src="combobox/index-api/index.ts" %}{% endcodeBlock %}
+     *
+     * {% codeBlock src="combobox/index-api/index.html" %}{% endcodeBlock %}
+     *
+     * @default null
+     * @deprecated
+     */
+    index?: number;
+
+    /**
+     * 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 true
+     */
+    showClearButton?: boolean;
+
+    /**
+     * Enable or disable rendering component in right to left direction.
+     *
+     * @default false
+     * @deprecated
+     */
+    enableRtl?: boolean;
+
+    /**
+     * Triggers on set a
+     * [`custom value`](../../combo-box/getting-started#custom-values) to this component.
+     *
+     * @event customValueSpecifier
+     */
+    customValueSpecifier?: EmitType<CustomValueSpecifierEventArgs>;
+
+    /**
+     * Triggers on typing a character in the component.
+     * > For more details about the filtering refer to [`Filtering`](../../combo-box/filtering) documentation.
+     *
+     * @event filtering
+     */
+    filtering?: EmitType<FilteringEventArgs>;
+
+    /**
+     * Not applicable to this component.
+     *
+     * @default null
+     * @aspType string
+     * @private
+     */
+    valueTemplate?: string | Function;
+
+    /**
+     * 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="combobox/float-label-type-api/index.ts" %}{% endcodeBlock %}
+     *
+     * {% codeBlock src="combobox/float-label-type-api/index.html" %}{% endcodeBlock %}
+     *
+     * @default Syncfusion.EJ2.Inputs.FloatLabelType.Never
+     * @aspType Syncfusion.EJ2.Inputs.FloatLabelType
+     * @isEnumeration true
+     * @deprecated
+     */
+    floatLabelType?: FloatLabelType;
+
+    /**
+     * Not applicable to this component.
+     *
+     * @default null
+     * @private
+     * @deprecated
+     */
+    filterBarPlaceholder?: string;
+
+    /**
+     * Sets CSS classes to the root element of the component that allows customization of appearance.
+     *
+     * @default null
+     * @deprecated
+     */
+    cssClass?: string;
+
+    /**
+     * 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
+     * @deprecated
+     */
+    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
+     * @deprecated
+     */
+    footerTemplate?: string | Function;
+
+    /**
+     * Specifies a short hint that describes the expected value of the DropDownList component.
+     *
+     * @default null
+     * @deprecated
+     */
+    placeholder?: 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
+     * @deprecated
+     */
+    width?: 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
+     * @deprecated
+     */
+    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
+     * @deprecated
+     */
+    popupWidth?: string | number;
+
+    /**
+     * When set to true, the user interactions on the component are disabled.
+     *
+     * @default false
+     * @deprecated
+     */
+    readonly?: boolean;
+
+    /**
+     * Gets or sets the display text of the selected item in the component.
+     *
+     * @default null
+     * @deprecated
+     */
+    text?: string;
+
+    /**
+     * Gets or sets the value of the selected item in the component.
+     *
+     * @default null
+     * @isGenericType true
+     * @deprecated
+     */
+    value?: number | string | boolean;
 
 }

package/src/combo-box/combo-box.d.ts

@@ -42,7 +42,7 @@ export declare class ComboBox extends DropDownList {
      * {% codeBlock src='combobox/htmlAttributes/index.md' %}{% endcodeBlock %}
      *
      * @default {}
-
+     * @deprecated
      */
     htmlAttributes: {
         [key: string]: string;
@@ -58,7 +58,7 @@ export declare class ComboBox extends DropDownList {
      * {% codeBlock src="combobox/allow-filtering-api/index.html" %}{% endcodeBlock %}
      *
      * @default false
-
+     * @deprecated
      */
     allowFiltering: boolean;
     /**
@@ -68,7 +68,7 @@ export declare class ComboBox extends DropDownList {
      * {% codeBlock src='combobox/query/index.md' %}{% endcodeBlock %}
      *
      * @default null
-
+     * @deprecated
      */
     query: Query;
     /**
@@ -79,7 +79,7 @@ export declare class ComboBox extends DropDownList {
      * {% codeBlock src="combobox/index-api/index.html" %}{% endcodeBlock %}
      *
      * @default null
-
+     * @deprecated
      */
     index: number;
     /**
@@ -93,7 +93,7 @@ export declare class ComboBox extends DropDownList {
      * Enable or disable rendering component in right to left direction.
      *
      * @default false
-
+     * @deprecated
      */
     enableRtl: boolean;
     /**
@@ -132,7 +132,7 @@ export declare class ComboBox extends DropDownList {
      * @default Syncfusion.EJ2.Inputs.FloatLabelType.Never
      * @aspType Syncfusion.EJ2.Inputs.FloatLabelType
      * @isEnumeration true
-
+     * @deprecated
      */
     floatLabelType: FloatLabelType;
     /**
@@ -140,14 +140,14 @@ export declare class ComboBox extends DropDownList {
      *
      * @default null
      * @private
-
+     * @deprecated
      */
     filterBarPlaceholder: string;
     /**
      * Sets CSS classes to the root element of the component that allows customization of appearance.
      *
      * @default null
-
+     * @deprecated
      */
     cssClass: string;
     /**
@@ -156,7 +156,7 @@ export declare class ComboBox extends DropDownList {
      *
      * @default null
      * @aspType string
-
+     * @deprecated
      */
     headerTemplate: string | Function;
     /**
@@ -165,14 +165,14 @@ export declare class ComboBox extends DropDownList {
      *
      * @default null
      * @aspType string
-
+     * @deprecated
      */
     footerTemplate: string | Function;
     /**
      * Specifies a short hint that describes the expected value of the DropDownList component.
      *
      * @default null
-
+     * @deprecated
      */
     placeholder: string;
     /**
@@ -181,7 +181,7 @@ export declare class ComboBox extends DropDownList {
      *
      * @default '100%'
      * @aspType string
-
+     * @deprecated
      */
     width: string | number;
     /**
@@ -191,7 +191,7 @@ export declare class ComboBox extends DropDownList {
      *
      * @default '300px'
      * @aspType string
-
+     * @deprecated
      */
     popupHeight: string | number;
     /**
@@ -202,21 +202,21 @@ export declare class ComboBox extends DropDownList {
      *
      * @default '100%'
      * @aspType string
-
+     * @deprecated
      */
     popupWidth: string | number;
     /**
      * When set to true, the user interactions on the component are disabled.
      *
      * @default false
-
+     * @deprecated
      */
     readonly: boolean;
     /**
      * Gets or sets the display text of the selected item in the component.
      *
      * @default null
-
+     * @deprecated
      */
     text: string;
     /**
@@ -224,7 +224,7 @@ export declare class ComboBox extends DropDownList {
      *
      * @default null
      * @isGenericType true
-
+     * @deprecated
      */
     value: number | string | boolean;
     /**
@@ -268,14 +268,14 @@ export declare class ComboBox extends DropDownList {
      * Shows the spinner loader.
      *
      * @returns {void}
-
+     * @deprecated
      */
     showSpinner(): void;
     /**
      * Hides the spinner loader.
      *
      * @returns {void}
-
+     * @deprecated
      */
     hideSpinner(): void;
     protected setAutoFill(activeElement: Element, isHover?: boolean): void;
@@ -324,7 +324,7 @@ export declare class ComboBox extends DropDownList {
      * @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;
@@ -338,7 +338,7 @@ export declare class ComboBox extends DropDownList {
      * @param {Query} query - Specify the query to filter the data.
      * @param {FieldSettingsModel} fields - Specify the fields to map the column in the data table.
      * @returns {void}
-
+     * @deprecated
      */
     filter(dataSource: {
         [key: string]: Object;
@@ -347,14 +347,14 @@ export declare class ComboBox extends DropDownList {
      * Opens the popup that displays the list of items.
      *
      * @returns {void}
-
+     * @deprecated
      */
     showPopup(e?: MouseEvent | KeyboardEventArgs | TouchEvent): void;
     /**
      * Hides the popup if it is in open state.
      *
      * @returns {void}
-
+     * @deprecated
      */
     hidePopup(e?: MouseEvent | KeyboardEventArgs | TouchEvent): void;
     /**
@@ -367,21 +367,21 @@ export declare class ComboBox extends DropDownList {
      * Allows you to clear the selected values from the component.
      *
      * @returns {void}
-
+     * @deprecated
      */
     clear(): void;
     /**
      * Moves the focus from the component if the component is already focused.
      *
      * @returns {void}
-
+     * @deprecated
      */
     focusOut(e?: MouseEvent | KeyboardEventArgs): void;
     /**
      * Gets all the list items bound on this component.
      *
      * @returns {Element[]}
-
+     * @deprecated
      */
     getItems(): Element[];
     /**
@@ -389,7 +389,7 @@ export declare class ComboBox extends DropDownList {
      *
      * @param { string | number } value - Specifies the value of the list item.
      * @returns {Object}
-
+     * @deprecated
      */
     getDataByValue(value: string | number | boolean): {
         [key: string]: Object;