/*! * * Wijmo Library 5.20252.44 * https://developer.mescius.com/wijmo * * Copyright(c) MESCIUS inc. All rights reserved. * * Licensed under the End-User License Agreement For MESCIUS Wijmo Software. * us.sales@mescius.com * https://developer.mescius.com/wijmo/licensing * */ /** * {@module wijmo.input} * Defines input controls for strings, numbers, dates, times, and colors. */ /** * */ export declare var ___keepComment: any; import { Control, Event, EventArgs, CancelEventArgs, Binding, Rect, ICollectionView, CollectionViewGroup, _ClickRepeater, CollectionView, _MaskProvider, PopupPosition } from 'wijmo/wijmo'; import * as selfModule from 'wijmo/wijmo.input'; export declare const AutoCompleteClsNames: { hostElement: string; }; export declare const CalendarClsNames: { buttonsOutside: string; calendarHeader: string; calendarMonth: string; calendarMultiMonth: string; calendarOuter: string; calendarYear: string; dayOtherMonth: string; dayToday: string; dayWeekend: string; header: string; hostElement: string; monthSelect: string; weekAfter: string; weekBefore: string; yearPicker: string; focused: string; selectedYear: string; confirmationButtonContainer: string; button: string; }; export declare const CollectionViewNavigatorClsNames: { hostElement: string; pager: string; }; export declare const ColorPickerClsNames: { colorBox: string; hostElement: string; }; export declare const ComboBoxClsNames: { hostElement: string; stateMatch: string; }; export declare const DropDownClsNames: { dropDownPanel: string; hostElement: string; }; export declare const InputClsNames: { input: string; inputBtnVisible: string; inputGroup: string; inputGroupBtn: string; }; export declare const InputColorClsNames: { hostElement: string; inputColorBox: string; }; export declare const InputDateClsNames: { hostElement: string; inputDateDropDown: string; inputDateDropDownContainer: string; }; export declare const InputDateRangeClsNames: { hostElement: string; }; export declare const InputDateTimeClsNames: { hostElement: string; showDropDownButton: string; }; export declare const InputMaskClsNames: { hostElement: string; }; export declare const InputNumberClsNames: { hostElement: string; numeric: string; showSpinner: string; }; export declare const InputTimeClsNames: { hostElement: string; }; export declare const ListBoxClsNames: { header: string; hostElement: string; listBoxItem: string; }; export declare const MenuClsNames: { hostElement: string; menuItems: string; subItems: string; }; export declare const MultiAutoCompleteClsNames: { hostElement: string; token: string; tokenActive: string; tokenClose: string; tokenHelper: string; tokenLabel: string; screenReaderOnly: string; }; export declare const MultiSelectClsNames: { hostElement: string; }; export declare const MultiSelectListBoxClsNames: { header: string; hostElement: string; selectAll: string; }; export declare const PopupClsNames: { dialogHeader: string; hostElement: string; popupBackDrop: string; dialogBody: string; dialogFooter: string; }; /** * The {@link InputNumber} control allows users to enter numbers. * * The control prevents users from accidentally entering invalid data and * formats the number as it is edited. * * Pressing the minus key reverses the sign of the value being edited, * regardless of cursor position. * * You may use the {@link min} and {@link max} properties to limit the range of * acceptable values, and the {@link step} property to provide spinner buttons * that increase or decrease the value with a click. * * For details about using the {@link min} and {@link max} properties, please see * the Using the min and max properties topic. * * Use the {@link value} property to get or set the currently selected number. * * The example below creates several {@link InputNumber} controls and shows * the effect of using different formats. * * {@sample Input/InputNumber/Formatting/purejs Example} */ export declare class InputNumber extends Control { _tbx: HTMLInputElement; _btnUp: HTMLElement; _btnDn: HTMLElement; _value: number; _min: number; _max: number; _format: string; _step: number; _showBtn: boolean; _readOnly: boolean; _handleWheel: boolean; _oldText: string; _oldValue: number; _composing: boolean; _chrDec: string; _chrCur: string; _chrNeg: string; _chrPls: string; _chrPct: string; _chrTho: string; _fmtSpc: string; _fmtPrc: number; _rxSym: RegExp; _rxNeg: RegExp; _delKey: boolean; _rptUp: _ClickRepeater; _rptDn: _ClickRepeater; _fromKb: boolean; static _ctrlTemplate: string; _inputElementAriaLabel: string; _ariaLabelledby: string; /** * Gets or sets the template used to instantiate {@link InputNumber} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputNumber} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets the HTML input element hosted by the control. * * Use this property in situations where you want to customize the * attributes of the input element. */ readonly inputElement: HTMLInputElement; /** * Gets or sets the "type" attribute of the HTML input element hosted by the control. * * By default, this property is set to "tel", a value that causes mobile devices to * show a numeric keypad that includes a negative sign and a decimal separator. * * Use this property to change the default setting if the default does not work well * for the current culture, device, or application. In those cases, try changing * the value to "number" or "text." * * Note that input elements with type "number" prevent selection in Chrome and * therefore that type is not recommended. For more details, see this link: * https://stackoverflow.com/questions/21177489/selectionstart-selectionend-on-input-type-number-no-longer-allowed-in-chrome */ inputType: string; /** * Gets or sets the current value of the control. */ value: number | null; /** * Gets or sets a value indicating whether the control value must be * a number or whether it can be set to null (by deleting the content * of the control). * * The default value for this property is **true**. */ isRequired: boolean; /** * Gets or sets a value that indicates whether the user can modify * the control value using the mouse and keyboard. * * The default value for this property is **false**. */ isReadOnly: boolean; /** * Gets or sets a value that determines whether the user can edit the * value using the mouse wheel. * * The default value for this property is **true**. */ handleWheel: boolean; /** * Gets or sets the smallest number that the user can enter. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ min: number | null; /** * Gets or sets the largest number that the user can enter. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ max: number | null; /** * Gets or sets the amount to add or subtract to the {@link value} property * when the user clicks the spinner buttons. * * The default value for this property is **null**, which hides the spinner * buttons from the control. */ step: number | null; /** * Gets or sets the format used to display the number being edited (see {@link Globalize}). * * The format string is expressed as a .NET-style * * standard numeric format string. */ format: string; /** * Gets or sets the text shown in the control. */ text: string; /** * Gets or sets the string shown as a hint when the control is empty. */ placeholder: string; /** * Gets or sets a value indicating whether the control displays spinner buttons * to increment or decrement the value (the step property must be set to a * value other than zero). * * The default value for this property is **true**. */ showSpinner: boolean; /** * Gets or sets a value that determines whether the spinner buttons * should act as repeat buttons, firing repeatedly as long as the * button remains pressed. * * The default value for this property is **true**. */ repeatButtons: boolean; /** * Gets or sets the aria-labelledby attribute of input element. */ ariaLabelledBy: string; /** * Sets the focus to the control and selects all its content. */ selectAll(): void; /** * Returns a value within the range defined by the {@link min} and {@link max} * properties. * * @param value Value to clamp. */ clamp(value: number): number; /** * Occurs when the value of the {@link text} property changes. */ readonly textChanged: Event; /** * Raises the {@link textChanged} event. */ onTextChanged(e?: EventArgs): void; /** * Occurs when the value of the {@link value} property changes, either * as a result of user actions or by assignment in code. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; dispose(): void; onGotFocus(e: EventArgs): void; onLostFocus(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; private _isEditable; private _updateSymbols; private _isNumeric; private _getInputRange; private _flipSign; private _getSelStartDigits; private _setSelStartDigits; private _increment; protected _updateBtn(): void; _setText(text: string, truncate?: boolean, forceDelete?: boolean): void; private _handleDecimalInput; protected _beforeinput(e: any): void; protected _keypress(e: KeyboardEvent): void; private _handlePlusSign; private _handleMinusSign; protected _keydown(e: KeyboardEvent): void; protected _input(): void; /** * Checks if the value represents a negative currency entered using parentheses. * Scenario: * 1. First input "(" → value changes to "-$0.00" * 2. Then input a digit (e.g., "1") → value changes to "-$01.00" */ private _isNegativeCurrencyByParenthesis; protected _clickSpinner(e: MouseEvent): void; protected _updateAria(): void; _updateInputAriaLabel(): void; getAriaLabelForScreenReader(): any; } /** * The {@link InputMask} control provides a way to govern what a user is allowed * to enter. * * The control prevents users from accidentally entering invalid data and * saves time by skipping over literals (such as slashes in dates) as the * user types. * * The mask used to validate the input is defined by the {@link InputMask.mask} * property, which may contain one or more of the following special * characters: * *
*
0
Digit.
*
9
Digit or space.
*
#
Digit, sign, or space.
*
L
Letter.
*
l
Letter or space.
*
A
Alphanumeric.
*
a
Alphanumeric or space.
*
.
Localized decimal point.
*
,
Localized thousand separator.
*
:
Localized time separator.
*
/
Localized date separator.
*
$
Localized currency symbol.
*
<
Converts characters that follow to lowercase.
*
>
Converts characters that follow to uppercase.
*
|
Disables case conversion.
*
\
Escapes any character, turning it into a literal.
*
９ (\uff19)
DBCS Digit.
*
Ｊ (\uff2a)
DBCS Hiragana.
*
Ｇ (\uff27)
DBCS big Hiragana.
*
Ｋ (\uff2b)
DBCS Katakana.
*
Ｎ (\uff2e)
DBCS big Katakana.
*
K
SBCS Katakana.
*
N
SBCS big Katakana.
*
Ｚ (\uff3a)
Any DBCS character.
*
H
Any SBCS character.
*
All others
Literals.
*
* * The example below shows how you can use the {@link InputMask} control to * edit strings with custom formats: * * {@sample Input/InputMask/Overview Example} */ export declare class InputMask extends Control { _tbx: HTMLInputElement; _oldValue: string; _value: string; _msk: _MaskProvider; _fullEdit: boolean; static _ctrlTemplate: string; _inputElementAriaLabel: string; _ariaLabelledby: string; /** * Gets or sets the template used to instantiate {@link InputMask} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputMask} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets the HTML input element hosted by the control. * * Use this property in situations where you want to customize the * attributes of the input element. */ readonly inputElement: HTMLInputElement; /** * Gets or sets the "type" attribute of the HTML input element hosted * by the control. * * The default value for this property is **'text'**. */ inputType: string; /** * Gets or sets the text currently shown in the control. */ value: string; /** * Gets or sets the raw value of the control (excluding mask literals). * * The raw value of the control excludes prompt and literal characters. * For example, if the {@link mask} property is set to "AA-9999" and the * user enters the value "AB-1234", the {@link rawValue} property will * return "AB1234", excluding the hyphen that is part of the mask. */ rawValue: string; /** * Gets or sets the mask used to validate the input as the user types. * * The mask is defined as a string with one or more of the masking * characters listed in the {@link InputMask} topic. * * The default value for this property is the empty string **''**. */ mask: string; /** * Gets or sets the symbol used to show input positions in the control. */ promptChar: string; /** * Gets or sets a value that determines whether the input element handles input in * overwrite mode. * * In **overwrite mode**, every character you type is displayed at the cursor position. * If a character is already at that position, it is replaced. * * In **insert mode**, each character you type is inserted at the cursor position. * * The default value for this property is **false**. */ overwriteMode: boolean; /** * Gets or sets the string shown as a hint when the control is empty. */ placeholder: string; /** * Gets a value that indicates whether the mask has been completely filled. */ readonly maskFull: boolean; /** * Gets or sets a value indicating whether the control value * must be a non-empty string. * * The default value for this property is **true**. */ isRequired: boolean; /** * Gets or sets a value that indicates whether the user can modify * the control value using the mouse and keyboard. * * The default value for this property is **false**. */ isReadOnly: boolean; /** * Sets the focus to the control and selects all its content. */ selectAll(): void; /** * Occurs when the value of the {@link value} property changes, either * as a result of user actions or by assignment in code. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; _commitText(): void; dispose(): void; refresh(fullUpdate?: boolean): void; onGotFocus(e: any): void; /** * Gets or sets the aria-labelledby attribute of input element. */ ariaLabelledBy: string; _updateInputAriaLabel(): void; getAriaLabelForScreenReader(): any; } /** * Specifies constants that define the action to be performed when the TAB key is pressed. */ export declare enum ColorPickerTabKeyAction { /** No special action (let the browser handle the key). */ None = 0, /** All buttons in the color picker can be selected using the tab key. */ All = 1 } /** * The {@link ColorPicker} control allows users to select a color by clicking * on panels to adjust color channels (hue, saturation, brightness, alpha). * * Use the {@link value} property to get or set the currently selected color. * * The control is used as a drop-down for the {@link InputColor} control. * * {@sample Input/InputColor/Overview/purejs Example} */ export declare class ColorPicker extends Control { _hsb: number[]; _alpha: number; _value: string; _palette: string[]; _eSB: HTMLElement; _eHue: HTMLElement; _eAlpha: HTMLElement; _cSB: HTMLElement; _cHue: HTMLElement; _cAlpha: HTMLElement; _ePal: HTMLElement; _ePreview: HTMLElement; _eText: HTMLElement; _ePalMainFirst: HTMLElement; _ePalShadeFirst: HTMLElement; _htDown: Element; _ariaLabel: string; private _keyActionTab; static _ctrlTemplate: string; /** * Gets or sets the template used to instantiate {@link ColorPicker} controls. */ static controlTemplate: string; static _tplCursor: string; /** * Initializes a new instance of the {@link ColorPicker} class. * * @param element The DOM element that hosts the control, or a selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets a value indicating whether the {@link ColorPicker} allows users * to edit the color's alpha channel (transparency). * * The default value for this property is **true**. */ showAlphaChannel: boolean; /** * Gets or sets a value indicating whether the {@link ColorPicker} shows a string representation * of the current color. * * The default value for this property is **false**. */ showColorString: boolean; /** * Gets or sets the currently selected color. * * The default value for this property is **"#ffffff"** (white). * * Setting this property to a string that cannot be interpreted as * a color causes the assignment to be ignored (no exceptions are * thrown). */ value: string; /** * Gets or sets an array that contains the colors in the palette. * * The default palette contains up to ten colors, represented by * an array with color strings. * * For each color in the palette, the control generates six buttons * ranging from light to dark versions of the main color. Users * may click these color buttons to select the color they want. * * You may customize the palette by providing the color string array * you want to use. Palettes contain up to ten colors, and the first * two are usually white and black. * * Palette arrays with more than 10 colors are truncated, and * arrays with values that do not represent colors are ignored. * No exceptions are thrown in these cases. */ palette: string[]; /** * Gets or sets the aria-label attribute of {@link ColorPicker} host element. * * The default value for this property is "Color Picker". */ ariaLabel: string; /** * Gets or sets the action to perform when the Tab key is pressed. * * The default setting for this property is {@link ColorPickerTabKeyAction.None}, * This means that pressing the tab key will have no effect and follow the browser's default behavior. */ keyActionTab: ColorPickerTabKeyAction; _setTabOrder(value: number): void; /** * Occurs when the value of the {@link value} property changes, either * as a result of user actions or by assignment in code. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; protected _mouseDown(e: MouseEvent): void; protected _mouseMove(e: MouseEvent): void; protected _mouseUp(e: MouseEvent): void; private _updateColor; private _updatePalette; private _makePalEntry; private _updatePanels; private getColorsDiv; private _getTargetPanel; protected getActualTabIndex(): string; private _updateTabIndex; protected _setIsDisabled(value: boolean): void; private _updateAriaValues; private _keydown; private _isInColorPalette; private _handleColorNavigation; private _handleHSBNavigation; _refreshSelection(): void; private _handleAlphaNavigation; } /** * The {@link CollectionViewNavigator} control provides a UI for navigating * through the data items or pages in a {@link CollectionView} object. * * Use the navigator's {@link cv} property to bind it to a {@link CollectionView}, * and the {@link byPage} property to define whether the navigator should show * data items or pages. * * The navigator shows VCR-like buttons that allow users to select the * first/previous/next/last data item (or page) in the {@link CollectionView}, * and some text showing the current index and total count. * * You may use the {@link headerFormat} property to customize the text displayed * by the navigator. */ export declare class CollectionViewNavigator extends Control { private _btnFirst; private _btnPrev; private _btnNext; private _btnLast; private _txtCurr; private _view; private _byPage; private _rptNext; private _rptPrev; private _fmt; private _liveRegionON; private _ariaLabel; private _isDisabled; static _ctrlTemplate: string; /** * Gets or sets the template used to instantiate {@link CollectionViewNavigator} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link CollectionViewNavigator} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the {@link CollectionView} controlled by this {@link CollectionViewNavigator}. */ cv: CollectionView; /** * Gets or sets a value that determines whether this {@link CollectionViewNavigator} should * navigate items or pages. * * To navigate pages, the {@link CollectionView} associated with the navigator should * have it's {@link CollectionView.pageSize} property set to a value greater than zero. * * The default value for this property is **false**. */ byPage: boolean; /** * Gets or sets the format string used to display the current * total item/page values in the control header. * * The format string may contain the '{current}' and '{count}' * replacement strings, which are replaced with values that * depend on the value of the {@link byPage} property. * * The format string may also contain the following replacement * strings: '{currentItem}', '{itemCount}', '{currentPage}', and * '{pageCount}', which are replaced with values that do not * depend on the value of the {@link byPage} property. * * The default value for this property is the string * **"{current:n0} / {count:n0}"**. * * The control header element is an input element and contains * plain text (HTML is not supported). */ headerFormat: string; /** * Gets or sets a value that determines whether the next/previous buttons * should act as repeat buttons, firing repeatedly as long as the button * remains pressed. * * The default value for this property is **true**. */ repeatButtons: boolean; /** * Gets or sets the aria-label attribute of {@link CollectionViewNavigator} element. */ ariaLabel: string; /** * Gets or sets a value that determines whether the control is disabled. * * Disabled controls cannot get mouse or keyboard events. */ isDisabled: boolean; /** * Sets the focus to this control. */ focus(): void; _update(): void; _currentChanged(): void; _collectionChanged(): void; _click(e: MouseEvent): void; private _updateAriaLabels; private _addA11yRelatedHandlers; protected _setTabOrder(value: number): void; _keydown(e: KeyboardEvent): void; protected _setIsDisabled(value: boolean): void; _updateTabIndex(): void; } /** * Represents a method that formats an item for display in a * {@link ListBox} control. */ export interface IItemFormatter { /** * @param index Index of the item being formatted. * @param item Default text or HTML used to represent the item. * @returns Customized text or HTML used to represent the item. */ (index: number, item: string): string; } /** * The {@link ListBox} control displays a list of items which may contain * plain text or HTML, and allows users to select items with the mouse * or the keyboard. * * Use the {@link ListBox.selectedIndex} property to determine which item * is currently selected. * * You can populate a {@link ListBox} using an array of strings or you can * use an array of objects, in which case the {@link ListBox.displayMemberPath} * property determines which object property is displayed on the list. * * To display items that contain HTML rather than plain text, set the * {@link ListBox.isContentHtml} property to true. * * The {@link ListBox} control supports the following keyboard commands: * * * * * * * * * * * * *
Key CombinationAction
Up/DownSelect the previous/next item
PageUp/DownSelect the item one page above or below the selection
Home/EndSelect the first/last items
SpaceToggle the checkbox in the current item (see the {@link checkedMemberPath} property)
Other charactersSearch for items that contain the text typed (multi-character auto-search)
* * The example below creates a {@link ListBox} control and populates it using * a 'countries' array. The control updates its {@link ListBox.selectedIndex} * and {@link ListBox.selectedItem} properties as the user moves the selection. * * {@sample Input/ListBox/Overview/purejs Example} */ export declare class ListBox extends Control { _items: any; _cv: ICollectionView | null; _itemFormatter: IItemFormatter | null; _pathDisplay: Binding; _pathValue: Binding; _pathChecked: Binding; _html: boolean; _shGroups: boolean; private _checkedItems; _itemRole: string; _caseSensitive: boolean; _addMode: boolean; private _isShiftDown; private _shouldClearOnShift; _vThreshold: number; _isVirtual: boolean; _children: HTMLElement[]; _ignoreItemFormatterTextArray: string[]; _itemFormatterHelper: HTMLDivElement; _clientHeight: number; _itemHeight: number; _itemsAbove: number; _itemsBelow: number; _eSizer: HTMLDivElement; _ePadTop: HTMLDivElement; _ePadBot: HTMLDivElement; _checking: boolean; _ignoredItemChangedEvents: boolean; _search: string; _toSearch: any; _fmtItemHandlers: number; _itemCount: number; _oldSel: HTMLElement | null; _container: HTMLElement | null; _oldSelectedIndex: number; _ariaLabel: string; static _DIDX_KEY: string; static _VTHRESH: number; _isNeedUpdateBnd: boolean; /** * Initializes a new instance of the {@link ListBox} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the aria-labelledby attribute of {@link ListBox} input element. */ ariaLabelledBy: string; /** * Gets or sets the array or {@link ICollectionView} object that contains * the list items. */ itemsSource: any; /** * Gets the {@link ICollectionView} object used as the item source. */ readonly collectionView: ICollectionView; /** * Gets or sets the minimum number of rows and/or columns required to enable * virtualization. * * When the {@link ListBox} is virtualized, only the items that are currently * visible are added to the DOM. This makes a huge difference in performance * when the {@link ListBox} contains a large number of items (say 1,000 or so). * * The default value for this property is a very big number, meaning virtualization is * disabled. To enable virtualization, set its value to 0 or a positive number. * * Virtualization assumes a vertically stacked layout, so it is automatically * disabled if the {@link ListBox} uses a multi-column display (such as a * flexbox or grid layout). */ virtualizationThreshold: number; /** * Gets or sets a value that determines whether the {@link ListBox} should * include group header items to delimit data groups. * * Data groups are created by modifying the {@link ICollectionView.groupDescriptions} * property of the {@link ICollectionView} object used as an {@link itemsSource}. * * The {@link ListBox} only shows the first level of grouping. * * The default value for this property is **false**. */ showGroups: boolean; /** * Gets or sets a value indicating whether items contain plain * text or HTML. * * The default value for this property is **false**. */ isContentHtml: boolean; /** * Gets or sets a function used to customize the values shown on * the list. * * The function takes two arguments, the item index and the default * text or html, and returns the new text or html to display. * * If the formatting function needs a scope (i.e. a meaningful * 'this' value), then remember to set the filter using the 'bind' * function to specify the 'this' object. For example: * * ```typescript * listBox.itemFormatter = customItemFormatter.bind(this); * function customItemFormatter(index, content) { * if (this.makeItemBold(index)) { * content = '<b>' + content + '</b>'; * } * return content; * } * ``` */ itemFormatter: IItemFormatter; /** * Gets or sets the name of the property to use as the visual * representation of the items. * * The default value for this property is the empty string **''**. */ displayMemberPath: string; /** * Gets or sets the name of the property used to get the * {@link selectedValue} from the {@link selectedItem}. * * The default value for this property is the empty string **''**. */ selectedValuePath: string; /** * Gets or sets the name of the property used to control * check boxes placed next to each item. * * Use this property to create multi-select ListBoxes. * * When an item is checked or unchecked, the control raises the * {@link itemChecked} event. * * Use the {@link selectedItem} property to retrieve the item that * was checked or unchecked, or use the {@link checkedItems} property * to retrieve the list of items that are currently checked. * * The default value for this property is the empty string **''**. */ checkedMemberPath: string; /** * Gets or sets a value that determines whether searches performed * while the user types should case-sensitive. * * The default value for this property is **false**. */ caseSensitiveSearch: boolean; /** * Gets or sets the value or the "role" attribute added to the * list items. * * The default value for this property is the string **"option"**. */ itemRole: string; /** * Gets the string displayed for the item at a given index. * * The string may be plain text or HTML, depending on the setting * of the {@link isContentHtml} property. * * @param index The index of the item in the {@link itemsSource}. */ getDisplayValue(index: number, ignoreItemFormatter?: boolean): string; /** * Gets the text displayed for the item at a given index (as plain text). * * @param index The index of the item in the {@link itemsSource}. */ getDisplayText(index: number): string; _getDisplayText(index: number, notGetByList?: boolean): string; /** * Gets a value that determines whether the item at a given index is enabled. * * @param index The index of the item in the {@link itemsSource}. */ isItemEnabled(index: number): boolean; /** * Gets or sets the index of the currently selected item. */ selectedIndex: number; /** * Gets or sets the item that is currently selected. */ selectedItem: any; /** * Gets or sets the value of the {@link selectedItem} obtained using * the {@link selectedValuePath}. */ selectedValue: any; /** * Gets or sets the maximum height of the list (in pixels). * * The default value for this property is **null**, which * means the {@link ListBox} has no maximum height limit. */ maxHeight: number; /** * Highlights the selected item and scrolls it into view. * * @param setFocus Whether to set the focus to the list after scrolling * the selected item into view. */ showSelection(setFocus?: boolean): void; /** * Loads the list with items from the current {@link itemsSource}. */ loadList(): void; /** * Gets the checked state of an item on the list. * * This method can be used with multi-select ListBoxes * (see the {@link checkedMemberPath} property). * * @param index Item index. */ getItemChecked(index: number): boolean; /** * Sets the checked state of an item on the list. * * This method is applicable only on multi-select ListBoxes * (see the {@link checkedMemberPath} property). * * If the checked state of the item changes, the item becomes * selected. * * @param index Item index. * @param checked Item's new checked state. */ setItemChecked(index: number, checked: boolean | null): void; /** * Toggles the checked state of an item on the list. * This method is applicable only to multi-select ListBoxes * (see the {@link checkedMemberPath} property). * * @param index Item index. */ toggleItemChecked(index: number): void; /** * Gets or sets an array containing the items that are currently checked. * * Setting this property does not change the value of the * {@link selectedIndex} property. */ checkedItems: any[]; /** * Gets the data index of an element within the list. * * @param e Element to search for. * @return The index of the element in the list, or -1 if the element * is not a member of the list. */ indexOf(e: HTMLElement): number; /** * Occurs when the value of the {@link selectedIndex} property changes. */ readonly selectedIndexChanged: Event, EventArgs>; /** * Raises the {@link selectedIndexChanged} event. */ onSelectedIndexChanged(e?: EventArgs): void; /** * Occurs when the list of items changes. */ readonly itemsChanged: Event, EventArgs>; /** * Raises the {@link itemsChanged} event. */ onItemsChanged(e?: EventArgs): void; /** * Occurs before the list items are generated. */ readonly loadingItems: Event, EventArgs>; /** * Raises the {@link loadingItems} event. */ onLoadingItems(e?: EventArgs): void; /** * Occurs after the list items have been generated. */ readonly loadedItems: Event, EventArgs>; /** * Raises the {@link loadedItems} event. */ onLoadedItems(e?: EventArgs): void; /** * Occurs when the current item is checked or unchecked by the user. * * This event is raised when the {@link checkedMemberPath} is set to * the name of a property to add check boxes to each item in the control. * * Use the {@link selectedItem} property to retrieve the item that was * checked or unchecked. */ readonly itemChecked: Event, EventArgs>; /** * Raises the {@link itemChecked} event. */ onItemChecked(e?: EventArgs): void; /** * Occurs when the value of the {@link checkedItems} property changes. */ readonly checkedItemsChanged: Event, EventArgs>; /** * Raises the {@link checkedItemsChanged} event. */ onCheckedItemsChanged(e?: EventArgs): void; /** * Occurs when an element representing a list item has been created. * * This event can be used to format list items for display. It is similar * in purpose to the {@link itemFormatter} property, but has the advantage * of allowing multiple independent handlers. * * The {@link FormatItemEventArgs} object passed as a parameter has * a **data** property that refers to the data item bound to the * item and an **index** property that provides the item index into * the current view. * * If the {@link showGroups} property is set to **true** and * the item represents a group header, then the **data** property * contains a reference to a {@link CollectionViewGroup} object * represents the group. This object contains the group's **name**, * **items**, and **groupDescription**. * Since group headers do not correspond to actual data items, * the **index** property in this case is set to **-1**. */ readonly formatItem: Event, selfModule.FormatItemEventArgs>; /** * Raises the {@link formatItem} event. * * @param e {@link FormatItemEventArgs} that contains the event data. */ onFormatItem(e: FormatItemEventArgs): void; /** * Refreshes the control. * * @param fullUpdate Whether to update the control layout as well as the content. */ refresh(fullUpdate?: boolean): void; _updateAriaLabel(): void; _updateCheckedList(arr: any[]): void; _getBoundingClientRect(e: HTMLElement): Rect; _updateItemAttributes(e: HTMLElement | null, selected: boolean): void; _getCheckedItems(): any[]; _arrayEquals(arr1: any[], arr2: any[]): boolean; _getChild(index: number): HTMLElement; _getElementIndex(index: number): number; private _setItemChecked; private _checkedItemsUpdate; private _isEqual; private _findArrayItem; private _cvCollectionChanged; private _cvCurrentChanged; protected _populateList(): void; _getCanvasContext(): CanvasRenderingContext2D; _getVirtual(): boolean; _getMaxSupportedCssHeight(): number; _updateViewRange(): boolean; _getSelectedElement(visible: boolean): HTMLElement | null; _handleResize(): void; _createItem(i: number, groupIndex?: number): string; _getAriaSelected(isSelected: boolean, isChecked: boolean | null): boolean; _createHeaderItem(group: CollectionViewGroup, groupIndex: number): string; private _click; private _keydown; private _handleKeyUp; private _getCheckboxState; private _setCheckboxState; private _getCheckbox; private _keypress; private _selectNext; private _selectPrev; private _findNextEnabled; private _findPrevEnabled; _selectFirst(): boolean; _selectLast(): boolean; _selectNextPage(): boolean; _selectPrevPage(): boolean; private _findNext; _initFromSelect(hostElement: HTMLElement): void; _setIsDisabled(value: boolean): void; _setTabOrder(value: number): void; _isMenuItem(): boolean; _updateTabIndex(): void; private _selectRange; /** * Disposes of the control and all its resources. * * Calling the {@link dispose} method is important in applications that create * and remove controls dynamically. Failing to dispose of the controls may * cause memory leaks. */ dispose(): void; } /** * Provides arguments for the {@link ListBox.formatItem} event. */ export declare class FormatItemEventArgs extends EventArgs { _index: number; _data: any; _item: HTMLElement; /** * Initializes a new instance of the {@link FormatItemEventArgs} class. * * @param index Index of the item being formatted in the source {@link ICollectionView}, or -1 if the item is a group header. * @param data Data item being formatted, or a {@link CollectionViewGroup} object if the item is a group header. * @param item Element that represents the list item to be formatted. */ constructor(index: number, data: any, item: HTMLElement); /** * Gets the index of the data item in the list. */ readonly index: number; /** * Gets the data item being formatted. */ readonly data: any; /** * Gets a reference to the element that represents the list item to be formatted. */ readonly item: HTMLElement; } /** * The {@link MultiSelectListBox} control contains a {@link ListBox} with * a "Select All" button and a "Filter" input. * * The "Select All" and "Filter" elements can be shown or hidden using * the {@link showSelectAllCheckbox} and {@link showFilterInput} properties. * * The {@link MultiSelectListBox} control is used as a drop-down by the * {@link MultiSelect} control. */ export declare class MultiSelectListBox extends Control { _selectAll: HTMLElement; _filter: HTMLInputElement; _lbHost: HTMLElement; _lbx: ListBox; _cbSelectAll: HTMLInputElement; _spSelectAll: HTMLSpanElement; _ariaLabel: string; _selectAllLabel: string; _filterPlaceholder: string; _filterText: string; _checkOnFilter: boolean; _delay: number; _toSearch: any; static _DEF_CHECKED_PATH: string; static _ctrlTemplate: string; /** * Gets or sets the template used to instantiate {@link MultiSelectListBox} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link MultiSelectListBox} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the array or {@link ICollectionView} object that contains * the list items. */ itemsSource: any; /** * Gets the {@link ICollectionView} object used as the item source. */ readonly collectionView: ICollectionView; /** * Gets or sets the minimum number of rows and/or columns required to enable * virtualization in the drop-down {@link ListBox}. * * The default value for this property is a very big number, meaning virtualization is * disabled. To enable virtualization, set its value to 0 or a positive number. * * For more detals, please see the {@link ListBox.virtualizationThreshold} * property. */ virtualizationThreshold: number; /** * Gets or sets the name of the property to use as the visual * representation of the items. */ displayMemberPath: string; /** * Gets or sets a value indicating whether items contain plain * text or HTML. * * The default value for this property is **false**. */ isContentHtml: boolean; /** * Gets or sets a value that determines whether searches performed * while the user types should case-sensitive. * * The default value for this property is **false**. */ caseSensitiveSearch: boolean; /** * Gets or sets the delay, in milliseconds, between when a keystroke occurs * and when the search is performed to update the filter. * * This property is relevant only when the {@link showFilterInput} * property is set to **true**. * * The default value for this property is **500** milliseconds. */ delay: number; /** * Gets or sets a value that determines whether the {@link MultiSelectListBox} should * include group header items to delimit data groups. * * Data groups are created by modifying the {@link ICollectionView.groupDescriptions} * property of the {@link ICollectionView} object used as an {@link itemsSource}. * * The {@link MultiSelectListBox} only shows the first level of grouping. * * The default value for this property is **false**. */ showGroups: boolean; /** * Gets or sets a value that determines whether the {@link MultiSelectListBox} * should automatically check all filtered items when the filter text changes. * * The default value for this property is **true**, which causes the control * to behave like Excel and check all visible items when the filter is applied. * * For example, in a control with three items "Alice", "Bob", and "Mary", * typing "a" into the filter would cause the control to show items "Alice" * and "Mary", and both would be checked. * * Setting this property to **false** prevents the control from automatically * checking filtered items, and to keep checked items visible regardless of the * filter value. * * For example, in a control with three items "Alice", "Bob", and "Mary", * typing "a" into the filter would cause the control to show items "Alice" * and "Mary", but neither would be checked. * If the user then checked "Mary", and typed "b" into the filter, the list * would show items "Mary" (still checked) and "Bob" (unchecked). */ checkOnFilter: boolean; /** * Gets or sets the index of the currently selected item. */ selectedIndex: number; /** * Gets a reference to the {@link ListBox} control hosted by this * {@link MultiSelectListBox}. */ readonly listBox: ListBox; /** * Gets or sets whether the control should display a "filter" input * above the items to filter the items displayed. * * The default value for this property is **false**. */ showFilterInput: boolean; /** * Gets or sets the string used as a placeholder for the filter input element. * * The default value for this property is **null**, which causes the control * to show a localized version of the string "Filter". */ filterInputPlaceholder: string; /** * Gets or sets whether the control should display a "Select All" checkbox * above the items to select or de-select all items. * * The default value for this property is **false**. */ showSelectAllCheckbox: boolean; /** * Gets or sets the string to be used as a label for the "Select All" * checkbox that is displayed when the {@link showSelectAllCheckbox} * property is set to true. * * The default value for this property is **null**, which causes the control * to show a localized version of the string "Select All". */ selectAllLabel: string; /** * Gets or sets the name of the property used to control the checkboxes * placed next to each item. */ checkedMemberPath: string; /** * Gets or sets an array containing the items that are currently checked. */ checkedItems: any[]; /** * Gets or sets the aria-labelledby attribute of {@link MultiSelectListBox} input element. */ ariaLabelledBy: string; _updateAriaLabel(): void; /** * Occurs when the value of the {@link checkedItems} property changes. */ readonly checkedItemsChanged: Event, EventArgs>; /** * Raises the {@link checkedItemsChanged} event. */ onCheckedItemsChanged(e?: any): void; /** * Occurs when the value of the {@link selectedIndex} property changes. */ readonly selectedIndexChanged: Event, EventArgs>; /** * Raises the {@link selectedIndexChanged} event. */ onSelectedIndexChanged(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; dispose(): void; _applyFilter(): void; _updateCheckAllCheckbox(): void; _setIsDisabled(value: boolean): void; _setTabOrder(value: number): void; tryForceClearDelayAndFilter(): void; onLostFocus(): void; } export interface _IDateRange { from: Date | null; to: Date | null; } /** * Specifies constants that define the date selection behavior. */ export declare enum DateSelectionMode { /** The user cannot change the current value using the mouse or keyboard. */ None = 0, /** The user can select days. */ Day = 1, /** The user can select months. */ Month = 2, /** * The user can select ranges. * * Ranges are defined by the {@link value} and {@link rangeEnd}) * properties. * * To select a date range with the mouse, the user should click * the starting date ({@link value} property) and then the * ending date ({@link rangeEnd} property. * * To select a date range with the keyobard, the user should * use the cursor keys to select the starting date, then press * the shift key and extend the selection to select the ending * date. */ Range = 3 } /** * Specifies constants that define whether the control should * display month navigation elements. * * The month navigation elements include a drop-down button to * switch between month and year views * (see the {@link monthView} property) * and buttons to navigate to the previous and next months * (see the {@link displayMonth} property). * * The month navigation elements can be displayed on one or more of * the {@link monthCount} in the control. */ export declare enum ShowMonthPicker { /** No month navigation. */ None = 0, /** Show month navigation elements on the first month. */ FirstMonth = 1, /** Show month navigation elements on the last month. */ LastMonth = 2, /** Show month navigation elements on the first and last months. */ FirstAndLastMonths = 3, /** Show month navigation elements on all months. */ AllMonths = 4, /** Show month navigation buttons next to the edges of the calendar. */ Outside = 5 } /** * Represents a method that formats a date on the {@link Calendar} * control. * * The method typically adds class names to the element to modify * its appearance. */ export interface IDateFormatter { /** * @param date The date value to be formatted. * @param element The HTMLElement that represents the date value. */ (date: Date, element: HTMLElement): void; } /** * Represents a method that takes a date value as a parameter and * returns a boolean value that indicates the date is valid and * should be selectable by the user. */ export interface IDateValidator { /** * @param date The date value to be formatted. * @returns True if the date is valid and should be selectable by the user. */ (date: Date): boolean; } /** * Specifies constants that define the action to be performed when the TAB key is pressed. */ export declare enum CalendarTabKeyAction { /** No special action (let the browser handle the key). */ None = 0, /** All buttons in the calendar can be selected using the tab key. */ All = 1 } /** * The {@link Calendar} control displays a table with one or more months * and allows users to view and select dates. * * You may use the {@link min} and {@link max} properties to restrict * the range of dates that the user can select. * * For details about using the {@link min} and {@link max} properties, * please see the * Using the min and max properties topic. * * Use the {@link value} property to get or set the currently selected date. * * Use the {@link selectionMode} property to determine whether users should * be allowed to select days, ranges, months, or no values at all. * * The {@link Calendar} control supports the following keyboard commands: * * * * * * * * * * * * * * * * * * *
Key CombinationMoves Selection To
LeftPrevious day
RightNext day
UpPrevious week
DownNext week
PgUpPrevious month
PgDnNext month
Alt+PgUpPrevious year
Alt+PgDnNext year
HomeFirst valid day of the month
EndLast valid day of the month
Alt+EndToday's date
* * The example below shows a {@link Calendar} control that allows * users to select the date with a single click. * * {@sample Input/Calendar/Overview/purejs Example} */ export declare class Calendar extends Control { private _tbHdr; private _tbMth; private _tbYr; private _btnMth; private _spMth; private _btnPrv; private _btnTdy; private _btnNxt; private _confirmationButtonContainer; private _btnOK; private _btnCancel; private _lbYears; private _rptUp; private _rptDn; private _yrPicker; private _mtPicker; private _wksBefore; private _wksAfter; private _rngMin; private _rngMax; private _value; private _rngEnd; private _month; private _min; private _max; private _readOnly; private _handleWheel; private _fdw; private _selMode; private _itemFormatter; private _itemValidator; private _showYearListBoxButton; private _focusMode; private _focusValue; private _keyActionTab; private _ariaLabel; private _showConfirmationButtons; private _isSpaceDownForSetValue; private _tmYrHidden; private _syncing; private _cals; _clearingRangeEnd: boolean; private _fmtYrMo; private _fmtYr; private _fmtDayHdr; private _fmtDay; private _fmtMonths; private _fmtDayTitle; static _DATE_KEY: string; static _ctrlTemplate: string; /** * Gets or sets the template used to instantiate {@link Calendar} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link Calendar} class. * * @param element The DOM element that hosts the control, or a selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the currently selected date. * * The default value for this property is the current date. * * When editing ranges, the current range is defined by the interval between * the {@link value} and {@link rangeEnd} properties. * * Setting the {@link value} property automatically resets the {@link rangeEnd} * property to null, so the user can click the range end value on the calendar * to finish a range selection. * * Because setting the {@link value} property resets {@link rangeEnd}, to define * a range in code you must set the {@link value} first, and then {@link rangeEnd}. * For example: * * ```typescript * // this selects a range from 'start' to 'end': * cal.value = start; // rangeEnd == null * cal.rangeEnd = end; // rangeEnd == 'end' * * // **this doesn't work** * cal.rangeEnd = end; // rangeEnd == 'end' * cal.value = start; // rangeEnd == null */ value: Date; focusValue: Date; /** * Gets or sets the last selected date in a range selection. * * To enable date range selection, set the {@link selectionMode} property * to **DateSelectionMode.Range**. * * Once you do that, the selection range will be defined by the {@link value} * and {@link rangeEnd} properties. * * If not null, the {@link rangeEnd} date must be greater than or equal to * the {@link value} date, which represents the range start. */ rangeEnd: Date; /** * Gets or sets the minimum number of days allowed when editing date ranges. * * This property is used only when the {@link selectionMode} property * is set to {@link DateSelectionMode.Range}. * * The default value for this property is **0**, which means there is * no minimum value for range lengths. */ rangeMin: number; /** * Gets or sets the maximum length allowed when editing date ranges. * * This property is used only when the {@link selectionMode} property * is set to {@link DateSelectionMode.Range}. * * The default value for this property is **0**, which means there * is no maximum value for range lengths. */ rangeMax: number; /** * Gets or sets the earliest date that the user can select in the calendar. * * The default value for this property is **null**, which means no earliest * date is defined. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ min: Date | null; /** * Gets or sets the latest date that the user can select in the calendar. * * The default value for this property is **null**, which means no latest * date is defined. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ max: Date | null; /** * Gets or sets a value that determines whether users should be * able to select days, day ranges, months, or no values at all. * * The default value for this property is **DateSelectionMode.Day**. */ selectionMode: DateSelectionMode; /** * Gets or sets a value that determines whether users can modify * the control value using the mouse and keyboard. * * The default value for this property is **false**. */ isReadOnly: boolean; /** * Gets or sets a value that determines whether the user can change * the current {@link displayMonth} using the mouse wheel. * * The default value for this property is **true**. */ handleWheel: boolean; /** * Gets or sets a value that determines whether the calendar buttons * should act as repeat buttons, firing repeatedly as the button * remains pressed. * * The default value for this property is **true**. */ repeatButtons: boolean; /** * Gets or sets a value that determines whether the calendar should * display a list of years when the user clicks the header element * on the year calendar. * * The default value for this property is **true**. */ showYearPicker: boolean; /** * Gets or sets a value that determines whether the calendar should * display a list of months when the user clicks the header element * on the month calendar, and buttons for navigating to the next * or previous months. * * The default value for this property is **ShowMonthPicker.FirstMonth**. */ showMonthPicker: boolean | ShowMonthPicker; /** * Gets or sets a value that represents the first day of the week, * the one displayed in the first column of the calendar. * * The default value for this property is **null**, which causes * the calendar to use the default for the current culture. * * In the English culture, the first day of the week is Sunday (0); * in most European cultures, the first day of the week is Monday (1). */ firstDayOfWeek: number | null; /** * Gets or sets the month displayed in the calendar. */ displayMonth: Date; /** * Gets or sets the number of months to display within the calendar. * * The default value for this property is **1**. * * When you set this property to a value greater than 1, extra child * calendars are added to the control displaying consecutive months. * * All calendars within the control are synchronized, so changing * any property on the main calendar automatically updates all * child calendars. This includes the {@link value}, {@link rangeEnd}, * and {@link selectionMode} properties. * * When multiple months are shown, the main control's host element * gets a "wj-calendar-multimonth" class which is used in CSS to * switch the display to "flex". * * The "flex" container is very versatile. You can limit the width * of the outer control and have the months wrap horizontally or * vertically, align the months within the main control, align and * justify them, etc. */ monthCount: number; /** * Gets or sets the format used to display the month and year * above the calendar in month view. * * The default value for this property is **'y'**. */ formatYearMonth: string; /** * Gets or sets the format used to display the headers * above the days in month view. * * The default value for this property is **'ddd'**. */ formatDayHeaders: string; /** * Gets or sets the format used to display the days * in month view. * * The default value for this property is 'd ' (the space after the 'd' * prevents the format from being interpreted as 'd', the standard format * used to represent the short date pattern). */ formatDays: string; /** * Gets or sets the format used to display the year * above the months in year view. * * The default value for this property is **'yyyy'**. */ formatYear: string; /** * Gets or sets the format used to display the months * in year view. * * The default value for this property is **'MMM'**. */ formatMonths: string; /** * Gets or sets a value that determines whether the control should * display a header area with the current month and navigation buttons. * * The default value for this property is **true**. */ showHeader: boolean; /** * Gets or sets a value that determines whether the calendar should * display a month view (one day per cell) or a year view (one month per cell). * * The default value for this property is **true**. */ monthView: boolean; /** * Gets or sets the number of weeks to show on the calendar * before the current month. * * The default value for this property is **zero**. */ weeksBefore: number; /** * Gets or sets the number of weeks to show on the calendar * after the current month. * * The default value for this property is **zero**. */ weeksAfter: number; /** * Gets or sets a formatter function to customize dates in the calendar. * * The formatter function can add any content to any date. It allows * complete customization of the appearance and behavior of the calendar. * * If specified, the function takes two parameters: *
    *
  • the date being formatted
    • *
  • the HTML element that represents the date
    • *
* * For example, the code below shows weekends with a yellow background: * ```typescript * calendar.itemFormatter = (date, element) => { * let day = date.getDay(); * element.style.backgroundColor = (day == 0 || day == 6) ? 'yellow' : ''; * } * ``` */ itemFormatter: IDateFormatter | null; /** * Gets or sets a validator function to determine whether dates are valid for selection. * * If specified, the validator function should take one parameter representing the * date to be tested, and should return false if the date is invalid and should not * be selectable. * * For example, the code below shows weekends in a disabled state and prevents users * from selecting those dates: * ```typescript * calendar.itemValidator = date => { * let weekday = date.getDay(); * return weekday != 0 && weekday != 6; * } * ``` */ itemValidator: IDateValidator | null; /** * Gets the date at a given mouse position or represented * by a given HTML element. * * @param e Element to test. * @returns The date represented by the element, or null if the * element does not represent a date. */ hitTest(e: MouseEvent | Element): Date; /** * Adjusts the {@see displayMonth} value as needed to ensure * a given date is visible on the calendar. * * @param date Date to display. */ ensureVisible(date: Date): void; /** * Occurs when the value of the {@link value} property changes. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; /** * Occurs when the value of the {@link rangeEnd} property changes. */ readonly rangeEndChanged: Event; /** * Raises the {@link rangeEndChanged} event. */ onRangeEndChanged(e?: EventArgs): void; /** * Occurs when the value of the {@link rangeEnd} property changes * into a non-null value, indicating a data range has been selected. */ readonly rangeChanged: Event; /** * Raises the {@link rangeChanged} event. */ onRangeChanged(e?: EventArgs): void; /** * Occurs after the {@link displayMonth} property changes. */ readonly displayMonthChanged: Event; /** * Raises the {@link displayMonthChanged} event. */ onDisplayMonthChanged(e?: EventArgs): void; /** * Occurs when an element representing a day in the calendar has been created. * * This event can be used to format calendar items for display. It is similar * in purpose to the {@link itemFormatter} property, but has the advantage * of allowing multiple independent handlers. * * For example, the code below uses the {@link formatItem} event to disable weekends * so they appear dimmed in the calendar: * ```typescript * // disable Sundays and Saturdays * calendar.formatItem.addHandler((s, e) => { * let day = e.data.getDay(); * if (day == 0 || day == 6) { * addClass(e.item, 'wj-state-disabled'); * } * }); * ``` */ readonly formatItem: Event; /** * Raises the {@link formatItem} event. * * @param e {@link FormatItemEventArgs} that contains the event data. */ onFormatItem(e: FormatItemEventArgs): void; _containsFocusImpl(activeElement: HTMLElement): boolean; dispose(): void; refresh(fullUpdate?: boolean): void; private _getShowMonthPicker; private _getDisplayMonthRange; private _getCalendar; private _getCalendars; private _syncProp; private _updateContent; private _updateSelection; private _updateFocusInAccessibilityMode; private _updateCellFocus; private _addWeek; private _customizeCell; private _canChangeValue; private _valid; private _inValidRange; private _monthInValidRange; private _sameMonth; private _getValidDate; _clamp(value: Date): Date; private _createChildren; private _createYearPicker; private _createElement; private _click; private _keydown; private _getMonth; _mthMode(): boolean; _rngMode(): boolean; private _navigate; _setTabOrder(value: number): void; private _showYearPickerAction; /** * Gets or sets the focusMode enabled to support wcag related functions of {@link Calendar} element. */ focusMode: boolean; /** * Gets or sets the action to perform when the Tab key is pressed. * * The default setting for this property is {@link CalendarTabKeyAction.None}, * This means that pressing the tab key will have no effect and follow the browser's default behavior. */ keyActionTab: CalendarTabKeyAction; private _isButtonFocused; private _isSameMonth; private _dateViewContainsFocus; private _updateMonthButtonAria; private _isDayValid; readonly cancelButtonClicked: Event; cancelButtonClick(e?: EventArgs): void; oneCancelButtonClick(e: any): void; readonly OKButtonClicked: Event; OKButtonClick(e?: EventArgs): void; onOkButtonClick(e: any): void; /** * Gets or sets the aria-label attribute of {@link Calendar} element. */ ariaLabel: string; private _updateButtonTabIndex; readonly _enterKeyDownToSetValue: Event; _onEnterKeyDownToSetValue(e?: EventArgs): void; showConfirmationButtons: boolean; protected _setIsDisabled(value: boolean): void; private updateCalendarsTabindex; private setFocusModeValue; private _getCalendarsHostElements; updateConfirmationButtons(hostElement: HTMLElement): void; setFocusValueToFirstOrLastCalendar(isFirst: boolean): void; isCalendarDateCell(element: HTMLElement): boolean; isThisMainCalendar(): boolean; } export declare function softTouch(): any; export declare function getDragDropTouch(): any; /** * Specifies constants that define the action to perform when the * user clicks the input element in the control. */ export declare enum ClickAction { /** Selects the input element content. */ Select = 0, /** Open the drop-down. */ Open = 1, /** Toggle the drop-down. */ Toggle = 2 } /** * Defines the behavior when keys are pressed in the control. */ export declare enum KeyAction { /** Changes the selection without opening the dropdown. */ ChangeSelectionOnly = 0, /** Opens the dropdown without changing selection. */ OpenDropdown = 1 } /** * Defines the behavior when the TAB key is pressed in the control. */ export declare enum TabKeyAction { /** Closes the dropdown while maintaining focus on the control */ CloseAndKeepFocus = 0, /** Closes the dropdown and moves focus to the next tabbable element. */ CloseAndMoveFocus = 1 } /** * DropDown control (abstract). * * Contains an input element and a button used to show or hide the drop-down. * * Derived classes must override the _createDropDown method to create whatever * editor they want to show in the drop down area (a list of items, a calendar, * a color editor, etc). */ export declare class DropDown extends Control { _tbx: HTMLInputElement; _elRef: HTMLElement; _btn: HTMLElement; _dropDown: HTMLElement; _clickAction: selfModule.ClickAction; _showBtn: boolean; _autoExpand: boolean; _animate: boolean; _cssClass: string; _internalSettingText: boolean; _oldText: string; _minWidthDropdown: string; _escapeIE: boolean; _isInvalidInputCancelled: boolean; _keyActionDownArrow: selfModule.KeyAction; _keyActionUpArrow: selfModule.KeyAction; _keyActionTab: selfModule.TabKeyAction; static _ctrlTemplate: string; _touchMove: boolean; /** * Gets or sets the template used to instantiate {@link DropDown} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link DropDown} class. * * @param element The DOM element that hosts the control, or a selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); _isTouchMoved(): boolean; /** * Gets or sets the text shown on the control. */ text: string | null; /** * Gets the HTML input element hosted by the control. * * Use this property in situations where you want to customize the * attributes of the input element. */ readonly inputElement: HTMLInputElement; /** * Gets or sets the "type" attribute of the HTML input element hosted * by the control. * * The default value for this property is **'text'**. */ inputType: string; /** * Gets or sets a value that indicates whether the user can modify * the control value using the mouse and keyboard. * * The default value for this property is **false**. */ isReadOnly: boolean; /** * Gets or sets a value that determines whether the control value must be * set to a non-null value or whether it can be set to null * (by deleting the content of the control). * * This property defaults to true for most controls, including {@link ComboBox}, * {@link InputDate}, {@link InputTime}, {@link InputDateTime}, and {@link InputColor}. * It defaults to false for the {@link AutoComplete} control. */ isRequired: boolean; /** * Gets or sets the string shown as a hint when the control is empty. */ placeholder: string; /** * Gets or sets a value that specifies the action to perform when the * user clicks the input element in the control. * * For most drop-down controls, this property is set to {@link ClickAction.Select} * by default. This setting allows users to select portions of the text with the mouse. * * For drop-down controls that display non-editable text (such as the {@link MultiSelect}), * this property is set to {@link ClickAction.Toggle} by default. */ clickAction: ClickAction; protected _isDropdownOpened: boolean; /** * Gets or sets a value that indicates whether the drop down is currently * visible. * * The default value for this property is **false**. */ isDroppedDown: boolean; _toggleDropDown(isDroppedDown: boolean): void; /** * Gets the drop down element shown when the {@link isDroppedDown} * property is set to true. */ readonly dropDown: HTMLElement; /** * Gets or sets a CSS class name to add to the control's drop-down element. * * This property is useful when styling the drop-down element, because it is * shown as a child of the document body rather than as a child of the control * itself, which prevents using CSS selectors based on the parent control. */ dropDownCssClass: string; /** * Gets or sets a value that indicates whether the control should * display a drop-down button. * * The default value for this property is **true**. */ showDropDownButton: boolean; /** * Gets or sets a value that indicates whether the control should * automatically expand the selection to whole words/numbers when * the control is clicked. * * The default value for this property is **true**. */ autoExpandSelection: boolean; /** * Gets or sets a value that indicates whether the control should use a fade-in animation * when displaying the drop-down. * * The default value for this property is **false**. */ isAnimated: boolean; /** * Gets or sets the action to perform when the DOWN ARROW key is pressed. * * The default setting for this property is {@link KeyAction.ChangeSelectionOnly}, * which causes the control to change the selection item while keeping the listbox closed. * * Alternatively, you can set this to {@link KeyAction.OpenDropdown} to open the listbox * without changing the current selection. */ keyActionDownArrow: KeyAction; /** * Gets or sets the action to perform when the UP ARROW key is pressed. * * The default setting for this property is {@link KeyAction.ChangeSelectionOnly}, * which causes the control to change the selection item while keeping the listbox closed. * * Alternatively, you can set this to {@link KeyAction.OpenDropdown} to open the listbox * without changing the current selection. */ keyActionUpArrow: KeyAction; /** * Gets or sets the action to perform when the TAB key is pressed. * * The default setting for this property is {@link TabKeyAction.CloseAndMoveFocus}, * which provides standard form navigation behavior by: * - Closing the dropdown (if open) * - Moving focus to the next focusable element * * For specialized cases, you can set this to {@link TabKeyAction.CloseAndKeepFocus} * to maintain focus on the control after closing the dropdown. * * This setting is particularly useful for controlling accessibility behavior * and keyboard navigation flow in form controls. * * Example: * ```typescript * // Change TAB key behavior * dropDown.keyActionTab = TabKeyAction.CloseAndMoveFocus; * ``` */ keyActionTab: TabKeyAction; /** * Sets the focus to the control and selects all its content. */ selectAll(): void; /** * Occurs when the value of the {@link text} property changes. */ readonly textChanged: Event; /** * Raises the {@link textChanged} event. */ onTextChanged(e?: EventArgs): void; /** * Occurs before the drop down is shown or hidden. */ readonly isDroppedDownChanging: Event; /** * Raises the {@link isDroppedDownChanging} event. */ onIsDroppedDownChanging(e: CancelEventArgs): boolean; /** * Occurs after the drop down is shown or hidden. */ readonly isDroppedDownChanged: Event; /** * Raises the {@link isDroppedDownChanged} event. */ onIsDroppedDownChanged(e?: EventArgs): void; onGotFocus(e?: EventArgs): void; onLostFocus(e?: EventArgs): void; _containsFocusImpl(activeElement: HTMLElement): boolean; dispose(): void; refresh(fullUpdate?: boolean): void; _handleResize(): void; protected _dropDownClick(e: MouseEvent): void; protected _expandSelection(): void; protected _getCharType(text: string, pos: number): 0 | 1 | -1; protected _keydown(e: KeyboardEvent): void; private toggleDropDown; private handleUpArrowKey; private handleDownArrowKey; _afterOpenDropdownByDownArrow(): void; private openDropDown; private isHostVisible; protected _isHiddenEditor(): boolean; protected _keypress(e: KeyboardEvent): void; protected _input(e: Event): void; protected _btnclick(e: MouseEvent): void; protected _setText(text: string, fullMatch: boolean, forceRevertInvalid?: boolean, clearTbxVal?: boolean): void; protected _updateBtn(): void; _updateBtnAria(): void; protected _updateTbx(): void; _updateTbxAria(): void; _updateTbxAriaHaspopup(): void; protected _createDropDown(): void; protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void; _updateDropDown(): void; _shouldRaiseInvalidInput(shouldInvalid: boolean): boolean; } /** * Specifies actions that trigger showing and hiding {@link Popup} controls. * * The {@link PopupTrigger} actions are flags that may be combined using binary * operators. For example: * * ```typescript * let popup = new Popup('#popup', { * * // set popup owner to 'show' button * owner: '#btn-show' * * // show the popup when clicking the button * showTrigger: PopupTrigger.ClickOwner, * * // hide the popup when clicking the button or when the mouse leaves the popup * hideTrigger: PopupTrigger.ClickOwner | PopupTrigger.LeavePopup, * }); * ``` */ export declare enum PopupTrigger { /** No triggers; popups must be shown and hidden using code. */ None = 0, /** When the user clicks the owner element. */ ClickOwner = 1, /** When the user clicks the popup. */ ClickPopup = 2, /** When the user clicks the owner element or the popup. */ Click = 3, /** When the owner element loses focus. */ BlurOwner = 4, /** When the popup loses focus. */ BlurPopup = 8, /** When the owner element or the popup lose focus. */ Blur = 12, /** When the owner element or the popup are clicked or lose focus. */ ClickOrBlur = 15, /** When the mouse button is pressed over the owner element. */ DownOwner = 16, /** When the mouse button is pressed over the popup. */ DownPopup = 32, /** When the mouse button is pressed over the owner element or the popup. */ Down = 48, /** When the mouse enters the owner element. */ EnterOwner = 64, /** When the mouse enters the popup. */ EnterPopup = 128, /** When the mouse enters the owner element or the popup. */ Enter = 192, /** When the mouse leaves the owner element. */ LeaveOwner = 256, /** When the mouse leaves the popup. */ LeavePopup = 512, /** When the mouse leaves the owner element or the popup. */ Leave = 768 } declare enum _Edges { None = 0, Left = 1, Top = 2, Right = 4, Bottom = 8, LeftTop = 3, RightTop = 6, RightBottom = 12, LeftBottom = 9 } /** * Class that shows an element as a popup. * * Popups may be have {@link owner} elements, in which case they behave * as rich tooltips that may be shown or hidden based on actions * specified by the {@link Popup.showTrigger} and {@link Popup.hideTrigger} * properties. * * Popups with no owner elements behave like dialogs. They are centered * on the screen and displayed using the {@link show} method. * * To close a {@link Popup}, call the {@link Popup.hide} method. * * Alternatively, any clickable elements within a {@link Popup} that have * the classes starting with the 'wj-hide' string will hide the {@link Popup} * when clicked and will set the {@link Popup.dialogResult} property to the * class name so the caller may take appropriate action. * * For example, the {@link Popup} below will be hidden when the user presses * the OK or Cancel buttons, and the {@link Popup.dialogResult} property will * be set to either 'wj-hide-cancel' or 'wj-hide-ok': * * ```html * *
*
* Welcome to the popup. *
*
* Click one of the buttons below to close the popup. *
*
* * *
*
* ``` * ```typescript * new Popup('#thePopup', { * owner: '#btn-show-popup', * hidden: s => console.log('popup closed with result', s.dialogResult) * }); * ``` * * The example below shows how you can use the {@link Popup} control to implement * popups attached to owner elements and dialogs: * * {@sample Input/Popup/PopupsWithOwnerElements/purejs} */ export declare class Popup extends Control { static _DRAG_THRESHOLD: number; static _SZ_EDGE: number; static _SZ_MIN: number; static _PopupInstanceCount: number; static _evtHover: MouseEvent; protected _owner: HTMLElement; protected _ariaLabel: string; protected _modal: boolean; protected _position: PopupPosition; protected _showTrigger: selfModule.PopupTrigger; protected _hideTrigger: selfModule.PopupTrigger; protected _hideAnim: any[]; protected _fadeIn: boolean; protected _fadeOut: boolean; protected _removeOnHide: boolean; protected _draggable: boolean; protected _resizable: boolean; protected _dragged: boolean; protected _resized: boolean; protected _ignoreClick: boolean; protected _bkDrop: HTMLDivElement; protected _result: string; protected _resultEnter: string; protected _resultSubmit: string; protected _callback: Function; protected _refreshing: boolean; protected _visible: boolean; protected _wasVisible: boolean; protected _composing: boolean; protected _ownerClickBnd: any; protected _ownerDownBnd: any; protected _ownerBlurBnd: any; protected _ownerEnterBnd: any; protected _ownerLeaveBnd: any; protected _toShow: any; protected _toHideLeave: any; protected _toHideBlur: any; protected _edges: _Edges; protected _mousedownEvt: MouseEvent; protected _rcBounds: ClientRect; protected _mousedownBnd: any; protected _mousemoveBnd: any; protected _mousedragBnd: any; protected _mouseupBnd: any; protected _hideBnd: any; protected _oldFocus: HTMLElement; protected _myFocus: HTMLElement; protected _lastShow: number; protected _initialOwner: HTMLElement; protected _activeEdge: _Edges; private _toHidePopupTimer; private _toGetFocusTimer; private _hideTimer; /** * Initializes a new instance of the {@link Popup} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the aria-labelledby attribute of {@link Popup} input element. */ ariaLabelledBy: string; /** * Gets or sets the element that owns this {@link Popup}. * * If the {@link owner} is null, the {@link Popup} behaves like a dialog. * It is centered on the screen and must be shown using the * {@link show} method. */ owner: HTMLElement | null; /** * Gets or sets the {@link PopupPosition} where the popup should be * displayed with respect to the owner element. * * The default value for this property is **PopupPosition.BelowLeft**. */ position: PopupPosition; /** * Gets or sets the HTML element contained in this {@link Popup}. */ content: HTMLElement; /** * Gets or sets the actions that show the {@link Popup}. * * The default value for this property is **PopupTrigger.ClickOwner**, * which causes the popup to appear when the user clicks the owner element. * * If you set the {@link showTrigger} property to {@link PopupTrigger.None}, * the popup will be shown only when the {@link show} method is called. */ showTrigger: PopupTrigger; /** * Gets or sets the actions that hide the {@link Popup}. * * The default value for this property is **PopupTrigger.Blur**, * which causes the popup to hide when it loses focus. * * If you set the {@link hideTrigger} property to {@link PopupTrigger.Click}, * the popup will be hidden when the user clicks the popup or its owner element. * * If you set the {@link hideTrigger} property to {@link PopupTrigger.Leave}, the * popup will be hidden a short interval after the mouse leaves the popup or its * owner element, unless the user moves the mouse back into the popup before the * interval elapses. * * If you set the {@link hideTrigger} property to {@link PopupTrigger.None}, the * popup will be hidden only when the {@link hide} method is called * (or when the user presses the Escape key). */ hideTrigger: PopupTrigger; /** * Gets or sets a value that determines whether the {@link Popup} should * use a fade-in animation when it is shown. * * The default value for this property is **true**. */ fadeIn: boolean; /** * Gets or sets a value that determines whether the {@link Popup} should * use a fade-out animation when it is hidden. * * The default value for this property is **true**. */ fadeOut: boolean; /** * Gets or sets a value that determines whether the {@link Popup} host * element should be hidden and removed from the DOM when the {@link Popup} * is hidden, as opposed to simply being hidden. * * The default value for this property is **true**. * * Note that {@link removeOnHide} removes the {@link Popup} element from * the DOM when the {@link Popup} is hidden, but not when it is created. * * If the {@link Popup} contains elements with access keys (**accesskey** * attributes) that should not be activated when the {@link Popup} is not * visible, you should remove the {@link Popup} from the DOM after it is * created. For example: * ```typescript * import { Popup} from 'wijmo/wijmo.input'; * import { removeChild } from 'wijmo/wijmo'; * // create the Popup * let popup = new Popup('#popup', { * owner: '#show' * }); * * // add event listeners to accesskey elements (accesskey element is in the DOM) * document.getElementById('alert').addEventListener('click', e => alert('hi')); * * // remove Popup (and accesskey element) from DOM * // so accesskey will not work until the Popup is visible * removeChild(popup.hostElement); * ``` */ removeOnHide: boolean; /** * Gets or sets a value that determines whether the {@link Popup} should * be displayed as a modal dialog. * * Modal dialogs show a dark backdrop that makes the {@link Popup} stand * out from other content on the page. * * If you want to make a dialog truly modal, also set the {@link Popup.hideTrigger} * property to {@link PopupTrigger.None}, so users won't be able to click the * backdrop to dismiss the dialog. In this case, the dialog will close only * when the {@link hide} method is called (or when the user presses the Escape key). * * The default value for this property is **false**. */ modal: boolean; /** * Gets or sets a value that determines whether the popup can be dragged * with the mouse by its header. * * The header is identified by the '.wj-dialog-header' or '.modal-header' * CSS selectors. * If the dialog does not contain any elements with the 'wj-dialog-header' * or 'modal-header' classes, users will not be able to drag the popup. * * The default value for this property is **false**. */ isDraggable: boolean; /** * Gets or sets a value that determines whether the popup can be resized * by dragging its edges with the mouse. * * You can limit the size of the popup by setting the host element's * max-width, min-width, max-height, and min-height CSS properties. * * The default value for this property is **false**. */ isResizable: boolean; /** * Gets or sets a value used as a return value for the {@link Popup} after * it is hidden. * * This property is set to **null** when the {@link Popup} is displayed. * * It can be set in response to button click events or in the call to the * {@link hide} method to provide a result value to callers. */ dialogResult: any; /** * Gets or sets a value to be used as a {@link dialogResult} when the user presses * the Enter key while the {@link Popup} is visible. * * The default value for this property is **null**. * * If the user presses Enter and the {@link dialogResultEnter} property is not * **null**, the popup checks whether all its child elements are in a valid state. * If so, the popup is closed and the {@link dialogResult} property is set to * the value of the {@link dialogResultEnter} property. */ dialogResultEnter: any; /** * Gets or sets a string to be used as a {@link dialogResult} when the dialog * is hosted by a form element and the user submits the form. * * The default value for this property is **null**. * * If you set this property to a non-empty string, the control will handle * the form's submit event, validating the fields and closing the form with * a {@link dialogResult} set to the specified value. For example: * * ```typescript * let dlg = new Popup('#theForm', { * dialogResultSubmit: 'ok' * }); * dlg.show(true, () => { * if (dlg.dialogResult == dlg.dialogResultSubmit) { * // form is valid, handle results here * } * }); * ``` * * See also the {@link dialogResultEnter} property, which can be used * when the {@link Popup} is hosted in elements that are not forms. */ dialogResultSubmit: string; /** * Gets a value that determines whether the {@link Popup} is currently visible. */ readonly isVisible: boolean; /** * Shows the {@link Popup}. * * @param modal Whether to show the popup as a modal dialog. If provided, this * sets the value of the {@link modal} property. * @param handleResult Callback invoked when the popup is hidden. If provided, * this should be a function that receives the popup as a parameter. * * The **handleResult** callback allows callers to handle the result of modal * dialogs without attaching handlers to the {@link hidden} event. For example, * the code below shows a dialog used to edit the current item in a * {@link CollectionView}. The edits are committed or canceled depending on the * {@link Popup.dialogResult} value. For example: * * ```typescript * function editCurrentItem(popupEditor: Popup, view: CollectionView) { * view.editItem(view.currentItem); * popupEditor.show(true, (e: Popup) => { * if (e.dialogResult == 'wj-hide-ok') { * view.commitEdit(); * } else { * view.cancelEdit(); * } * }); * } * ``` */ show(modal?: boolean, handleResult?: Function): void; /** * Hides the {@link Popup}. * * @param dialogResult Optional value assigned to the {@link dialogResult} property * before closing the {@link Popup}. */ hide(dialogResult?: any): void; /** * Occurs before the {@link Popup} is shown. */ readonly showing: Event; /** * Raises the {@link showing} event. * * @param e {@link CancelEventArgs} that contains the event data. * @return True if the event was not canceled. */ onShowing(e: CancelEventArgs): boolean; /** * Occurs after the {@link Popup} has been shown. */ readonly shown: Event; /** * Raises the {@link shown} event. */ onShown(e?: EventArgs): void; /** * Occurs before the {@link Popup} is hidden. */ readonly hiding: Event; /** * Raises the {@link hiding} event. * * @param e {@link CancelEventArgs} that contains the event data. * @return True if the event was not canceled. */ onHiding(e: CancelEventArgs): boolean; /** * Occurs after the {@link Popup} has been hidden. */ readonly hidden: Event; /** * Raises the {@link hidden} event. */ onHidden(e?: EventArgs): void; /** * Occurs when the {@link Popup} is about to be resized. * * See also the {@link isResizable} property. */ readonly resizing: Event; /** * Raises the {@link resizing} event. * * @param e {@link CancelEventArgs} that contains the event data. * @return True if the event was not canceled. */ onResizing(e: CancelEventArgs): boolean; /** * Occurs after the {@link Popup} has been resized. * * See also the {@link isResizable} property. */ readonly resized: Event; /** * Raises the {@link resized} event. */ onResized(e?: EventArgs): void; /** * Occurs when the {@link Popup} is about to be dragged. * * See also the {@link isDraggable} property. */ readonly dragging: Event; /** * Raises the {@link dragging} event. * * @param e {@link CancelEventArgs} that contains the event data. * @return True if the event was not canceled. */ onDragging(e: CancelEventArgs): boolean; /** * Occurs after the {@link Popup} has been dragged. * * See also the {@link isDraggable} property. */ readonly dragged: Event; /** * Raises the {@link dragged} event. */ onDragged(e?: EventArgs): void; /** * Occurs while the user resizes the {@link Popup}, between the * {@link resizing} and {@link resized} events. * * When the user drags the {@link Popup}, it raises the following events: * - {@link resizing} (once, cancelable) * - {@link sizeChanging} (several times while the user moves the mouse, cancelable) * - {@link sizeChanged} (several times while the user moves the mouse) * - {@link resized} (once, at the end of the resizing process) * * See also the {@link isResizable} property. */ readonly sizeChanging: Event; /** * Raises the {@link sizeChanging} event. * * @param e {@link PopupBoundsChangingEventArgs} that contains the event data. * @return True if the event was not canceled. */ onSizeChanging(e: PopupBoundsChangingEventArgs): boolean; /** * Occurs while the user resizes the {@link Popup}, between the * {@link resizing} and {@link resized} events. * * When the user resizes the {@link Popup}, it raises the following events: * - {@link resizing} (once, cancelable) * - {@link sizeChanging} (several times while the user moves the mouse, cancelable) * - {@link sizeChanged} (several times while the user moves the mouse) * - {@link resized} (once, at the end of the resizing process) * * See also the {@link isResizable} property. */ readonly sizeChanged: Event; /** * * @param e Raises the {@link sizeChanged} event. */ onSizeChanged(e?: EventArgs): void; /** * Occurs while the user moves the {@link Popup}, between the * {@link dragging} and {@link dragged} events. * * When the user drags the {@link Popup}, it raises the following events: * - {@link dragging} (once, cancelable) * - {@link positionChanging} (several times while the user moves the mouse, cancelable) * - {@link positionChanged} (several times while the user moves the mouse) * - {@link dragged} (once, at the end of the resizing process) * * See also the {@link isDraggable} property. * * You can use the {@link positionChanging} event to cancel or to modify * the {@link Popup} bounds as the user drags the control. * * For example, the code keeps the popup in full view, preventing users * from dragging parts of the {@link Popup} off the screen: * * ```typescript * new Popup('#thePopup', { * isDraggable: true, * isResizable: true, * hideTrigger: 'None', * * // keep popup fully within the browser window * positionChanging: (s: Popup, e: PopupBoundsChangingEventArgs) => { * let bnd = e.bounds; * bnd.left = Math.max(Math.min(bnd.left, innerWidth + scrollX - bnd.width), scrollX); * bnd.top = Math.max(Math.min(bnd.top, innerHeight + scrollY - bnd.height), scrollY); * } * }); * ``` */ readonly positionChanging: Event; /** * Raises the {@link positionChanging} event. * * @param e {@link PopupBoundsChangingEventArgs} that contains the event data. * @return True if the event was not canceled. */ onPositionChanging(e: PopupBoundsChangingEventArgs): boolean; /** * Occurs while the user moves the {@link Popup}, between the * {@link dragging} and {@link dragged} events. * * When the user drags the {@link Popup}, it raises the following events: * - {@link dragging} (once, cancelable) * - {@link positionChanging} (several times while the user moves the mouse) * - {@link positionChanged} (several times while the user moves the mouse) * - {@link dragged} (once, at the end of the resizing process) * * See also the {@link isDraggable} property. */ readonly positionChanged: Event; /** * Raises the {@link positionChanged} event. */ onPositionChanged(e?: EventArgs): void; onLostFocus(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; _clearTimeouts(): void; protected _handleDragResize(on: boolean): void; protected _mousemove(e: MouseEvent): void; protected _mousedown(e: any): void; protected _mouseup(): void; protected _mousedrag(e: any): void; protected _getEdges(host: HTMLElement, e: MouseEvent): _Edges; protected _ownerClick(e: MouseEvent): void; protected _ownerDown(e: MouseEvent): void; protected _ownerBlur(e: UIEvent): void; protected _ownerEnter(e: MouseEvent): void; protected _ownerLeave(e: MouseEvent): void; protected _toggle(e: UIEvent, trigger: PopupTrigger): void; private _getHeaderElement; private _getClosestHeader; private _showBackdrop; protected _validateAndHide(result: any): void; protected _updateAriaLabel(): void; protected _updateAriaLabelImp(oldLabels: any): void; /** * Disposes of the control and all its resources. * * Calling the {@link dispose} method is important in applications that create * and remove controls dynamically. Failing to dispose of the controls may * cause memory leaks. */ dispose(): void; } /** * Provides arguments for the {@link Popup} control's {@link sizeChanging} and * {@link positionChanging} events. */ export declare class PopupBoundsChangingEventArgs extends CancelEventArgs { _rc: Rect; /** * Initializes a new instance of the {@link PopupBoundsChangingEventArgs} class. */ constructor(bounds: Rect); /** * Gets a {@link Rect} that represents the bounds of the {@link Popup} control. */ readonly bounds: Rect; } /** * Provides arguments for {@link InputDate}'s invalidInput event. */ export declare class InputDateEventArgs extends CancelEventArgs { _isUserInput: boolean; /** * Initializes a new instance of the {@link InputDateEventArgs} class. * * @param isUserInput boolean value to distinguish user input from value set in code */ constructor(isUserInput: boolean); /** * Gets a value that determines whether invalid value was * provided by user or set in code */ readonly isUserInput: boolean; } /** * The {@link InputDate} control allows users to type in dates using any format * supported by the {@link Globalize} class, or to pick dates from a drop-down * that contains a {@link Calendar} control. * * Use the {@link min} and {@link max} properties to restrict the range of * values that the user can enter. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties * topic. * * Use the {@link value} property to get or set the currently selected date. * * Use the {@link autoExpandSelection} property to determine whether the control * should automatically expand the selection to entire words, numbers, or dates * when the user clicks the input element. * * The example below shows how to edit a **Date** value using an {@link InputDate} * control. * * {@sample Input/InputDate/Overview/purejs Example} * * The {@link InputDate} and {@link Calendar} controls have built-in accessibility * support. They support keyboard commands and provide aria-label attributes for * all elements on the calendar. You can improve accessibility by adding your own * application-specific aria-label attributes to the main input element of your * {@link InputDate} controls. For example: * ```typescript * // create an InputDate control and add an aria-label for improved accessibility * let inputDate = new InputDate('#theInputDate'); * inputDate.inputElement.setAttribute('aria-label', 'enter trip start date in the format month/day/year') * ``` */ export declare class InputDate extends DropDown { private _lbx; private _cal; private _fmt; private _sep; private _msk; private _rngs; private _showCal; private _clsOnSel; private _handleWheel; private _preserveCalendarNavigation; private _isTriggered; private _rangeChanged; private _textInitialized; private _previousText; private _keepInvalidText; private _showConfirmationButtons; protected _inputAriaLabel: any; protected _currentInput: string; static _ctrlTemplate: string; _ariaLabelledby: string; /** * Gets or sets the template used to instantiate {@link InputDate} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputDate} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); protected _mouseWheel(e: WheelEvent): void; /** * Gets or sets the currently selected date. * * The default value for this property is the current date. */ value: Date | null; /** * Gets or sets the last selected date in a range selection. * * To enable date range selection, set the {@link selectionMode} * property to **DateSelectionMode.Range**. * * Once you do that, the selection range will be defined by * the {@link value} and {@link rangeEnd} properties. */ rangeEnd: Date; /** * Gets or sets the minimum number of days allowed when editing date ranges. * * This property is used only when the {@link selectionMode} property * is set to {@link DateSelectionMode.Range}. * * The default value for this property is **0**, which means * there is no minimum value for range lengths. */ rangeMin: number; /** * Gets or sets the maximum length allowed when editing date ranges. * * This property is used only when the {@link selectionMode} property * is set to {@link DateSelectionMode.Range}. * * The default value for this property is **0**, which means * there is no maximum value for range lengths. */ rangeMax: number; /** * Gets or sets whether to allow invalid text * * This property is used only when invalid text is set through * {@link text} property in code and does not affect the behavior * when invalid value is set by the end user * * The default value for this property is false. */ keepInvalidText: boolean; /** * Gets or sets the text shown on the control. */ text: string; /** * Gets or sets the format used to display the selected date. * * The format string is expressed as a .NET-style * * Date format string. * * The default value for this property is **'d'**, the culture-dependent * short date pattern (e.g. 6/15/2020 in the US, 15/6/2020 in France, or * 2020/6/15 in Japan). */ format: string; /** * Gets or sets a string used as a separator between the {@link value} and * {@link rangeEnd} values shown by the control. * * This property is used only when the {@link selectionMode} property is set to * {@link DateSelectionMode.Range}. * * The default value for this property is a **' - '**. */ separator: string; /** * Gets or sets a mask to use while editing. * * The mask format is the same one that the {@link wijmo.input.InputMask} * control uses. * * If specified, the mask must be compatible with the value of * the {@link format} and {@link separator} properties. * * For example, the mask '99/99/9999 - 99/99/9999' can be used for * entering date ranges formatted as 'MM/dd/yyyy' with a ' - ' * separator. */ mask: string; /** * Gets or sets a value that determines whether the control should * automatically close the drop-down when the user makes a selection. * * The default value for this property is **true**. */ closeOnSelection: boolean; /** * Gets or sets a value that determines whether the user can edit the * current value using the mouse wheel. * * The default value for this property is **true**. * * Setting this property to **false** also disables the custom wheel * handling for the control's drop-down {@link calendar}. */ handleWheel: boolean; /** * Gets or sets an object that defines predefined ranges. * * This property is useful only when the {@link selectionMode} * property is set to {@link DateSelectionMode.Range}. * * Each property in the object represents a predefined range, * identified by the property name and defined by an array with * two dates (range start and end). * * Properties with null values represent custom ranges to be defined * by users by clicking on the calendar. * * For example: * ```typescript * import { DateTime } from 'wijmo/wijmo'; * import { InputDate } from 'wijmo/wijmo.input'; * * new InputDate(host, { * selectionMode: 'Range', * predefinedRanges: getRanges() * }); * * function getRanges() { * let dt = DateTime, * now = new Date(); * return { * 'This Week': [dt.weekFirst(now), dt.weekLast(now)], * 'Last Week': [dt.weekFirst(dt.addDays(now, -7)), dt.weekLast(dt.addDays(now, -7))], * 'Next Week': [dt.weekFirst(dt.addDays(now, +7)), dt.weekLast(dt.addDays(now, +7))], * * 'This Month': [dt.monthFirst(now), dt.monthLast(now)], * 'Last Month': [dt.monthFirst(dt.addMonths(now, -1)), dt.monthLast(dt.addMonths(now, -1))], * 'Next Month': [dt.monthFirst(dt.addMonths(now, +1)), dt.monthLast(dt.addMonths(now, +1))], * 'Custom Range': null * }; * } * ``` */ predefinedRanges: any; /** * Gets or sets a value that determines whether the calendar * should remain visible in the dropdown even when there are * selected predefined ranges. * * The default value for this property is **false**, which * causes the control to hide the calendar if one of the * predefined ranges is selected. */ alwaysShowCalendar: boolean; /** * Gets or sets the earliest date that the user can enter. * * The default value for this property is **null**, which * means no earliest date is defined. * * For details about using the {@link min} and {@link max} * properties, please see the * Using the min and max properties topic. */ min: Date | null; /** * Gets or sets the latest date that the user can enter. * * The default value for this property is **null**, which means no latest * date is defined. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ max: Date | null; /** * Gets or sets a value that determines whether the calendar buttons * should act as repeat buttons, firing repeatedly as the button * remains pressed. * * The default value for this property is **true**. */ repeatButtons: boolean; /** * Gets or sets a value that determines whether the drop-down * calendar should display a list of years when the user clicks * the header element on the year calendar. * * The default value for this property is **true**. */ showYearPicker: boolean; /** * Gets or sets a value that determines whether the calendar should * display a list of months when the user clicks the header element * on the month calendar. * * The default value for this property is **ShowMonthPicker.First**. */ showMonthPicker: boolean | ShowMonthPicker; /** * Gets or sets a value that determines whether the calendar should * display an area with the current month and navigation buttons. * * The default value for this property is **true**. */ showHeader: boolean; /** * Gets or sets the number of weeks to show on the calendar * before the current month. * * The default value for this property is **zero**. */ weeksBefore: number; /** * Gets or sets the number of weeks to show on the calendar * after the current month. * * The default value for this property is **zero**. */ weeksAfter: number; /** * Gets or sets a value that determines whether users can select * days, ranges, months, or no values at all. * * This property affects the behavior of the drop-down calendar, * but not the format used to display dates. * If you set {@link selectionMode} to 'Month', you should normally * set the {@link format} property to 'MMM yyyy' or some format that * does not include the day. For example: * * ```typescript * import { InputDate } from 'wijmo/wijmo.input'; * var inputDate = new InputDate('#el, { * selectionMode: 'Month', * format: 'MMM yyyy' * }); * ``` * * The default value for this property is **DateSelectionMode.Day**. */ selectionMode: DateSelectionMode; /** * Gets or sets the number of months to display in the drop-down calendar. * * The default value for this property is **1**. * * For more details on this property, please see the {@link Calendar.monthCount} * property. * * When showing multiple months in the same calendar, months will be shown * using a wrapping flex-box container. You may use CSS to limit the number * of months shown per row in the drop-down. * * For example this code creates an {@link InputDate} control with a drop-down * that shows three months per row: * ```typescript * import { InputDate } from 'wijmo/wijmo.input'; * let idt = new InputDate(document.createElement('#theInputDate'), { * monthCount: 6, * dropDownCssClass: 'three-months-per-row' * }); * ``` * ``` * .three-months-per-row .wj-calendar-multimonth { * width: calc(3 * 21em); * } * ``` */ monthCount: number; /** * Gets a reference to the {@link Calendar} control shown in the drop-down box. */ readonly calendar: Calendar; /** * Gets the HTML input element hosted by the control. * * Use this property in situations where you want to customize the attributes * of the input element. * * For example, the code below uses the {@link inputElement} property to * improve accessibility by adding an aria-label attribute to the control's * input element: * ```typescript * // create an InputDate control and add an aria-label for improved accessibility * let inputDate = new InputDate('#theInputDate'); * inputDate.inputElement.setAttribute('aria-label', 'enter trip start date in the format month/day/year') * ``` */ readonly inputElement: HTMLInputElement; /** * Gets or sets the "type" attribute of the HTML input element hosted by the control. * * Use this property to change the default setting if the default does not work well * for the current culture, device, or application. In those cases, try changing * the value to "tel" or "text" */ inputType: string; /** * Gets or sets a value that determines whether to preserve the month * when user navigates to a different month than the selected date. * * The default value for this property is **true**. */ preserveCalendarNavigation: boolean; /** * Gets or sets a validator function to determine whether dates are valid for selection. * * If specified, the validator function should take one parameter representing the * date to be tested, and should return false if the date is invalid and should not * be selectable. * * For example, the code below prevents users from selecting dates that fall on * weekends: * * ```typescript * inputDate.itemValidator = date => { * const weekday = date.getDay(); * return weekday != 0 && weekday != 6; * } * ``` */ itemValidator: IDateValidator; /** * Gets or sets a formatter function to customize dates in the drop-down calendar. * * The formatter function can add any content to any date. It allows * complete customization of the appearance and behavior of the calendar. * * If specified, the function takes two parameters: *
    *
  • the date being formatted
    • *
  • the HTML element that represents the date
    • *
* * For example, the code below shows weekends with a yellow background: * * ```typescript * inputDate.itemFormatter = (date, element) => { * const day = date.getDay(); * element.style.backgroundColor = day == 0 || day == 6 ? 'yellow' : ''; * } * ``` */ itemFormatter: IDateFormatter; /** * Occurs when the value of the {@link value} property changes. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; /** * Occurs when the value of the {@link rangeEnd} property changes. */ readonly rangeEndChanged: Event; /** * Raises the {@link rangeEndChanged} event. */ onRangeEndChanged(e?: EventArgs): void; /** * Occurs when the value of the {@link rangeEnd} property changes * into a non-null value, indicating a data range has been selected. */ readonly rangeChanged: Event; /** * Raises the {@link rangeChanged} event. */ onRangeChanged(e?: EventArgs): void; protected _getParsedValue(): Date; refresh(fullUpdate?: boolean): void; onIsDroppedDownChanging(e: CancelEventArgs): boolean; onIsDroppedDownChanged(e?: EventArgs): void; _updateDropDown(): void; onGotFocus(e?: EventArgs): void; protected _keydown(e: KeyboardEvent): void; protected _expandSelection(): void; protected _updateDateTimeValue(step: number, specialChars: any, actualFormat: string): void; protected _reselectText(specialChars: string[], currentPos: number): void; _refreshText(): void; protected _selectAll(): void; _closeOnChange(): void; private _tryFocus; _clamp(value: Date): Date; protected _getText(): string; protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void; protected _triggerInvalidInputEvent(cancelEvtArgs: InputDateEventArgs, val: Date, rangeEnd?: Date, shouldInvalid?: boolean): void; protected _nullValueInvalidInput(cancelEvtArgs: InputDateEventArgs, shouldInvalid?: boolean): void; protected _fromDateTime(value: Date): Date; protected _canChangeValue(): boolean; protected _isValidDate(value: Date): boolean; private _getRanges; private _updateRangeSelection; protected _copy(key: string, value: any): boolean; /** * Gets or sets whether to display the confirmation buttons in Calendar. * When this property is set to true, using the arrow keys will only change the focus. * And "OK" and "Cancel" buttons will be displayed below the dropdown. */ showConfirmationButtons: boolean; /** * Gets or sets the aria-labelledby attribute of input element. */ ariaLabelledBy: string; protected _updateInputAriaLabel(): void; getAriaLabelForScreenReader(): any; } /** * The {@link InputDateRange} control extends the {@link InputDate} * control and sets * the {@link selectionMode} property to {@link DateSelectionMode.Range}, * the {@link monthCount} property to **2**, and * the {@link showMonthPicker} property to **ShowMonthPicker.Outside**. * * Use the {@link value} and {@link rangeEnd} properties to access * the currently selected date range. * * Use the {@link predefinedRanges} property to add pre-defined * ranges that users can select from. */ export declare class InputDateRange extends InputDate { static _ctrlTemplate: string; protected _inputAriaLabel: any; /** * Gets or sets the template used to instantiate {@link InputDateRange} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputDateRange} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); selectionMode: DateSelectionMode; protected _mouseWheel(e: WheelEvent): void; onGotFocus(e?: EventArgs): void; protected _keydown(e: KeyboardEvent): void; } /** * The {@link InputColor} control allows users to select colors by typing in * HTML-supported color strings, or to pick colors from a drop-down * that shows a {@link ColorPicker} control. * * Use the {@link value} property to get or set the currently selected color. * * {@sample Input/InputColor/Overview/purejs Example} */ export declare class InputColor extends DropDown { private _ePreview; private _colorPicker; private _value; private _textInitialized; _ariaLabelledby: string; protected _inputAriaLabel: string; static _ctrlTemplate: string; /** * Gets or sets the template used to instantiate {@link InputColor} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputColor} class. * * @param element The DOM element that hosts the control, or a selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the currently selected color. * * The default value for this property is **"#ffffff"** (white). * * Setting this property to a string that cannot be interpreted as * a color causes the assignment to be ignored. No exceptions are * thrown in this case. */ value: string; /** * Gets or sets the text shown on the control. */ text: string; /** * Gets or sets the "type" attribute of the HTML input element hosted * by the control. * * Use this property to change the default setting if the default does not work well * for the current culture, device, or application. In those cases, try changing * the value to "tel" or "text" */ inputType: string; /** * Gets or sets a value indicating whether the {@link ColorPicker} * allows users to edit the color's alpha channel (transparency). * * The default value for this property is **true**. */ showAlphaChannel: boolean; /** * Gets or sets a value indicating whether the {@link ColorPicker} * shows a string representation of the current color. * * The default value for this property is **false**. */ showColorString: boolean; /** * Gets or sets an array that contains the colors in the palette. * * The palette contains ten colors, represented by an array with * ten strings. The first two colors are usually white and black. */ palette: string[]; /** * Gets a reference to the {@link ColorPicker} control shown in the drop-down. */ readonly colorPicker: ColorPicker; /** * Gets or sets the aria-labelledby attribute of input color element. */ ariaLabelledBy: string; /** * Gets or sets the colorPicker's keyActionTab property. */ colorPickerKeyActionTab: ColorPickerTabKeyAction; /** * Occurs when the value of the {@link value} property changes, either * as a result of user actions or by assignment in code. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; onIsDroppedDownChanged(e?: EventArgs): void; protected _createDropDown(): void; protected _keydown(e: KeyboardEvent): void; protected _commitText(): void; protected _changeAllValue(): void; protected _copy(key: string, value: any): boolean; getAriaLabelForScreenReader(): any; protected _updateInputAriaLabel(): void; } /** * The {@link ComboBox} control allows users to pick strings from lists. * * The control automatically completes entries as the user types, and * allows users to show a drop-down list with the items available. * * Use the {@link ComboBox.itemsSource} property to populate the list of * options. * The items may be strings or objects. If the items are objects, use * the {@link ComboBox.displayMemberPath} to define which property of the * items will be displayed in the list and use the {@link ComboBox.selectedValuePath} * property to define which property of the items will be used to set the * combo's {@link ComboBox.selectedValue} property. * * Use the {@link ComboBox.selectedIndex} or the {@link ComboBox.text} properties * to determine which item is currently selected. * * The {@link ComboBox.isRequired} property determines whether the control * must have a non-null value or whether it can be set to null * (by deleting the content of the control). If the value is set to null, * the {@link ComboBox.selectedIndex} is set to -1. * * The {@link ComboBox.isEditable} property determines whether users can enter * values that are not present in the list. * * The example below creates a {@link ComboBox} control and populates it with * a list of countries. The {@link ComboBox} searches for the country as the * user types. * The {@link ComboBox.isEditable} property is set to false, so the user must * select one of the items in the list. * * {@sample Input/ComboBox/Overview/purejs Example} */ export declare class ComboBox extends DropDown { _lbx: ListBox; _editable: boolean; _trimText: boolean; _handleWheel: boolean; _delKey: number; _draggingText: boolean; _composing: boolean; _textIsComposing: string; _settingText: boolean; _pathHdr: Binding; _bsCollapse: boolean; _fmtItemHandlers: number; _emptyValueAction: boolean; _oldIndexToBeRestoredOnBlur: null | number; _restoreComboboxTbxVal: boolean; _isWheel: boolean; _selItems: any; _oldFilter: any; static _ctrlTemplate: string; _keyActionPrintCharacters: selfModule.KeyAction; _inputElementAriaLabel: string; _ariaLabelledby: string; /** * Gets or sets the template used to instantiate {@link ComboBox} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link ComboBox} class. * * @param element The DOM element that hosts the control, or a selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the array or {@link ICollectionView} object that contains * the items to select from. * * Setting this property to an array causes the {@link ComboBox} to create * an internal {@link ICollectionView} object that is exposed by the * {@link ComboBox.collectionView} property. * * The {@link ComboBox} selection is determined by the current item in its * {@link ComboBox.collectionView}. By default, this is the first item in * the collection. You may change this behavior by setting the * {@link wijmo.CollectionView.currentItem} property of the * {@link ComboBox.collectionView} to null. */ itemsSource: any; /** * Gets the {@link ICollectionView} object used as the item source. */ readonly collectionView: ICollectionView; /** * Gets or sets the minimum number of rows and/or columns required to enable * virtualization in the drop-down {@link ListBox}. * * The default value for this property is a very big number, meaning virtualization is * disabled. To enable virtualization, set its value to 0 or a positive number. * * For more detals, please see the {@link ListBox.virtualizationThreshold} * property. */ virtualizationThreshold: number; /** * Gets or sets a value that determines whether the drop-down {@link ListBox} * should include group header items to delimit data groups. * * Data groups are created by modifying the {@link ICollectionView.groupDescriptions} * property of the {@link ICollectionView} object used as an {@link itemsSource}. * * The default value for this property is **false**. */ showGroups: boolean; /** * Gets or sets the name of the property to use as the visual * representation of the items. */ displayMemberPath: string; /** * Gets or sets the name of a property to use for getting the value * displayed in the control's input element. * * The default value for this property is **null**, which causes the * control to display the same content in the input element as in the * selected item of the drop-down list. * * Use this property if you want to decouple the value shown in the * input element from the values shown in the drop-down list. For example, * the input element could show an item's name and the drop-down list * could show additional detail. */ headerPath: string | null; /** * Gets or sets the name of the property used to get the * {@link selectedValue} from the {@link selectedItem}. */ selectedValuePath: string; /** * Gets or sets a value indicating whether the drop-down list displays * items as plain text or as HTML. * * The default value for this property is **false**. */ isContentHtml: boolean; /** * Gets or sets a value that determines whether searches performed * while the user types should case-sensitive. * * The default value for this property is **false**. */ caseSensitiveSearch: boolean; /** * Gets or sets a value that determines whether values in the * control's input element should be trimmed by removing leading * and trailing spaces. * * The default value for this property is **true**. * * To see leading and trailing spaces in the drop-down list items, * you may have to apply a CSS rule such as this one: * * ```css * .wj-listbox-item { * white-space: pre; * } * ``` * */ trimText: boolean; /** * Gets or sets a function used to customize the values shown in * the drop-down list. * The function takes two arguments, the item index and the default * text or html, and returns the new text or html to display. * * If the formatting function needs a scope (i.e. a meaningful 'this' * value), then remember to set the filter using the 'bind' function * to specify the 'this' object. For example: * * ```typescript * comboBox.itemFormatter = customItemFormatter.bind(this); * function customItemFormatter(index, content) { * if (this.makeItemBold(index)) { * content = '<b>' + content + '</b>'; * } * return content; * } * ``` */ itemFormatter: IItemFormatter; /** * Event that fires when items in the drop-down list are created. * * You can use this event to modify the HTML in the list items. * For details, see the {@link ListBox.formatItem} event. */ readonly formatItem: Event; /** * Gets or sets the index of the currently selected item in * the drop-down list. */ selectedIndex: number; /** * Gets or sets the item that is currently selected in * the drop-down list. */ selectedItem: any; /** * Gets or sets the value of the {@link selectedItem}, obtained * using the {@link selectedValuePath}. * * If the {@link selectedValuePath} property is not set, gets or * sets the value of the control's {@link selectedItem} property. * * If the {@link itemsSource} property is not set, gets or sets * the value of the control's {@link text} property. */ selectedValue: any; /** * Gets or sets a value that determines whether the content of the * input element should be restricted to items in the {@link itemsSource} * collection. * * The default value for this property is **false** on the {@link ComboBox} control, and * **true** on the {@link AutoComplete} and {@link InputTime} controls. */ isEditable: boolean; /** * Gets or sets a value that determines whether the user can use * the mouse wheel to change the currently selected item. * * The default value for this property is **true**. */ handleWheel: boolean; /** * Gets or sets the maximum height of the drop-down list, in pixels. * * The default value for this property is **200** pixels. */ maxDropDownHeight: number; /** * Gets or sets the maximum width of the drop-down list. * * The width of the drop-down list is also limited by the width of * the control itself (that value represents the drop-down's * minimum width). * * The default value for this property is **null**, which * means the drop-down has no maximum width limit. */ maxDropDownWidth: number; /** * Gets or sets the action to perform when printable character keys are pressed (letters, numbers, symbols). * * The default setting for this property is {@link KeyAction.OpenDropdown}, * which opens the listbox and filters options as the user types. * This allows users to see matching options before making a selection. * * Alternatively, you can set this to {@link KeyAction.ChangeSelectionOnly} * to immediately change the selection to match the typed characters while keeping the listbox closed. * This is useful for quick selection in known-value scenarios. */ keyActionPrintCharacters: KeyAction; /** * Gets or sets the aria-labelledby attribute of input element. */ ariaLabelledBy: string; _updateInputAndListBoxAriaLabel(): void; /** * Gets the string displayed in the input element for the item at a * given index (always plain text). * * @param index The index of the item to retrieve the text for. * @param trimText Optionally override the value of the {@link trimText} property. */ getDisplayText(index?: number, trimText?: boolean): string; _getDisplayText(index?: number, trimText?: boolean, ignoreItemFormatter?: boolean): string; _hasCustomFormatItem(): boolean; /** * Gets the index of the first item that matches a given string. * * @param search String to search for. * @param fullMatch Whether to look for a full match or just the start of the string. * @return The index of the item, or -1 if not found. */ indexOf(search: string, fullMatch: boolean, dry?: boolean): number; /** * Gets the {@link ListBox} control shown in the drop-down. */ readonly listBox: ListBox; /** * Occurs when the value of the {@link itemsSource} property changes. */ readonly itemsSourceChanged: Event, EventArgs>; /** * Raises the {@link itemsSourceChanged} event. */ onItemsSourceChanged(e?: EventArgs): void; /** * Occurs when the value of the {@link selectedIndex} property changes. */ readonly selectedIndexChanged: Event, EventArgs>; /** * Raises the {@link selectedIndexChanged} event. */ onSelectedIndexChanged(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; onLostFocus(e?: EventArgs, oldIdxAutoComplete?: number, forceAutoCompleteBlurIdxUpdate?: boolean): void; onIsDroppedDownChanging(e: CancelEventArgs): boolean; onIsDroppedDownChanged(e?: EventArgs): void; protected _trySelectionUpdateOnItemsSourceChanged(isSourceChanged: boolean, txtCombo: string): void; protected _setIsDisabled(value: boolean): void; protected _updateBtn(): void; protected _hasItems(): boolean; _updateTbxAria(): void; _updateInputAriaLabel(): void; protected _createDropDown(): void; protected _wheel(e: WheelEvent): void; protected _dropDownClick(e: MouseEvent): void; protected _setText(text: string, fullMatch: boolean, isDateTime?: boolean): void; protected _findNext(search: string, step: number, start?: number): number; _findNextWhenIsEditableFalse(search: string, step: number, start?: number): number; protected _keydown(e: KeyboardEvent): void; _afterOpenDropdownByDownArrow(): void; _input(e: Event): void; _handleDragTextState(): void; _shouldOpenDropdown(): boolean; _handleIsEditableFalseInput(): void; _updateSelection(index: number, editStart: number): void; _updateComponentText(): void; _updateEmptyValueFlag(): void; _controlDropdownVisibility(): void; _resetDragState(): void; protected _updateInputSelection(start: number): void; private _getSelStart; private _getSelEnd; private _setSelRange; getAriaLabelForScreenReader(): any; _updateDropDownWhenInput(): void; } /** * Represents a method that returns a string used as a header for a * {@link MultiSelect} control. */ export interface IHeaderFormatter { /** * @param sender {@link MultiSelect} whose header is being formatted. * @returns The text to show in the control's header element. */ (sender: MultiSelect): string; } /** * The {@link MultiSelect} control allows users to select multiple items from * drop-down lists that contain custom objects or simple strings. * * The {@link MultiSelect} control extends {@link ComboBox}, with all the usual * properties, including {@link MultiSelect.itemsSource} and * {@link MultiSelect.displayMemberPath}. * * Like the {@link ListBox} control, it has a {@link MultiSelect.checkedMemberPath} * property that defines the name of the property that determines whether an * item is checked or not. * * The items currently checked (selected) can be obtained using the * {@link MultiSelect.checkedItems} property. * * The control header is fully customizable. By default, it shows up to two items * selected and the item count after that. You can change the maximum number of * items to display ({@link MultiSelect.maxHeaderItems}), the message shown when no * items are selected ({@link MultiSelect.placeholder}), and the format string used to * show the item count ({@link MultiSelect.headerFormat}). * * Alternatively, you can provide a function to generate the header content based * on whatever criteria your application requires ({@link MultiSelect.headerFormatter}). * * The example below shows how you can use a {@link MultiSelect} control to select * multiple items from a drop-down list: * * {@sample Input/MultiSelect/Overview Example} */ export declare class MultiSelect extends ComboBox { private _maxHdrItems; private _readOnly; private _hdrFmt; private _hdrFormatter; private _msLbx; static _DEF_CHECKED_PATH: string; static _ctrlTemplate: string; _inputElementAriaLabel: string; /** * Gets or sets the template used to instantiate {@link MultiSelect} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link MultiSelect} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets whether the control should display a "Select All" checkbox * above the items to select or de-select all items. * * The default value for this property is **false**. */ showSelectAllCheckbox: boolean; /** * Gets or sets whether the control should display a "filter" input * above the items to filter the items displayed. * * The default value for this property is **false**. */ showFilterInput: boolean; /** * Gets or sets the delay, in milliseconds, between when a keystroke occurs * and when the search is performed to update the filter. * * This property is relevant only when the {@link showFilterInput} * property is set to **true**. * * The default value for this property is **500** milliseconds. */ delay: number; /** * Gets or sets a value that determines whether searches performed * while the user types should case-sensitive. * * The default value for this property is **false**. */ caseSensitiveSearch: boolean; /** * Gets or sets the string used as a placeholder for the filter input * element on the {@link MultiSelectListBox} drop-down. * * The default value for this property is **null**, which causes the * control to use a localized version of the string "Filter". */ filterInputPlaceholder: string | null; /** * Gets or sets a value that determines whether the {@link MultiSelectListBox} * in the drop-down should automatically select all the filtered items when the * filter text changes. * * The default value for this property is **true**. */ checkOnFilter: boolean; /** * Gets or sets the string to be used as a label for the "Select All" * checkbox that is displayed when the {@link showSelectAllCheckbox} * property is set to true. * * The default value for this property is **null**, which causes the * control to use a localized version of the string "Select All". */ selectAllLabel: string | null; /** * Gets or sets the name of the property used to control the checkboxes * placed next to each item. */ checkedMemberPath: string; /** * Gets or sets the maximum number of items to display on the control header. * * If no items are selected, the header displays the text specified by the * {@link placeholder} property. * * If the number of selected items is smaller than or equal to the value of the * {@link maxHeaderItems} property, the selected items are shown in the header. * * If the number of selected items is greater than {@link maxHeaderItems}, the * header displays the selected item count instead. * * The default value for this property is **2**. */ maxHeaderItems: number; /** * Gets or sets the format string used to create the header content * when the control has more than {@link maxHeaderItems} items checked. * * The format string may contain the '{count}' replacement string * which gets replaced with the number of items currently checked. * * The default value for this property is **null**, which causes the * control to use a localized version of the string "{count:n0} items selected". */ headerFormat: string | null; /** * Gets or sets a function that gets the text displayed in the control * header. * * By default, the control header content is determined based on the * {@link placeholder}, {@link maxHeaderItems}, and on the current selection. * * You may customize the header content by specifying a function that * returns a custom string based on whatever criteria your application * requires. */ headerFormatter: IHeaderFormatter | null; /** * Gets or sets an array containing the items that are currently checked. */ checkedItems: any[]; /** * Occurs when the value of the {@link checkedItems} property changes. */ readonly checkedItemsChanged: Event; /** * Raises the {@link checkedItemsChanged} event. */ onCheckedItemsChanged(e?: EventArgs): void; dispose(): void; onIsDroppedDownChanged(e?: EventArgs): void; onLostFocus(): void; protected _createDropDown(): void; _updateBtnAria(): void; _updateTbxAria(): void; isReadOnly: boolean; refresh(fullUpdate?: boolean): void; protected _setText(text: string, fullMatch: boolean): void; protected _keydown(e: KeyboardEvent): void; protected _hasItems(): boolean; private _updateHeader; getAriaLabelForScreenReader(): any; } /** * Interface implemented by command objects. * * For details, please see the {@link Menu.command} property. */ export interface ICommand { /** * Executes the command with a given parameter. * * The parameter passed to the command is defined by the value of the * {@link Menu.commandParameterPath} property of the current item. * If the {@link Menu.commandParameterPath} property is not specified, * the parameter passed is the item itself. */ executeCommand(parameter: any): void; /** * Returns true if the command can be executed in the current app state. * * If this method returns false, the corresponding menu option is * disabled. */ canExecuteCommand?(parameter: any): boolean; } /** * The {@link Menu} control shows a text element with a drop-down list of commands that * the user can invoke by click or touch. * * The {@link Menu} control inherits from {@link ComboBox}, so you populate and style it * in the same way that you do the {@link ComboBox} (see the {@link Menu.itemsSource} * property). * * The {@link Menu} control adds an {@link Menu.itemClicked} event that fires when the user * selects an item from the menu. The event handler can inspect the {@link Menu} control * to determine which item was clicked. For example: * * ```typescript * import { Menu } from 'wijmo/wijmo.input'; * let menu = new Menu('#theMenu', { * header: 'Main Menu', * itemsSource: ['option 1', 'option 2', 'option 3'], * itemClicked: s => { * alert('Thanks for selecting item ' + s.selectedIndex + ' from menu ' + s.header + '!'); * } * }); * ``` * * The example below shows how you can create menus that handle the * {@link itemClicked} event. * * {@sample Input/Menu/Overview Example} */ export declare class Menu extends ComboBox { _hdr: HTMLElement; _closing: boolean; _cmd: ICommand; _cmdPath: string; _cmdParamPath: string; _subPath: string; _defaultItem: any; _owner: HTMLElement; _isButton: boolean; _keepOpen: boolean; _openOnHover: boolean; _closeOnLeave: boolean; _toHover: any; _subMenu: Menu; _hoverEnterBnd: any; _hoverLeaveBnd: any; _hoverOverBnd: any; _ariaLabel: string; _aFEnabledItem: boolean; static _evtHover: MouseEvent; static _MenuInstanceCount: number; static _ctrlTemplate: string; _parentMenu: Menu; /** * Gets or sets the template used to instantiate {@link Menu} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link Menu} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); _updateBtnAria(): void; _updateHdrAria(): void; _updateLbxAria(): void; /** * Gets or sets the aria-label attribute of {@link Menu} element. * * The default value for this property is "Menu". */ ariaLabel: string; /** * Gets or sets a value that determines whether the first enabled item is automatically focused/selected in the {@link dropDown}. * Used to add provide appropriate navigation when accessibility tools are used. * * The default value for this property is false. */ autoSelectOnFocus: boolean; /** * Gets or sets the HTML text shown in the {@link Menu} element. * * The default value for this property is an empty string (**''**). */ header: string; /** * Gets or sets the command object that determines whether menu items * should be enabled and what actions they should perform when selected. * * Command objects implement the {@link ICommand} interface. * * You can also set commands on individual items using the {@link commandPath} * property. * * The default value for this property is **null**. */ command: ICommand | null; /** * Gets or sets the name of the property that contains the command to * execute when the user clicks an item. * * Command objects implement the {@link ICommand} interface. * * This property overrides the {@link command} property for specific * menu items. * * The default value for this property is **null**. */ commandPath: string; /** * Gets or sets the name of the property that contains a parameter to use with * the command specified by the {@link commandPath} property. * * Command objects implement the {@link ICommand} interface. * * The default value for this property is **null**. */ commandParameterPath: string; /** * Gets or sets the name of the property that contains an array with items * to be displayed in a sub-menu. * * The default value for this property is **null**. */ subItemsPath: string; /** * Gets or sets a value that determines whether the menu (and any sub-menus) * should open automatically when the mouse hovers over the items. * * See also the {@link closeOnLeave} property, which determines whether the * menu should close automatically when the mouse leaves the menu. * * The default value for this property is **false**. */ openOnHover: boolean; /** * Gets or sets a value that determines whether the menu (and any sub-menus) * should close automatically when the mouse leaves the menu. * * This property is applicable only when the {@link openOnHover} is set to true. * * The default value for this property is **true**. */ closeOnLeave: boolean; /** * Gets or sets a value that determines whether this {@link Menu} should act * as a split button instead of a regular menu. * * The default value for this property is **false**. * * The difference between regular menus and split buttons is what happens * when the user clicks the menu header. * In regular menus, clicking the header shows or hides the menu options. * In split buttons, clicking the header raises the {@link Menu.itemClicked} * event and/or invokes the command associated with the last option selected by * the user as if the user had picked the item from the drop-down list. * * If you want to differentiate between clicks on menu items and the button * part of a split button, check the value of the {@link Menu.isDroppedDown} * property of the event sender. If that is true, then a menu item was clicked; * if it is false, then the button was clicked. * * For example, the code below implements a split button that uses the drop-down * list only to change the default item/command, and triggers actions only when * the button is clicked: * * ```typescript * import { Menu } from 'wijmo/wijmo.input'; * let theMenu = new Menu('#theMenu', { * isButton: true, * itemClicked: s => { * if (!s.isDroppedDown) { // header/button click * console.log('running ', s.selectedItem.browser); * } * }, * selectedIndexChanged: s => { // update header text * if (s.selectedItem != null) { * s.header = 'Run ' + s.selectedItem.browser; * } * }, * selectedValuePath: 'id', * displayMemberPath: 'browser', * itemsSource: [ * { id: 0, browser: 'Chrome' }, * { id: 1, browser: 'Edge' }, * { id: 2, browser: 'Firefox' }, * { id: 3, browser: 'Internet Explorer' } * ], * }); * ``` */ isButton: boolean; /** * Gets or sets a value that indicates whether the menu should remain open * after the user selects an item. * * When this property is set to **true**, the menu remains open after an item * is clicked, allowing users to perform multiple selections or execute * consecutive commands without having to reopen the menu. * * When set to **false** (the default), the menu automatically closes as soon * as an item is selected, which aligns with the standard behavior of most * dropdown or context menus. * * This property is useful in scenarios where continuous user interaction with * the menu is required。 */ keepOpen: boolean; /** * Gets or sets the element that owns this {@link Menu}. * * This property is set by the wj-context-menu directive in case a * single menu is used as a context menu for several different * elements. * * The default value for this property is **null**. */ owner: HTMLElement; /** * Shows the menu at a given location. * * @param position An optional **MouseEvent** or reference element * that determines the position where the menu should be displayed. * If not provided, the menu is displayed at the center of the screen. * This method is useful if you want to use the menu as a context * menu attached to one or more elements on the page. For example: * * ```typescript * import { Menu } from 'wijmo/wijmo.input'; * let theMenu = new Menu(document.createElement('div'), { * itemsSource: 'New,Open,Save,Exit'.split(','), * itemClicked: s => { * alert('thanks for picking ' + s.selectedIndex); * } * }); * * // use it as a context menu for one or more elements * let element = document.getElementById('btn'); * element.addEventListener('contextmenu', e => { * e.preventDefault(); * theMenu.show(e); * }); * ``` * You can adjust the position of the menu by setting the margin of * the menu's dropdown. For example, the code below causes the menu * to be displayed 20 pixels away from the point that was clicked: * * ```typescript * // add 20-pixel offset to the menu * theMenu.dropDown.style.margin = '20px'; * * // show menu as a context menu * let element = document.getElementById('btn'); * element.addEventListener('contextmenu', e => { * e.preventDefault(); * theMenu.show(e); * }); * ``` */ show(position?: any): void; /** * Hides the menu. * * This method is useful if you want to hide a context menu displayed * with the {@link show} method. */ hide(): void; /** * Occurs when the user picks an item from the menu. * * The handler can determine which item was picked by reading the event sender's * {@link selectedIndex} property. */ readonly itemClicked: Event; /** * Raises the {@link itemClicked} event. */ onItemClicked(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; onIsDroppedDownChanged(e?: EventArgs): void; private _restoreSelectedItem; _updateHoverEvents(): void; _getSubItems(item: any): any[]; _formatMenuItem(s: ListBox, e: FormatItemEventArgs): void; protected _keydown(e: KeyboardEvent): void; _afterOpenDropdownByDownArrow(): void; protected _dropDownClick(e: MouseEvent): void; private _closeSubMenuAndFocusOwner; private _showSubMenu; private _raiseCommand; private _focusMenuOwner; private _getCommand; private _getCommandParm; private _executeCommand; private _canExecuteCommand; private _enableDisableItems; private _clearHover; private _isTargetDisabled; private _hoverEnter; private _hoverOver; private _hoverLeave; _setIsDisabled(value: boolean): void; _setTabOrder(value: number): void; protected _getRtlStates(): boolean; /** * Disposes of the control and all its resources. * * Calling the {@link dispose} method is important in applications that create * and remove controls dynamically. Failing to dispose of the controls may * cause memory leaks. */ dispose(): void; } /** * The {@link InputTime} control allows users to enter times using any format * supported by the {@link Globalize} class, or to pick times from a drop-down * list. * * The {@link min}, {@link max}, and {@link step} properties determine the values shown * in the list. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. * * The {@link value} property gets or sets a {@link Date} object that represents the time * selected by the user. * * The example below shows a **Date** value (that includes date and time information) * using an {@link InputDate} and an {@link InputTime} control. Notice how both controls * are bound to the same controller variable, and each edits the appropriate information * (either date or time). * * {@sample Input/InputTime/Overview/purejs Example} */ export declare class InputTime extends ComboBox { _value: Date; _min: Date; _max: Date; _step: number; _format: string; _msk: _MaskProvider; _hasCustomItems: boolean; static _ctrlTemplate: string; _inputElementAriaLabel: string; /** * Gets or sets the template used to instantiate {@link InputTime} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputTime} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets the HTML input element hosted by the control. * * Use this property in situations where you want to customize the * attributes of the input element. */ readonly inputElement: HTMLInputElement; /** * Gets or sets the "type" attribute of the HTML input element hosted by the control. * * By default, this property is set to "tel", a value that causes mobile devices to * show a numeric keypad that includes a negative sign and a decimal separator. * * Use this property to change the default setting if the default does not work well * for the current culture, device, or application. In those cases, try changing * the value to "number" or "text." * * Note that input elements with type "number" prevent selection in Chrome and therefore * is not recommended. For more details, see this link: * https://stackoverflow.com/questions/21177489/selectionstart-selectionend-on-input-type-number-no-longer-allowed-in-chrome */ inputType: string; /** * Gets or sets the current input time. */ value: Date | null; /** * Gets or sets the text shown in the control. */ text: string; /** * Gets or sets the earliest time that the user can enter. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ min: Date | null; /** * Gets or sets the latest time that the user can enter. * * For details about using the {@link min} and {@link max} properties, please see the * Using the min and max properties topic. */ max: Date | null; /** * Gets or sets the number of minutes between entries in the drop-down list. * * The default value for this property is **15** minutes. * * Setting it to **null**, zero, or any negative value disables the drop-down. * * Only the integer part of the step value is used. Setting **step** to * **30.5** for example will create **30** minute intervals. */ step: number | null; /** * Gets or sets the format used to display the selected time (see {@link Globalize}). * * The format string is expressed as a .NET-style * * time format string. * * The default value for this property is **'t'** (short time pattern). */ format: string; /** * Gets or sets a mask to use while the user is editing. * * The mask format is the same used by the {@link wijmo.input.InputMask} * control. * * If specified, the mask must be compatible with the value of * the {@link format} property. For example, you can use the mask '99:99 >LL' * for entering short times (format 't'). */ mask: string; onLostFocus(): void; /** * Occurs when the value of the {@link value} property changes, either * as a result of user actions or by assignment in code. */ readonly valueChanged: Event; /** * Raises the {@link valueChanged} event. */ onValueChanged(e?: EventArgs): void; onItemsSourceChanged(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; onSelectedIndexChanged(e?: EventArgs): void; _clamp(value: Date): Date; protected _wheel(e: WheelEvent): void; protected _updateInputSelection(start: number): void; protected _updateItems(): void; private _getTime; protected _getText(): string; protected _canChangeValue(): boolean; protected getSeconds(val: Date): number; protected _keydown(e: KeyboardEvent): void; protected _updateTimeValue(step: number, specialChars: any, actualFormat: string): void; private _reselectText; protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void; protected _copy(key: string, value: any): boolean; getAriaLabelForScreenReader(): any; _input(e: Event): void; } /** * The {@link InputDateTime} control extends the {@link InputDate} control to allows users * to input dates and times, either by typing complete date/time values in any format * supported by the {@link Globalize} class, or by picking dates from a drop-down calendar * and times from a drop-down list. * * Use the {@link InputDateTime.min} and {@link InputDateTime.max} properties to restrict * the range of dates that the user can enter. * * Use the {@link InputDateTime.timeMin} and {@link InputDateTime.timeMax} properties to * restrict the range of times that the user can enter. * * Use the {@link InputDateTime.value} property to gets or set the currently selected * date/time. * * The example below shows how you can use an {@link InputDateTime} control to edit * dates and times using a single control: * * {@sample Input/InputDateTime/Overview Example} */ export declare class InputDateTime extends InputDate { private _btnTm; private _inputTime; private _ddDate; private _ddTime; static _ctrlTemplate: string; protected _inputAriaLabel: any; /** * Gets or sets the template used to instantiate {@link InputDateTime} controls. */ static controlTemplate: string; /** * Initializes a new instance of the {@link InputDateTime} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the earliest time that the user can enter. * * The default value for this property is **null**, which means there * is no earliest time limit. */ timeMin: Date; /** * Gets or sets the latest time that the user can enter. * * The default value for this property is **null**, which means there * is no latest time limit. */ timeMax: Date; /** * Gets or sets the format used to display times in the drop-down list. * * This property does not affect the value shown in the control's input element. * That value is formatted using the {@link format} property. * * The format string is expressed as a .NET-style * * time format string. * * The default value for this property is **'t'** (short time pattern). */ timeFormat: string; /** * Gets or sets the number of minutes between entries in the * drop-down list of times. * * The default value for this property is **15** minutes. * * Setting this property to **null**, zero, or any negative value * disables the time-picker and hides the time drop-down button. * * Only the integer part of the step value is used. Setting * **timeStep** to **30.5** for example will create **30** * minute intervals. */ timeStep: number | null; /** * Gets a reference to the inner {@link InputTime} control so you can access its * full object model. */ readonly inputTime: InputTime; protected _fromDateTime(value: Date): Date; protected _btnclick(e: MouseEvent): void; dispose(): void; refresh(fullUpdate?: boolean): void; protected _updateBtn(): void; protected _setDropdown(e: HTMLElement): boolean; _updateDropDown(): void; protected _mouseWheel(e: WheelEvent): void; protected _keydown(e: KeyboardEvent): void; protected _updateDateTimeValue(step: number, specialChars: any, actualFormat: string): void; protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void; _updateTbxAria(): void; /** * Gets or sets the action to perform when the TAB key is pressed. * * The default setting for this property is {@link TabKeyAction.CloseAndMoveFocus}, * which provides standard form navigation behavior by: * - Closing the dropdown (if open) * - Moving focus to the next focusable element * * For specialized cases, you can set this to {@link TabKeyAction.CloseAndKeepFocus} * to maintain focus on the control after closing the dropdown. * * This setting is particularly useful for controlling accessibility behavior * and keyboard navigation flow in form controls. * * Example: * ```typescript * // Change TAB key behavior * dropDown.keyActionTab = TabKeyAction.CloseAndMoveFocus; * ``` */ keyActionTab: TabKeyAction; private _setDropDownByEvent; _updateBtnAria(): void; private inputDateTimeIsDroppedDownChanged; } /** * Represents a method that returns data items asynchronously as the user types. */ export interface IGetItems { /** * @param query Query string typed by the user. * @param maxItems Maximum number of items to return. * @param callback Callback function to invoke when the results become available. */ (query: string, maxItems: number, callback: IGetItemsCallback): void; } /** * Represents a method to invoke when the data items become available. */ export interface IGetItemsCallback { /** * items Array of data items retrieved asynchrounously. * */ (items: any[]): void; } /** * The {@link AutoComplete} control is an input control that allows callers * to customize the item list as the user types. * * The control is similar to the {@link ComboBox}, except the item source is a * function ({@link itemsSourceFunction}) rather than a static list. For example, * you can look up items on remote databases as the user types. * * The example below creates an {@link AutoComplete} control and populates it using * a 'countries' array. The {@link AutoComplete} searches for the country as the user * types, and narrows down the list of countries that match the current input. * * {@sample Input/AutoComplete/Overview/purejs Example} */ export declare class AutoComplete extends ComboBox { private _cssMatch; private _itemsSourceFn; private _itemsSourceFnCallbackBnd; private _srchProp; private _minLength; private _maxItems; private _itemCount; private _beginsWith; private _delay; _selItems: any; private _toSearch; private _query; private _rxSrch; private _rxHighlight; private _inCallback; private _srchProps; private _oldSelectedIndex; _pendingSearchFn: any; static _ctrlTemplate: string; _inputElementAriaLabel: string; /** * Gets or sets the template used to instantiate {@link AutoComplete} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link AutoComplete} class. * * @param element The DOM element that hosts the control, or a selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Gets or sets the minimum input length to trigger auto-complete suggestions. * * The default value for this property is **2**. */ minLength: number; /** * Gets or sets a value that determines whether to search for items * that begin with the given search term. * * The default value for this property is **false**, which causes * the control to search for items that contain the given search * terms. */ beginsWithSearch: boolean; /** * Gets or sets the maximum number of items to display in the drop-down list. * * The default value for this property is **6**. */ maxItems: number; /** * Gets or sets the delay, in milliseconds, between when a keystroke occurs * and when the search is performed. * * The default value for this property is **500** milliseconds. */ delay: number; /** * Gets or sets a string containing a comma-separated list of properties to use * when searching for items. * * By default, the {@link AutoComplete} control searches for matches against the * property specified by the {@link displayMemberPath} property. * The {@link searchMemberPath} property allows you to search using additional * properties. * * For example, the code below would cause the control to display the company * name and search by company name, symbol, and country: * * ```typescript * import { AutoComplete } from 'wijmo/wijmo.input'; * var ac = new AutoComplete('#autoComplete', { * itemsSource: companies, * displayMemberPath: 'name', * searchMemberPath: 'symbol,country' * }); * ``` */ searchMemberPath: string; /** * Gets or sets a function that provides list items dynamically as the user types. * * The function takes three parameters: *
    *
  • the query string typed by the user
    • *
  • the maximum number of items to return
    • *
  • the callback function to call when the results become available
    • *
* * For example: * * ```typescript * autoComplete.itemsSourceFunction: (query: string, max: number, callback: Function) => { * * // query the server * httpRequest('https://services.odata.org/Northwind/Northwind.svc/Products', { * data: { * $format: 'json', * $select: 'ProductID,ProductName', * $filter: 'indexof(ProductName, \'' + query + '\') gt -1' * }, * success: (xhr: XMLHttpRequest) => { * * // return results to AutoComplete control * let response = JSON.parse(xhr.response); * callback(response.d ? response.d.results : response.value); * } * }); * } * ``` */ itemsSourceFunction: IGetItems; /** * Gets or sets the name of the CSS class used to highlight any parts * of the content that match the search terms. * * The default value for this property is **wj-state-match**. */ cssMatch: string; /** * Raises the {@link selectedIndexChanged} event. */ onSelectedIndexChanged(e?: EventArgs): void; _updateTbxAria(): void; _keydown(e: KeyboardEvent): void; _input(e: Event): void; private _isBlurInput; protected _commitText(noFocus?: boolean): void; _setText(text: string | null): void; onLostFocus(e?: EventArgs): void; onGotFocus(e?: EventArgs): void; reset(): void; _itemSourceFunctionCallback(result: any[]): void; onIsDroppedDownChanged(e?: EventArgs): void; protected _updateItems(): void; protected _filter(item: any): boolean; protected _getItemText(item: any, header: boolean): string; protected _formatListItem(sender: any, e: FormatItemEventArgs): void; private _enclosed; protected _wheel(e: WheelEvent): void; getAriaLabelForScreenReader(): any; _hasCustomFormatItem(): boolean; } /** * The {@link MultiAutoComplete} control allows users to pick items from lists * that contain custom objects or simple strings. * * The example below shows how you can use a {@link MultiAutoComplete} to * enter multiple items picked from a single list: * * {@sample Input/MultiAutoComplete/Overview Example} */ export declare class MultiAutoComplete extends AutoComplete { private _wjTpl; private _wjInput; private _helperInput; private _screenReaderHelper; private _maxSelItems; private _lastInputValue; private _selPath; private _notAddItm; static _clsActive: string; static _ctrlTemplate: string; _inputElementAriaLabel: string; _helperInputElementAriaLabel: string; _ariaLabelledby: string; /** * Gets or sets the template used to instantiate {@link MultiAutoComplete} control. */ static controlTemplate: string; /** * Initializes a new instance of the {@link MultiAutoComplete} class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ constructor(element: any, options?: any); /** * Overridden to prevent the control from showing the drop-down button. */ showDropDownButton: boolean; /** * Gets or sets the maximum number of items that can be selected. * * The default value for this property is **null**, which allows * users to pick any number of items. */ maxSelectedItems: number; /** * Gets or sets the name of the property used to control which * item will be selected. */ selectedMemberPath: string; /** * Gets or sets an array containing the items that are currently * selected. */ selectedItems: any[]; /** * Gets or sets the aria-labelledby attribute of input element. */ ariaLabelledBy: string; /** * Occurs when the value of the {@link selectedItems} property changes. */ readonly selectedItemsChanged: Event; /** * Raises the {@link selectedItemsChanged} event. */ onSelectedItemsChanged(e?: EventArgs): void; onIsDroppedDownChanged(e?: EventArgs): void; refresh(fullUpdate?: boolean): void; _keydown(e: KeyboardEvent): void; protected _updateState(): void; protected _keyup(e: KeyboardEvent): void; private _addHelperInput; private _addScreenReaderHelper; private _refreshHeader; private _insertToken; private _updateMaxItems; private _updateFocus; private _addItem; private _delItem; private _updateSelItems; private _createItem; private _itemOn; private _itemOff; private _initSeltems; private _getSelItem; private _setSelItem; private _clearSelIndex; private _hasSelectedMemeberPath; private _disableInput; private _adjustInputWidth; private _getItemIndex; _setIsDisabled(value: boolean): void; _setTabOrder(value: number): void; _updateTabIndex(): void; } export {};