@grapecity/wijmo.input 5.20251.40 → 5.20252.42

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
     *
-    * Wijmo Library 5.20251.40
+    * Wijmo Library 5.20252.42
     * 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;
@@ -341,6 +344,13 @@ export declare class InputNumber extends Control {
     protected _keypress(e: KeyboardEvent): void;
     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 +409,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 +513,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 +553,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 +614,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 +644,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
@@ -796,6 +851,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 +1201,10 @@ 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;
+    dispose(): void;
 }
 /**
  * Provides arguments for the {@link ListBox.formatItem} event.
@@ -1193,6 +1251,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 +1402,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 +1605,7 @@ export declare class Calendar extends Control {
     private _keyActionTab;
     private _ariaLabel;
     private _showConfirmationButtons;
+    private _isSpaceDownForSetValue;
     private _tmYrHidden;
     private _syncing;
     private _cals;
@@ -1950,10 +2015,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,6 +2034,12 @@ 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;
 }
 /**
  * Specifies constants that define the action to perform when the
@@ -2028,6 +2097,7 @@ export declare class DropDown extends Control {
     _isInvalidInputCancelled: boolean;
     _keyActionDownArrow: KeyAction;
     _keyActionUpArrow: KeyAction;
+    _keyActionTab: TabKeyAction;
     static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link DropDown} controls.
@@ -2154,6 +2224,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 +2302,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 +2430,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 +2477,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 +2888,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 +2908,7 @@ export declare class Popup extends Control {
     protected _validateAndHide(result: any): void;
     protected _updateAriaLabel(): void;
     protected _updateAriaLabelImp(oldLabels: any): void;
+    dispose(): void;
 }
 /**
  * Provides arguments for the {@link Popup} control's {@link sizeChanging} and
@@ -2901,7 +2997,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.
      */
@@ -3318,28 +3413,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 +3460,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 +3522,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.
@@ -3462,6 +3545,7 @@ export declare class InputColor extends DropDown {
     protected _commitText(): 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 +3600,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 +3804,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.
      */
@@ -3818,6 +3880,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 +4057,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;
@@ -4073,7 +4138,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 +4152,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.
      *
@@ -4284,13 +4354,16 @@ 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 _showSubMenu;
     private _raiseCommand;
+    private _focusMenuOwner;
     private _getCommand;
     private _getCommandParm;
     private _executeCommand;
@@ -4303,6 +4376,7 @@ export declare class Menu extends ComboBox {
     private _hoverLeave;
     _setIsDisabled(value: boolean): void;
     _setTabOrder(value: number): void;
+    dispose(): void;
 }
 /**
  * The {@link InputTime} control allows users to enter times using any format
@@ -4446,7 +4520,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 +4620,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 +4839,7 @@ export declare class MultiAutoComplete extends AutoComplete {
     private _wjTpl;
     private _wjInput;
     private _helperInput;
+    private _screenReaderHelper;
     private _maxSelItems;
     private _lastInputValue;
     private _selPath;
@@ -4747,6 +4847,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 +4881,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 +4899,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;