@grapecity/wijmo.input 5.20251.40 → 5.20252.44

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
     *
-    * Wijmo Library 5.20251.40
+    * Wijmo Library 5.20252.44
     * https://developer.mescius.com/wijmo
     *
     * Copyright(c) MESCIUS inc. All rights reserved.
@@ -73,12 +73,14 @@ export declare const InputColorClsNames: {
 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;
@@ -108,6 +110,7 @@ export declare const MultiAutoCompleteClsNames: {
     tokenClose: string;
     tokenHelper: string;
     tokenLabel: string;
+    screenReaderOnly: string;
 };
 export declare const MultiSelectClsNames: {
     hostElement: string;
@@ -338,9 +341,20 @@ export declare class InputNumber extends Control {
     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;
@@ -399,6 +413,8 @@ export declare class InputMask extends Control {
     _msk: _MaskProvider;
     _fullEdit: boolean;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link InputMask} controls.
      */
@@ -501,8 +517,22 @@ export declare class InputMask extends Control {
     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).
@@ -527,7 +557,11 @@ export declare class ColorPicker extends Control {
     _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.
@@ -584,6 +618,20 @@ export declare class ColorPicker extends Control {
      * 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.
@@ -600,7 +648,18 @@ export declare class ColorPicker extends Control {
     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
@@ -708,6 +767,7 @@ export declare class CollectionViewNavigator<T = any> extends Control {
     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
@@ -796,6 +856,7 @@ export declare class ListBox<T = any> extends Control {
     _ariaLabel: string;
     static _DIDX_KEY: string;
     static _VTHRESH: number;
+    _isNeedUpdateBnd: boolean;
     /**
      * Initializes a new instance of the {@link ListBox} class.
      *
@@ -1145,8 +1206,17 @@ export declare class ListBox<T = any> extends Control {
     _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.
@@ -1193,6 +1263,7 @@ export declare class MultiSelectListBox<T = any> extends Control {
     _lbx: ListBox;
     _cbSelectAll: HTMLInputElement;
     _spSelectAll: HTMLSpanElement;
+    _ariaLabel: string;
     _selectAllLabel: string;
     _filterPlaceholder: string;
     _filterText: string;
@@ -1343,6 +1414,11 @@ export declare class MultiSelectListBox<T = any> extends Control {
      * 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.
      */
@@ -1541,6 +1617,7 @@ export declare class Calendar extends Control {
     private _keyActionTab;
     private _ariaLabel;
     private _showConfirmationButtons;
+    private _isSpaceDownForSetValue;
     private _tmYrHidden;
     private _syncing;
     private _cals;
@@ -1950,10 +2027,8 @@ export declare class Calendar extends Control {
      */
     keyActionTab: CalendarTabKeyAction;
     private _isButtonFocused;
-    private _isSameDay;
     private _isSameMonth;
     private _dateViewContainsFocus;
-    getFocusableElements(): HTMLElement[];
     private _updateMonthButtonAria;
     private _isDayValid;
     readonly cancelButtonClicked: Event<Calendar, EventArgs>;
@@ -1971,7 +2046,16 @@ export declare class Calendar extends Control {
     _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.
@@ -2028,7 +2112,9 @@ export declare class DropDown extends Control {
     _isInvalidInputCancelled: boolean;
     _keyActionDownArrow: KeyAction;
     _keyActionUpArrow: KeyAction;
+    _keyActionTab: TabKeyAction;
     static _ctrlTemplate: string;
+    _touchMove: boolean;
     /**
      * Gets or sets the template used to instantiate {@link DropDown} controls.
      */
@@ -2040,6 +2126,7 @@ export declare class DropDown extends Control {
      * @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.
      */
@@ -2154,6 +2241,27 @@ export declare class DropDown extends Control {
      * 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.
      */
@@ -2211,6 +2319,7 @@ export declare class DropDown extends Control {
     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.
@@ -2338,6 +2447,7 @@ 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;
@@ -2384,6 +2494,9 @@ export declare class Popup extends Control {
     protected _lastShow: number;
     protected _initialOwner: HTMLElement;
     protected _activeEdge: _Edges;
+    private _toHidePopupTimer;
+    private _toGetFocusTimer;
+    private _hideTimer;
     /**
      * Initializes a new instance of the {@link Popup} class.
      *
@@ -2792,7 +2905,6 @@ export declare class Popup extends Control {
      */
     onPositionChanged(e?: EventArgs): void;
     onLostFocus(e?: EventArgs): void;
-    dispose(): void;
     refresh(fullUpdate?: boolean): void;
     _clearTimeouts(): void;
     protected _handleDragResize(on: boolean): void;
@@ -2813,6 +2925,14 @@ export declare class Popup extends Control {
     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
@@ -2901,7 +3021,6 @@ export declare class InputDate extends DropDown {
     protected _currentInput: string;
     static _ctrlTemplate: string;
     _ariaLabelledby: string;
-    _keyActionTab: TabKeyAction;
     /**
      * Gets or sets the template used to instantiate {@link InputDate} control.
      */
@@ -3282,6 +3401,7 @@ export declare class InputDate extends DropDown {
      * Raises the {@link rangeChanged} event.
      */
     onRangeChanged(e?: EventArgs): void;
+    protected _getParsedValue(): Date;
     refresh(fullUpdate?: boolean): void;
     onIsDroppedDownChanging(e: CancelEventArgs): boolean;
     onIsDroppedDownChanged(e?: EventArgs): void;
@@ -3318,28 +3438,6 @@ export declare class InputDate extends DropDown {
     ariaLabelledBy: string;
     protected _updateInputAriaLabel(): void;
     getAriaLabelForScreenReader(): any;
-    /**
-     * 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
-     * inputDate.keyActionTab = TabKeyAction.CloseAndMoveFocus;
-     * ```
-     */
-    keyActionTab: TabKeyAction;
-    _shouldRaiseInvalidInput(shouldInvalid: boolean): boolean;
 }
 /**
  * The {@link InputDateRange} control extends the {@link InputDate}
@@ -3387,6 +3485,8 @@ export declare class InputColor extends DropDown {
     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.
@@ -3447,6 +3547,14 @@ export declare class InputColor extends DropDown {
      * 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.
@@ -3460,8 +3568,10 @@ export declare class InputColor extends DropDown {
     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.
@@ -3516,7 +3626,6 @@ export declare class ComboBox<T = any> extends DropDown {
     _selItems: any;
     _oldFilter: any;
     static _ctrlTemplate: string;
-    _keyActionTab: TabKeyAction;
     _keyActionPrintCharacters: KeyAction;
     _inputElementAriaLabel: string;
     _ariaLabelledby: string;
@@ -3721,27 +3830,6 @@ export declare class ComboBox<T = any> extends DropDown {
      * This is useful for quick selection in known-value scenarios.
      */
     keyActionPrintCharacters: 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
-     * comboBox.keyActionTab = TabKeyAction.CloseAndMoveFocus;
-     * ```
-     */
-    keyActionTab: TabKeyAction;
     /**
      * Gets or sets the aria-labelledby attribute of input element.
      */
@@ -3805,7 +3893,6 @@ export declare class ComboBox<T = any> extends DropDown {
     _afterOpenDropdownByDownArrow(): void;
     _input(e: Event): void;
     _handleDragTextState(): void;
-    _handleComposingState(): void;
     _shouldOpenDropdown(): boolean;
     _handleIsEditableFalseInput(): void;
     _updateSelection(index: number, editStart: number): void;
@@ -3818,6 +3905,7 @@ export declare class ComboBox<T = any> extends DropDown {
     private _getSelEnd;
     private _setSelRange;
     getAriaLabelForScreenReader(): any;
+    _updateDropDownWhenInput(): void;
 }
 /**
  * Represents a method that returns a string used as a header for a
@@ -3994,6 +4082,8 @@ export declare class MultiSelect extends ComboBox {
     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;
@@ -4063,6 +4153,7 @@ export declare class Menu extends ComboBox {
     _defaultItem: any;
     _owner: HTMLElement;
     _isButton: boolean;
+    _keepOpen: boolean;
     _openOnHover: boolean;
     _closeOnLeave: boolean;
     _toHover: any;
@@ -4073,7 +4164,9 @@ export declare class Menu extends ComboBox {
     _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.
      */
@@ -4085,6 +4178,9 @@ export declare class Menu extends ComboBox {
      * @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.
      *
@@ -4211,6 +4307,22 @@ export declare class Menu extends ComboBox {
      * ```
      */
     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}.
      *
@@ -4284,13 +4396,17 @@ export declare class Menu extends ComboBox {
     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;
@@ -4303,6 +4419,15 @@ export declare class Menu extends ComboBox {
     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
@@ -4446,7 +4571,7 @@ export declare class InputTime extends ComboBox {
     protected _keydown(e: KeyboardEvent): void;
     protected _updateTimeValue(step: number, specialChars: any, actualFormat: string): void;
     private _reselectText;
-    protected _commitText(): void;
+    protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
     protected _copy(key: string, value: any): boolean;
     getAriaLabelForScreenReader(): any;
     _input(e: Event): void;
@@ -4546,6 +4671,31 @@ export declare class InputDateTime extends InputDate {
     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.
@@ -4740,6 +4890,7 @@ export declare class MultiAutoComplete extends AutoComplete {
     private _wjTpl;
     private _wjInput;
     private _helperInput;
+    private _screenReaderHelper;
     private _maxSelItems;
     private _lastInputValue;
     private _selPath;
@@ -4747,6 +4898,8 @@ export declare class MultiAutoComplete extends AutoComplete {
     static _clsActive: string;
     static _ctrlTemplate: string;
     _inputElementAriaLabel: string;
+    _helperInputElementAriaLabel: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link MultiAutoComplete} control.
      */
@@ -4779,6 +4932,10 @@ export declare class MultiAutoComplete extends AutoComplete {
      * 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.
      */
@@ -4793,6 +4950,7 @@ export declare class MultiAutoComplete extends AutoComplete {
     protected _updateState(): void;
     protected _keyup(e: KeyboardEvent): void;
     private _addHelperInput;
+    private _addScreenReaderHelper;
     private _refreshHeader;
     private _insertToken;
     private _updateMaxItems;