/*! * devextreme-angular * Version: 25.2.6 * Build date: Mon Mar 30 2026 * * Copyright (c) 2012 - 2026 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 */ import { TransferState, ElementRef, NgZone, OnDestroy, EventEmitter, OnChanges, DoCheck, SimpleChanges, QueryList } from '@angular/core'; import { ApplyValueMode, TextEditorButton, LabelMode, EditorStyle, ValidationMessageMode, Mode, Position, ValidationStatus } from 'devextreme/common'; import { DropDownPredefinedButton } from 'devextreme/ui/drop_down_editor/ui.drop_down_editor'; import { dxCalendarOptions } from 'devextreme/ui/calendar'; import { Format } from 'devextreme/common/core/localization'; import { dxPopupOptions } from 'devextreme/ui/popup'; import { ChangeEvent, ClosedEvent, ContentReadyEvent, CopyEvent, CutEvent, DisposingEvent, EnterKeyEvent, FocusInEvent, FocusOutEvent, InitializedEvent, InputEvent, KeyDownEvent, KeyUpEvent, OpenedEvent, OptionChangedEvent, PasteEvent, ValueChangedEvent } from 'devextreme/ui/date_range_box'; import DxDateRangeBox from 'devextreme/ui/date_range_box'; import { ControlValueAccessor } from '@angular/forms'; import { DxComponent, DxTemplateHost, NestedOptionHost, IterableDifferHelper, WatcherHelper, CollectionNestedOption } from 'devextreme-angular/core'; import type * as DxDateRangeBoxTypes from "devextreme/ui/date_range_box_types"; import * as i0 from "@angular/core"; import * as i1 from "devextreme-angular/ui/nested"; import * as i2 from "devextreme-angular/ui/date-range-box/nested"; import * as i3 from "devextreme-angular/core"; /** * DateRangeBox is a UI component that allows a user to select a date range (pick or enter start and end dates). */ export declare class DxDateRangeBoxComponent extends DxComponent implements OnDestroy, ControlValueAccessor, OnChanges, DoCheck { private _watcherHelper; private _idh; set _buttonsContentChildren(value: QueryList); set _toolbarItemsContentChildren(value: QueryList); instance: DxDateRangeBox; /** * Specifies whether or not the UI component allows an end user to enter a custom value. */ get acceptCustomValue(): boolean; set acceptCustomValue(value: boolean); /** * Specifies the shortcut key that sets focus on the UI component. */ get accessKey(): string | undefined; set accessKey(value: string | undefined); /** * Specifies whether the UI component changes its visual state as a result of user interaction. */ get activeStateEnabled(): boolean; set activeStateEnabled(value: boolean); /** * Specifies the Apply button's text. */ get applyButtonText(): string; set applyButtonText(value: string); /** * Specifies the way an end user applies the selected value. */ get applyValueMode(): ApplyValueMode; set applyValueMode(value: ApplyValueMode); /** * Allows you to add custom buttons to the input text field. */ get buttons(): Array; set buttons(value: Array); /** * Configures the calendar's value picker. */ get calendarOptions(): dxCalendarOptions; set calendarOptions(value: dxCalendarOptions); /** * Specifies the Cancel button's text. */ get cancelButtonText(): string; set cancelButtonText(value: string); /** * Specifies the date value serialization format. */ get dateSerializationFormat(): string | undefined; set dateSerializationFormat(value: string | undefined); /** * Specifies whether to render the drop-down field's content when it is displayed. If false, the content is rendered immediately. */ get deferRendering(): boolean; set deferRendering(value: boolean); /** * Specifies whether the UI component responds to user interaction. */ get disabled(): boolean; set disabled(value: boolean); /** * Specifies whether the UI component disables date selection before the start date and after the end date. */ get disableOutOfRangeSelection(): boolean; set disableOutOfRangeSelection(value: boolean); /** * Specifies the date's display format. */ get displayFormat(): Format; set displayFormat(value: Format); /** * Specifies a custom template for the drop-down button. */ get dropDownButtonTemplate(): any; set dropDownButtonTemplate(value: any); /** * Configures the drop-down that holds the content. */ get dropDownOptions(): dxPopupOptions; set dropDownOptions(value: dxPopupOptions); /** * Specifies the global attributes to be attached to the UI component's container element. */ get elementAttr(): Record; set elementAttr(value: Record); /** * Specifies the range's end date. */ get endDate(): Date | null | number | string; set endDate(value: Date | null | number | string); /** * Specifies the attributes passed to the end date input field. */ get endDateInputAttr(): any; set endDateInputAttr(value: any); /** * Specifies the label of the end date input field. */ get endDateLabel(): string; set endDateLabel(value: string); /** * Specifies the name attribute of the end date input field. */ get endDateName(): string; set endDateName(value: string); /** * Specifies the message displayed if the specified end date is later than the max value or earlier than the min value. */ get endDateOutOfRangeMessage(): string; set endDateOutOfRangeMessage(value: string); /** * Specifies a placeholder for the end date input field. */ get endDatePlaceholder(): string; set endDatePlaceholder(value: string); /** * Returns the text displayed by the end date input field. */ get endDateText(): string; set endDateText(value: string); /** * Specifies whether the UI component can be focused using keyboard navigation. */ get focusStateEnabled(): boolean; set focusStateEnabled(value: boolean); /** * Specifies the UI component's height. */ get height(): number | string | undefined; set height(value: number | string | undefined); /** * Specifies text for a hint that appears when a user pauses on the UI component. */ get hint(): string | undefined; set hint(value: string | undefined); /** * Specifies whether the UI component changes its state when a user pauses on it. */ get hoverStateEnabled(): boolean; set hoverStateEnabled(value: boolean); /** * Specifies a message for invalid end date input. */ get invalidEndDateMessage(): string; set invalidEndDateMessage(value: string); /** * Specifies a message for invalid start date input. */ get invalidStartDateMessage(): string; set invalidStartDateMessage(value: string); /** * Specifies whether the component's current value differs from the initial value. */ get isDirty(): boolean; set isDirty(value: boolean); /** * Specifies or indicates whether the editor's value is valid. */ get isValid(): boolean; set isValid(value: boolean); /** * Specifies the label's display mode. */ get labelMode(): LabelMode; set labelMode(value: LabelMode); /** * The latest date that can be selected in the UI component. */ get max(): Date | null | number | string | undefined; set max(value: Date | null | number | string | undefined); /** * The earliest date that can be selected in the UI component. */ get min(): Date | null | number | string | undefined; set min(value: Date | null | number | string | undefined); /** * Specifies whether the UI component displays a single-month calendar or a multi-month calendar. */ get multiView(): boolean; set multiView(value: boolean); /** * Specifies whether or not the drop-down editor is displayed. */ get opened(): boolean; set opened(value: boolean); /** * Specifies whether a user can open the popup calendar by clicking an input field. */ get openOnFieldClick(): boolean; set openOnFieldClick(value: boolean); /** * Specifies whether the editor is read-only. */ get readOnly(): boolean; set readOnly(value: boolean); /** * Switches the UI component to a right-to-left representation. */ get rtlEnabled(): boolean; set rtlEnabled(value: boolean); /** * Specifies whether to display the Clear button in the UI component. */ get showClearButton(): boolean; set showClearButton(value: boolean); /** * Specifies whether the drop-down button is visible. */ get showDropDownButton(): boolean; set showDropDownButton(value: boolean); /** * Specifies whether or not the UI component checks the inner text for spelling mistakes. */ get spellcheck(): boolean; set spellcheck(value: boolean); /** * Specifies the start date of date range. */ get startDate(): Date | null | number | string; set startDate(value: Date | null | number | string); /** * Specifies the attributes passed to the start date input field. */ get startDateInputAttr(): any; set startDateInputAttr(value: any); /** * Specifies a label of the start date input field. */ get startDateLabel(): string; set startDateLabel(value: string); /** * Specifies the name attribute of the start date input field. */ get startDateName(): string; set startDateName(value: string); /** * Specifies the message displayed if the specified start date is later than the max value or earlier than the min value. */ get startDateOutOfRangeMessage(): string; set startDateOutOfRangeMessage(value: string); /** * Specifies a placeholder for the start date input field. */ get startDatePlaceholder(): string; set startDatePlaceholder(value: string); /** * Returns the text displayed by the start date input field. */ get startDateText(): string; set startDateText(value: string); /** * Specifies how the UI component's text field is styled. */ get stylingMode(): EditorStyle; set stylingMode(value: EditorStyle); /** * Specifies the number of the element when the Tab key is used for navigating. */ get tabIndex(): number; set tabIndex(value: number); /** * Specified the Today button's text. */ get todayButtonText(): string; set todayButtonText(value: string); /** * Specifies whether to use an input mask based on the displayFormat property. */ get useMaskBehavior(): boolean; set useMaskBehavior(value: boolean); /** * Information on the broken validation rule. Contains the first item from the validationErrors array. */ get validationError(): any; set validationError(value: any); /** * An array of validation errors. */ get validationErrors(): Array; set validationErrors(value: Array); /** * Specifies how the message about the validation rules that are not satisfied by this editor's value is displayed. */ get validationMessageMode(): ValidationMessageMode; set validationMessageMode(value: ValidationMessageMode); /** * Specifies the position of a validation message relative to the component. The validation message describes the validation rules that this component's value does not satisfy. */ get validationMessagePosition(): Mode | Position; set validationMessagePosition(value: Mode | Position); /** * Indicates or specifies the current validation status. */ get validationStatus(): ValidationStatus; set validationStatus(value: ValidationStatus); /** * An array that specifies the selected range (start and end dates). */ get value(): Array; set value(value: Array); /** * Specifies the DOM events after which the UI component's value should be updated. */ get valueChangeEvent(): string; set valueChangeEvent(value: string); /** * Specifies whether the UI component is visible. */ get visible(): boolean; set visible(value: boolean); /** * Specifies the UI component's width. */ get width(): number | string | undefined; set width(value: number | string | undefined); /** * A function that is executed when the UI component loses focus after the text field's content was changed using the keyboard. */ onChange: EventEmitter; /** * A function that is executed once the drop-down editor is closed. */ onClosed: EventEmitter; /** * A function that is executed when the UI component is rendered and each time the component is repainted. */ onContentReady: EventEmitter; /** * A function that is executed when the UI component's input has been copied. */ onCopy: EventEmitter; /** * A function that is executed when the UI component's input has been cut. */ onCut: EventEmitter; /** * A function that is executed before the UI component is disposed of. */ onDisposing: EventEmitter; /** * A function that is executed when the Enter key has been pressed while the UI component is focused. */ onEnterKey: EventEmitter; /** * A function that is executed when the UI component gets focus. */ onFocusIn: EventEmitter; /** * A function that is executed when the UI component loses focus. */ onFocusOut: EventEmitter; /** * A function used in JavaScript frameworks to save the UI component instance. */ onInitialized: EventEmitter; /** * A function that is executed each time the UI component's input is changed while the UI component is focused. */ onInput: EventEmitter; /** * A function that is executed when a user is pressing a key on the keyboard. */ onKeyDown: EventEmitter; /** * A function that is executed when a user releases a key on the keyboard. */ onKeyUp: EventEmitter; /** * A function that is executed once the drop-down editor is opened. */ onOpened: EventEmitter; /** * A function that is executed after a UI component property is changed. */ onOptionChanged: EventEmitter; /** * A function that is executed when the UI component's input has been pasted. */ onPaste: EventEmitter; /** * A function that is executed after the UI component's value is changed. */ onValueChanged: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ acceptCustomValueChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ accessKeyChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ activeStateEnabledChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ applyButtonTextChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ applyValueModeChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ buttonsChange: EventEmitter>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ calendarOptionsChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ cancelButtonTextChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ dateSerializationFormatChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ deferRenderingChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ disabledChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ disableOutOfRangeSelectionChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ displayFormatChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ dropDownButtonTemplateChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ dropDownOptionsChange: EventEmitter>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ elementAttrChange: EventEmitter>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDateChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDateInputAttrChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDateLabelChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDateNameChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDateOutOfRangeMessageChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDatePlaceholderChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ endDateTextChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ focusStateEnabledChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ heightChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ hintChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ hoverStateEnabledChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ invalidEndDateMessageChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ invalidStartDateMessageChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ isDirtyChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ isValidChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ labelModeChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ maxChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ minChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ multiViewChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ openedChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ openOnFieldClickChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ readOnlyChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ rtlEnabledChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ showClearButtonChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ showDropDownButtonChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ spellcheckChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDateChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDateInputAttrChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDateLabelChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDateNameChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDateOutOfRangeMessageChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDatePlaceholderChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ startDateTextChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ stylingModeChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ tabIndexChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ todayButtonTextChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ useMaskBehaviorChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ validationErrorChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ validationErrorsChange: EventEmitter>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ validationMessageModeChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ validationMessagePositionChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ validationStatusChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ valueChange: EventEmitter>; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ valueChangeEventChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ visibleChange: EventEmitter; /** * This member supports the internal infrastructure and is not intended to be used directly from your code. */ widthChange: EventEmitter; /** * */ onBlur: EventEmitter; change(_: any): void; touched: (_: any) => void; constructor(elementRef: ElementRef, ngZone: NgZone, templateHost: DxTemplateHost, _watcherHelper: WatcherHelper, _idh: IterableDifferHelper, optionHost: NestedOptionHost, transferState: TransferState, platformId: any); protected _createInstance(element: any, options: any): DxDateRangeBox; writeValue(value: any): void; setDisabledState(isDisabled: boolean): void; registerOnChange(fn: (_: any) => void): void; registerOnTouched(fn: () => void): void; _createWidget(element: any): void; ngOnDestroy(): void; ngOnChanges(changes: SimpleChanges): void; setupChanges(prop: string, changes: SimpleChanges): void; ngDoCheck(): void; _setOption(name: string, value: any): void; static ɵfac: i0.ɵɵFactoryDeclaration; static ɵcmp: i0.ɵɵComponentDeclaration; } export declare class DxDateRangeBoxModule { static ɵfac: i0.ɵɵFactoryDeclaration; static ɵmod: i0.ɵɵNgModuleDeclaration; static ɵinj: i0.ɵɵInjectorDeclaration; } export * from 'devextreme-angular/ui/date-range-box/nested'; export { DxDateRangeBoxTypes };