@mescius/wijmo.input 5.20251.41-nightly.d20250710.t180956 → 5.20251.41-nightly.d20250715.t181602

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
     *
-    * Wijmo Library 5.20251.41-nightly.d20250710.t180956
+    * Wijmo Library 5.20251.41-nightly.d20250715.t181602
     * https://developer.mescius.com/wijmo
     *
     * Copyright(c) MESCIUS inc. All rights reserved.
@@ -510,6 +510,15 @@ export declare class InputMask extends Control {
     _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).
@@ -534,7 +543,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.
@@ -591,6 +604,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.
@@ -608,6 +635,16 @@ export declare class ColorPicker extends Control {
     private _makePalEntry;
     private _updatePanels;
     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
@@ -1960,7 +1997,6 @@ export declare class Calendar extends Control {
     private _isSameDay;
     private _isSameMonth;
     private _dateViewContainsFocus;
-    getFocusableElements(): HTMLElement[];
     private _updateMonthButtonAria;
     private _isDayValid;
     readonly cancelButtonClicked: Event<Calendar, EventArgs>;
@@ -1980,6 +2016,7 @@ export declare class Calendar extends Control {
     protected _setIsDisabled(value: boolean): void;
     private updateCalendarsTabindex;
     private setFocusModeValue;
+    private _getCalendarsHostElements;
 }
 /**
  * Specifies constants that define the action to perform when the
@@ -2037,6 +2074,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.
@@ -2163,6 +2201,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.
      */
@@ -2910,7 +2969,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.
      */
@@ -3327,27 +3385,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;
 }
 /**
@@ -3396,6 +3433,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.
@@ -3456,6 +3495,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.
@@ -3471,6 +3518,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.
@@ -3525,7 +3573,6 @@ export declare class ComboBox<T = any> extends DropDown {
     _selItems: any;
     _oldFilter: any;
     static _ctrlTemplate: string;
-    _keyActionTab: TabKeyAction;
     _keyActionPrintCharacters: KeyAction;
     _inputElementAriaLabel: string;
     _ariaLabelledby: string;
@@ -3730,27 +3777,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.
      */
@@ -3827,6 +3853,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