UNPKG

devextreme-angular

Version:

Angular UI and visualization components based on DevExtreme widgets

777 lines (562 loc) • 23 kB
/*! * devextreme-angular * Version: 20.2.5 * Build date: Fri Jan 15 2021 * * Copyright (c) 2012 - 2021 Developer Express Inc. ALL RIGHTS RESERVED * * This software may be modified and distributed under the terms * of the MIT license. See the LICENSE file in the root of the project for details. * * https://github.com/DevExpress/devextreme-angular */ import { TransferState } from '@angular/platform-browser'; import { ElementRef, NgZone, OnDestroy, EventEmitter, OnChanges, DoCheck, SimpleChanges, QueryList } from '@angular/core'; import DevExpress from 'devextreme/bundles/dx.all'; import { dxSortableOptions } from 'devextreme/ui/sortable'; import { dxTextBoxOptions } from 'devextreme/ui/text_box'; import DxList from 'devextreme/ui/list'; import { DxComponent, DxTemplateHost, NestedOptionHost, IterableDifferHelper, WatcherHelper } from 'devextreme-angular/core'; import { DxiItemComponent } from 'devextreme-angular/ui/nested'; import { DxiMenuItemComponent } from 'devextreme-angular/ui/nested'; /** * The List is a UI component that represents a collection of items in a scrollable list. */ export declare class DxListComponent extends DxComponent implements OnDestroy, OnChanges, DoCheck { private _watcherHelper; private _idh; instance: DxList; /** * Specifies the shortcut key that sets focus on the UI component. */ accessKey: string; /** * Specifies whether or not the UI component changes its state when interacting with a user. */ activeStateEnabled: boolean; /** * Specifies whether or not an end user can delete list items. */ allowItemDeleting: boolean; /** * A Boolean value specifying whether to enable or disable the bounce-back effect. */ bounceEnabled: boolean; /** * Specifies whether or not an end-user can collapse groups. */ collapsibleGroups: boolean; /** * Binds the UI component to data. */ dataSource: DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string | Array<string | DevExpress.ui.dxListItem | any>; /** * Specifies whether the UI component responds to user interaction. */ disabled: boolean; /** * Specifies the data field whose values should be displayed. Defaults to 'text' when the data source contains objects. */ displayExpr: Function | string; /** * Specifies the global attributes to be attached to the UI component's container element. */ elementAttr: any; /** * Specifies whether the UI component can be focused using keyboard navigation. */ focusStateEnabled: boolean; /** * Specifies whether data items should be grouped. */ grouped: boolean; /** * Specifies a custom template for group captions. */ groupTemplate: any; /** * Specifies the UI component's height. */ height: number | Function | string; /** * Specifies text for a hint that appears when a user pauses on the UI component. */ hint: string; /** * Specifies whether the UI component changes its state when a user pauses on it. */ hoverStateEnabled: boolean; /** * Specifies whether or not to show the loading panel when the DataSource bound to the UI component is loading data. */ indicateLoading: boolean; /** * Specifies the way a user can delete items from the list. */ itemDeleteMode: string; /** * Configures item reordering using drag and drop gestures. */ itemDragging: dxSortableOptions; /** * The time period in milliseconds before the onItemHold event is raised. */ itemHoldTimeout: number; /** * An array of items displayed by the UI component. */ items: Array<string | any | { badge?: string; disabled?: boolean; html?: string; icon?: string; key?: string; showChevron?: boolean; template?: any; text?: string; visible?: boolean; }>; /** * Specifies a custom template for items. */ itemTemplate: any; /** * Specifies the key property that provides key values to access data items. Each key value must be unique. */ keyExpr: Function | string; /** * Specifies the array of items for a context menu called for a list item. */ menuItems: Array<any | { action?: Function; text?: string; }>; /** * Specifies whether an item context menu is shown when a user holds or swipes an item. */ menuMode: string; /** * The text displayed on the button used to load the next page from the data source. */ nextButtonText: string; /** * The text or HTML markup displayed by the UI component if the item collection is empty. */ noDataText: string; /** * Specifies the text shown in the pullDown panel, which is displayed when the list is scrolled to the bottom. */ pageLoadingText: string; /** * Specifies whether the next page is loaded when a user scrolls the UI component to the bottom or when the 'next' button is clicked. */ pageLoadMode: string; /** * Specifies the text displayed in the pullDown panel when the list is pulled below the refresh threshold. */ pulledDownText: string; /** * Specifies the text shown in the pullDown panel while the list is being pulled down to the refresh threshold. */ pullingDownText: string; /** * A Boolean value specifying whether or not the UI component supports the 'pull down to refresh' gesture. */ pullRefreshEnabled: boolean; /** * Specifies the text displayed in the pullDown panel while the list is being refreshed. */ refreshingText: string; /** * Specifies whether to repaint only those elements whose data changed. */ repaintChangesOnly: boolean; /** * Switches the UI component to a right-to-left representation. */ rtlEnabled: boolean; /** * A Boolean value specifying if the list is scrolled by content. */ scrollByContent: boolean; /** * A Boolean value specifying if the list is scrolled using the scrollbar. */ scrollByThumb: boolean; /** * A Boolean value specifying whether to enable or disable list scrolling. */ scrollingEnabled: boolean; /** * Configures the search panel. */ searchEditorOptions: dxTextBoxOptions; /** * Specifies whether the search panel is visible. */ searchEnabled: boolean; /** * Specifies a data object's field name or an expression whose value is compared to the search string. */ searchExpr: Function | string | Array<Function | string>; /** * Specifies a comparison operation used to search UI component items. */ searchMode: string; /** * Specifies a delay in milliseconds between when a user finishes typing, and the search is executed. */ searchTimeout: number; /** * Specifies the current search string. */ searchValue: string; /** * Specifies the mode in which all items are selected. */ selectAllMode: string; /** * Specifies an array of currently selected item keys. */ selectedItemKeys: Array<any>; /** * An array of currently selected item objects. */ selectedItems: Array<any>; /** * Specifies item selection mode. */ selectionMode: string; /** * Specifies when the UI component shows the scrollbar. */ showScrollbar: string; /** * Specifies whether or not to display controls used to select list items. */ showSelectionControls: boolean; /** * Specifies the number of the element when the Tab key is used for navigating. */ tabIndex: number; /** * Specifies whether or not the UI component uses native scrolling. */ useNativeScrolling: boolean; /** * Specifies whether the UI component is visible. */ visible: boolean; /** * Specifies the UI component's width. */ width: number | Function | string; /** * A function that is executed when the UI component's content is ready and each time the content is changed. */ onContentReady: EventEmitter<any>; /** * A function that is executed before the UI component is disposed of. */ onDisposing: EventEmitter<any>; /** * A function that is executed when a group element is rendered. */ onGroupRendered: EventEmitter<any>; /** * A function used in JavaScript frameworks to save the UI component instance. */ onInitialized: EventEmitter<any>; /** * A function that is executed when a collection item is clicked or tapped. */ onItemClick: EventEmitter<any>; /** * A function that is executed when a collection item is right-clicked or pressed. */ onItemContextMenu: EventEmitter<any>; /** * A function that is executed after a list item is deleted from the data source. */ onItemDeleted: EventEmitter<any>; /** * A function that is executed before a collection item is deleted from the data source. */ onItemDeleting: EventEmitter<any>; /** * A function that is executed when a collection item has been held for a specified period. */ onItemHold: EventEmitter<any>; /** * A function that is executed after a collection item is rendered. */ onItemRendered: EventEmitter<any>; /** * A function that is executed after a list item is moved to another position. */ onItemReordered: EventEmitter<any>; /** * A function that is executed when a list item is swiped. */ onItemSwipe: EventEmitter<any>; /** * A function that is executed after a UI component property is changed. */ onOptionChanged: EventEmitter<any>; /** * A function that is executed before the next page is loaded. */ onPageLoading: EventEmitter<any>; /** * A function that is executed when the 'pull to refresh' gesture is performed. Supported in mobile themes only. */ onPullRefresh: EventEmitter<any>; /** * A function that is executed on each scroll gesture. */ onScroll: EventEmitter<any>; /** * A function that is executed when the 'Select All' check box value is changed. Applies only if the selectionMode is 'all'. */ onSelectAllValueChanged: EventEmitter<any>; /** * A function that is executed when a collection item is selected or selection is canceled. */ onSelectionChanged: EventEmitter<any>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ accessKeyChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ activeStateEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ allowItemDeletingChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ bounceEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ collapsibleGroupsChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ dataSourceChange: EventEmitter<DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string | Array<string | DevExpress.ui.dxListItem | any>>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ disabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ displayExprChange: EventEmitter<Function | string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ elementAttrChange: EventEmitter<any>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ focusStateEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ groupedChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ groupTemplateChange: EventEmitter<any>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ heightChange: EventEmitter<number | Function | string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ hintChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ hoverStateEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ indicateLoadingChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ itemDeleteModeChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ itemDraggingChange: EventEmitter<dxSortableOptions>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ itemHoldTimeoutChange: EventEmitter<number>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ itemsChange: EventEmitter<Array<string | any | { badge?: string; disabled?: boolean; html?: string; icon?: string; key?: string; showChevron?: boolean; template?: any; text?: string; visible?: boolean; }>>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ itemTemplateChange: EventEmitter<any>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ keyExprChange: EventEmitter<Function | string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ menuItemsChange: EventEmitter<Array<any | { action?: Function; text?: string; }>>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ menuModeChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ nextButtonTextChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ noDataTextChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ pageLoadingTextChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ pageLoadModeChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ pulledDownTextChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ pullingDownTextChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ pullRefreshEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ refreshingTextChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ repaintChangesOnlyChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ rtlEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ scrollByContentChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ scrollByThumbChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ scrollingEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ searchEditorOptionsChange: EventEmitter<dxTextBoxOptions>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ searchEnabledChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ searchExprChange: EventEmitter<Function | string | Array<Function | string>>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ searchModeChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ searchTimeoutChange: EventEmitter<number>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ searchValueChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ selectAllModeChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ selectedItemKeysChange: EventEmitter<Array<any>>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ selectedItemsChange: EventEmitter<Array<any>>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ selectionModeChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ showScrollbarChange: EventEmitter<string>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ showSelectionControlsChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ tabIndexChange: EventEmitter<number>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ useNativeScrollingChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ visibleChange: EventEmitter<boolean>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ widthChange: EventEmitter<number | Function | string>; itemsChildren: QueryList<DxiItemComponent>; menuItemsChildren: QueryList<DxiMenuItemComponent>; constructor(elementRef: ElementRef, ngZone: NgZone, templateHost: DxTemplateHost, _watcherHelper: WatcherHelper, _idh: IterableDifferHelper, optionHost: NestedOptionHost, transferState: TransferState, platformId: any); protected _createInstance(element: any, options: any): DxList; ngOnDestroy(): void; ngOnChanges(changes: SimpleChanges): void; setupChanges(prop: string, changes: SimpleChanges): void; ngDoCheck(): void; _setOption(name: string, value: any): void; } export declare class DxListModule { }