@grapecity/wijmo.input 5.20242.30 → 5.20251.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  /*!
2
2
  *
3
- * Wijmo Library 5.20242.30
3
+ * Wijmo Library 5.20251.40
4
4
  * https://developer.mescius.com/wijmo
5
5
  *
6
6
  * Copyright(c) MESCIUS inc. All rights reserved.
@@ -39,6 +39,10 @@ export declare const CalendarClsNames: {
39
39
  weekAfter: string;
40
40
  weekBefore: string;
41
41
  yearPicker: string;
42
+ focused: string;
43
+ selectedYear: string;
44
+ confirmationButtonContainer: string;
45
+ button: string;
42
46
  };
43
47
  export declare const CollectionViewNavigatorClsNames: {
44
48
  hostElement: string;
@@ -173,6 +177,8 @@ export declare class InputNumber extends Control {
173
177
  _rptDn: _ClickRepeater;
174
178
  _fromKb: boolean;
175
179
  static _ctrlTemplate: string;
180
+ _inputElementAriaLabel: string;
181
+ _ariaLabelledby: string;
176
182
  /**
177
183
  * Gets or sets the template used to instantiate {@link InputNumber} controls.
178
184
  */
@@ -286,6 +292,10 @@ export declare class InputNumber extends Control {
286
292
  * The default value for this property is **true**.
287
293
  */
288
294
  repeatButtons: boolean;
295
+ /**
296
+ * Gets or sets the aria-labelledby attribute of input element.
297
+ */
298
+ ariaLabelledBy: string;
289
299
  /**
290
300
  * Sets the focus to the control and selects all its content.
291
301
  */
@@ -333,6 +343,8 @@ export declare class InputNumber extends Control {
333
343
  protected _input(): void;
334
344
  protected _clickSpinner(e: MouseEvent): void;
335
345
  protected _updateAria(): void;
346
+ _updateInputAriaLabel(): void;
347
+ getAriaLabelForScreenReader(): any;
336
348
  }
337
349
  /**
338
350
  * The {@link InputMask} control provides a way to govern what a user is allowed
@@ -489,6 +501,7 @@ export declare class InputMask extends Control {
489
501
  dispose(): void;
490
502
  refresh(fullUpdate?: boolean): void;
491
503
  onGotFocus(e: any): void;
504
+ getAriaLabelForScreenReader(): any;
492
505
  }
493
506
  /**
494
507
  * The {@link ColorPicker} control allows users to select a color by clicking
@@ -615,6 +628,9 @@ export declare class CollectionViewNavigator<T = any> extends Control {
615
628
  private _rptNext;
616
629
  private _rptPrev;
617
630
  private _fmt;
631
+ private _liveRegionON;
632
+ private _ariaLabel;
633
+ private _isDisabled;
618
634
  static _ctrlTemplate: string;
619
635
  /**
620
636
  * Gets or sets the template used to instantiate {@link CollectionViewNavigator} controls.
@@ -669,10 +685,29 @@ export declare class CollectionViewNavigator<T = any> extends Control {
669
685
  * The default value for this property is **true**.
670
686
  */
671
687
  repeatButtons: boolean;
688
+ /**
689
+ * Gets or sets the aria-label attribute of {@link CollectionViewNavigator} element.
690
+ */
691
+ ariaLabel: string;
692
+ /**
693
+ * Gets or sets a value that determines whether the control is disabled.
694
+ *
695
+ * Disabled controls cannot get mouse or keyboard events.
696
+ */
697
+ isDisabled: boolean;
698
+ /**
699
+ * Sets the focus to this control.
700
+ */
701
+ focus(): void;
672
702
  _update(): void;
673
703
  _currentChanged(): void;
674
704
  _collectionChanged(): void;
675
705
  _click(e: MouseEvent): void;
706
+ private _updateAriaLabels;
707
+ private _addA11yRelatedHandlers;
708
+ protected _setTabOrder(value: number): void;
709
+ _keydown(e: KeyboardEvent): void;
710
+ protected _setIsDisabled(value: boolean): void;
676
711
  }
677
712
  /**
678
713
  * Represents a method that formats an item for display in a
@@ -735,9 +770,13 @@ export declare class ListBox<T = any> extends Control {
735
770
  _itemRole: string;
736
771
  _caseSensitive: boolean;
737
772
  _addMode: boolean;
773
+ private _isShiftDown;
774
+ private _shouldClearOnShift;
738
775
  _vThreshold: number;
739
776
  _isVirtual: boolean;
740
777
  _children: HTMLElement[];
778
+ _ignoreItemFormatterTextArray: string[];
779
+ _itemFormatterHelper: HTMLDivElement;
741
780
  _clientHeight: number;
742
781
  _itemHeight: number;
743
782
  _itemsAbove: number;
@@ -754,6 +793,7 @@ export declare class ListBox<T = any> extends Control {
754
793
  _oldSel: HTMLElement | null;
755
794
  _container: HTMLElement | null;
756
795
  _oldSelectedIndex: number;
796
+ _ariaLabel: string;
757
797
  static _DIDX_KEY: string;
758
798
  static _VTHRESH: number;
759
799
  /**
@@ -763,6 +803,10 @@ export declare class ListBox<T = any> extends Control {
763
803
  * @param options The JavaScript object containing initialization data for the control.
764
804
  */
765
805
  constructor(element: any, options?: any);
806
+ /**
807
+ * Gets or sets the aria-labelledby attribute of {@link ListBox} input element.
808
+ */
809
+ ariaLabelledBy: string;
766
810
  /**
767
811
  * Gets or sets the array or {@link ICollectionView} object that contains
768
812
  * the list items.
@@ -881,13 +925,14 @@ export declare class ListBox<T = any> extends Control {
881
925
  *
882
926
  * @param index The index of the item in the {@link itemsSource}.
883
927
  */
884
- getDisplayValue(index: number): string;
928
+ getDisplayValue(index: number, ignoreItemFormatter?: boolean): string;
885
929
  /**
886
930
  * Gets the text displayed for the item at a given index (as plain text).
887
931
  *
888
932
  * @param index The index of the item in the {@link itemsSource}.
889
933
  */
890
934
  getDisplayText(index: number): string;
935
+ _getDisplayText(index: number, notGetByList?: boolean): string;
891
936
  /**
892
937
  * Gets a value that determines whether the item at a given index is enabled.
893
938
  *
@@ -1057,6 +1102,7 @@ export declare class ListBox<T = any> extends Control {
1057
1102
  * @param fullUpdate Whether to update the control layout as well as the content.
1058
1103
  */
1059
1104
  refresh(fullUpdate?: boolean): void;
1105
+ _updateAriaLabel(): void;
1060
1106
  _updateCheckedList(arr: any[]): void;
1061
1107
  _getBoundingClientRect(e: HTMLElement): Rect;
1062
1108
  _updateItemAttributes(e: HTMLElement | null, selected: boolean): void;
@@ -1077,24 +1123,30 @@ export declare class ListBox<T = any> extends Control {
1077
1123
  _updateViewRange(): boolean;
1078
1124
  _getSelectedElement(visible: boolean): HTMLElement | null;
1079
1125
  _handleResize(): void;
1080
- _createItem(i: number): string;
1126
+ _createItem(i: number, groupIndex?: number): string;
1081
1127
  _getAriaSelected(isSelected: boolean, isChecked: boolean | null): boolean;
1082
- _createHeaderItem(group: CollectionViewGroup): string;
1128
+ _createHeaderItem(group: CollectionViewGroup, groupIndex: number): string;
1083
1129
  private _click;
1084
1130
  private _keydown;
1131
+ private _handleKeyUp;
1132
+ private _getCheckboxState;
1133
+ private _setCheckboxState;
1134
+ private _getCheckbox;
1085
1135
  private _keypress;
1086
- _selectNext(): boolean;
1087
- _selectPrev(): boolean;
1136
+ private _selectNext;
1137
+ private _selectPrev;
1138
+ private _findNextEnabled;
1139
+ private _findPrevEnabled;
1088
1140
  _selectFirst(): boolean;
1089
1141
  _selectLast(): boolean;
1090
1142
  _selectNextPage(): boolean;
1091
1143
  _selectPrevPage(): boolean;
1092
1144
  private _findNext;
1093
- private _getCheckbox;
1094
1145
  _initFromSelect(hostElement: HTMLElement): void;
1095
1146
  _setIsDisabled(value: boolean): void;
1096
1147
  _setTabOrder(value: number): void;
1097
1148
  _updateTabIndex(): void;
1149
+ private _selectRange;
1098
1150
  }
1099
1151
  /**
1100
1152
  * Provides arguments for the {@link ListBox.formatItem} event.
@@ -1400,6 +1452,15 @@ export interface IDateValidator {
1400
1452
  */
1401
1453
  (date: Date): boolean;
1402
1454
  }
1455
+ /**
1456
+ * Specifies constants that define the action to be performed when the TAB key is pressed.
1457
+ */
1458
+ export declare enum CalendarTabKeyAction {
1459
+ /** No special action (let the browser handle the key). */
1460
+ None = 0,
1461
+ /** All buttons in the calendar can be selected using the tab key. */
1462
+ All = 1
1463
+ }
1403
1464
  /**
1404
1465
  * The {@link Calendar} control displays a table with one or more months
1405
1466
  * and allows users to view and select dates.
@@ -1451,6 +1512,9 @@ export declare class Calendar extends Control {
1451
1512
  private _btnPrv;
1452
1513
  private _btnTdy;
1453
1514
  private _btnNxt;
1515
+ private _confirmationButtonContainer;
1516
+ private _btnOK;
1517
+ private _btnCancel;
1454
1518
  private _lbYears;
1455
1519
  private _rptUp;
1456
1520
  private _rptDn;
@@ -1471,6 +1535,12 @@ export declare class Calendar extends Control {
1471
1535
  private _selMode;
1472
1536
  private _itemFormatter;
1473
1537
  private _itemValidator;
1538
+ private _showYearListBoxButton;
1539
+ private _focusMode;
1540
+ private _focusValue;
1541
+ private _keyActionTab;
1542
+ private _ariaLabel;
1543
+ private _showConfirmationButtons;
1474
1544
  private _tmYrHidden;
1475
1545
  private _syncing;
1476
1546
  private _cals;
@@ -1480,6 +1550,7 @@ export declare class Calendar extends Control {
1480
1550
  private _fmtDayHdr;
1481
1551
  private _fmtDay;
1482
1552
  private _fmtMonths;
1553
+ private _fmtDayTitle;
1483
1554
  static _DATE_KEY: string;
1484
1555
  static _ctrlTemplate: string;
1485
1556
  /**
@@ -1519,6 +1590,7 @@ export declare class Calendar extends Control {
1519
1590
  * cal.value = start; // rangeEnd == null
1520
1591
  */
1521
1592
  value: Date;
1593
+ focusValue: Date;
1522
1594
  /**
1523
1595
  * Gets or sets the last selected date in a range selection.
1524
1596
  *
@@ -1844,6 +1916,8 @@ export declare class Calendar extends Control {
1844
1916
  private _syncProp;
1845
1917
  private _updateContent;
1846
1918
  private _updateSelection;
1919
+ private _updateFocusInAccessibilityMode;
1920
+ private _updateCellFocus;
1847
1921
  private _addWeek;
1848
1922
  private _customizeCell;
1849
1923
  private _canChangeValue;
@@ -1863,6 +1937,40 @@ export declare class Calendar extends Control {
1863
1937
  _rngMode(): boolean;
1864
1938
  private _navigate;
1865
1939
  _setTabOrder(value: number): void;
1940
+ private _showYearPickerAction;
1941
+ /**
1942
+ * Gets or sets the focusMode enabled to support wcag related functions of {@link Calendar} element.
1943
+ */
1944
+ focusMode: boolean;
1945
+ /**
1946
+ * Gets or sets the action to perform when the Tab key is pressed.
1947
+ *
1948
+ * The default setting for this property is {@link CalendarTabKeyAction.None},
1949
+ * This means that pressing the tab key will have no effect and follow the browser's default behavior.
1950
+ */
1951
+ keyActionTab: CalendarTabKeyAction;
1952
+ private _isButtonFocused;
1953
+ private _isSameDay;
1954
+ private _isSameMonth;
1955
+ private _dateViewContainsFocus;
1956
+ getFocusableElements(): HTMLElement[];
1957
+ private _updateMonthButtonAria;
1958
+ private _isDayValid;
1959
+ readonly cancelButtonClicked: Event<Calendar, EventArgs>;
1960
+ cancelButtonClick(e?: EventArgs): void;
1961
+ oneCancelButtonClick(e: any): void;
1962
+ readonly OKButtonClicked: Event<Calendar, EventArgs>;
1963
+ OKButtonClick(e?: EventArgs): void;
1964
+ onOkButtonClick(e: any): void;
1965
+ /**
1966
+ * Gets or sets the aria-label attribute of {@link Calendar} element.
1967
+ */
1968
+ ariaLabel: string;
1969
+ private _updateButtonTabIndex;
1970
+ readonly _enterKeyDownToSetValue: Event<Calendar, EventArgs>;
1971
+ _onEnterKeyDownToSetValue(e?: EventArgs): void;
1972
+ showConfirmationButtons: boolean;
1973
+ protected _setIsDisabled(value: boolean): void;
1866
1974
  }
1867
1975
  /**
1868
1976
  * Specifies constants that define the action to perform when the
@@ -1876,6 +1984,24 @@ export declare enum ClickAction {
1876
1984
  /** Toggle the drop-down. */
1877
1985
  Toggle = 2
1878
1986
  }
1987
+ /**
1988
+ * Defines the behavior when keys are pressed in the control.
1989
+ */
1990
+ export declare enum KeyAction {
1991
+ /** Changes the selection without opening the dropdown. */
1992
+ ChangeSelectionOnly = 0,
1993
+ /** Opens the dropdown without changing selection. */
1994
+ OpenDropdown = 1
1995
+ }
1996
+ /**
1997
+ * Defines the behavior when the TAB key is pressed in the control.
1998
+ */
1999
+ export declare enum TabKeyAction {
2000
+ /** Closes the dropdown while maintaining focus on the control */
2001
+ CloseAndKeepFocus = 0,
2002
+ /** Closes the dropdown and moves focus to the next tabbable element. */
2003
+ CloseAndMoveFocus = 1
2004
+ }
1879
2005
  /**
1880
2006
  * DropDown control (abstract).
1881
2007
  *
@@ -1900,6 +2026,8 @@ export declare class DropDown extends Control {
1900
2026
  _minWidthDropdown: string;
1901
2027
  _escapeIE: boolean;
1902
2028
  _isInvalidInputCancelled: boolean;
2029
+ _keyActionDownArrow: KeyAction;
2030
+ _keyActionUpArrow: KeyAction;
1903
2031
  static _ctrlTemplate: string;
1904
2032
  /**
1905
2033
  * Gets or sets the template used to instantiate {@link DropDown} controls.
@@ -1962,6 +2090,7 @@ export declare class DropDown extends Control {
1962
2090
  * this property is set to {@link ClickAction.Toggle} by default.
1963
2091
  */
1964
2092
  clickAction: ClickAction;
2093
+ protected _isDropdownOpened: boolean;
1965
2094
  /**
1966
2095
  * Gets or sets a value that indicates whether the drop down is currently
1967
2096
  * visible.
@@ -2005,6 +2134,26 @@ export declare class DropDown extends Control {
2005
2134
  * The default value for this property is **false**.
2006
2135
  */
2007
2136
  isAnimated: boolean;
2137
+ /**
2138
+ * Gets or sets the action to perform when the DOWN ARROW key is pressed.
2139
+ *
2140
+ * The default setting for this property is {@link KeyAction.ChangeSelectionOnly},
2141
+ * which causes the control to change the selection item while keeping the listbox closed.
2142
+ *
2143
+ * Alternatively, you can set this to {@link KeyAction.OpenDropdown} to open the listbox
2144
+ * without changing the current selection.
2145
+ */
2146
+ keyActionDownArrow: KeyAction;
2147
+ /**
2148
+ * Gets or sets the action to perform when the UP ARROW key is pressed.
2149
+ *
2150
+ * The default setting for this property is {@link KeyAction.ChangeSelectionOnly},
2151
+ * which causes the control to change the selection item while keeping the listbox closed.
2152
+ *
2153
+ * Alternatively, you can set this to {@link KeyAction.OpenDropdown} to open the listbox
2154
+ * without changing the current selection.
2155
+ */
2156
+ keyActionUpArrow: KeyAction;
2008
2157
  /**
2009
2158
  * Sets the focus to the control and selects all its content.
2010
2159
  */
@@ -2043,14 +2192,24 @@ export declare class DropDown extends Control {
2043
2192
  protected _expandSelection(): void;
2044
2193
  protected _getCharType(text: string, pos: number): 0 | 1 | -1;
2045
2194
  protected _keydown(e: KeyboardEvent): void;
2195
+ private toggleDropDown;
2196
+ private handleUpArrowKey;
2197
+ private handleDownArrowKey;
2198
+ _afterOpenDropdownByDownArrow(): void;
2199
+ private openDropDown;
2200
+ private isHostVisible;
2046
2201
  protected _isHiddenEditor(): boolean;
2047
2202
  protected _keypress(e: KeyboardEvent): void;
2048
2203
  protected _input(e: Event): void;
2049
2204
  protected _btnclick(e: MouseEvent): void;
2050
2205
  protected _setText(text: string, fullMatch: boolean, forceRevertInvalid?: boolean, clearTbxVal?: boolean): void;
2051
2206
  protected _updateBtn(): void;
2207
+ _updateBtnAria(): void;
2208
+ protected _updateTbx(): void;
2209
+ _updateTbxAria(): void;
2210
+ _updateTbxAriaHaspopup(): void;
2052
2211
  protected _createDropDown(): void;
2053
- protected _commitText(noFocus?: boolean): void;
2212
+ protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
2054
2213
  _updateDropDown(): void;
2055
2214
  }
2056
2215
  /**
@@ -2181,6 +2340,7 @@ export declare class Popup extends Control {
2181
2340
  static _SZ_MIN: number;
2182
2341
  static _evtHover: MouseEvent;
2183
2342
  protected _owner: HTMLElement;
2343
+ protected _ariaLabel: string;
2184
2344
  protected _modal: boolean;
2185
2345
  protected _position: PopupPosition;
2186
2346
  protected _showTrigger: PopupTrigger;
@@ -2222,6 +2382,8 @@ export declare class Popup extends Control {
2222
2382
  protected _oldFocus: HTMLElement;
2223
2383
  protected _myFocus: HTMLElement;
2224
2384
  protected _lastShow: number;
2385
+ protected _initialOwner: HTMLElement;
2386
+ protected _activeEdge: _Edges;
2225
2387
  /**
2226
2388
  * Initializes a new instance of the {@link Popup} class.
2227
2389
  *
@@ -2229,6 +2391,10 @@ export declare class Popup extends Control {
2229
2391
  * @param options JavaScript object containing initialization data for the control.
2230
2392
  */
2231
2393
  constructor(element: any, options?: any);
2394
+ /**
2395
+ * Gets or sets the aria-labelledby attribute of {@link Popup} input element.
2396
+ */
2397
+ ariaLabelledBy: string;
2232
2398
  /**
2233
2399
  * Gets or sets the element that owns this {@link Popup}.
2234
2400
  *
@@ -2645,6 +2811,8 @@ export declare class Popup extends Control {
2645
2811
  private _getClosestHeader;
2646
2812
  private _showBackdrop;
2647
2813
  protected _validateAndHide(result: any): void;
2814
+ protected _updateAriaLabel(): void;
2815
+ protected _updateAriaLabelImp(oldLabels: any): void;
2648
2816
  }
2649
2817
  /**
2650
2818
  * Provides arguments for the {@link Popup} control's {@link sizeChanging} and
@@ -2723,12 +2891,21 @@ export declare class InputDate extends DropDown {
2723
2891
  private _clsOnSel;
2724
2892
  private _handleWheel;
2725
2893
  private _preserveCalendarNavigation;
2726
- private _clicked;
2894
+ private _isTriggered;
2727
2895
  private _rangeChanged;
2728
2896
  private _textInitialized;
2729
2897
  private _previousText;
2730
2898
  private _keepInvalidText;
2899
+ private _showConfirmationButtons;
2900
+ protected _inputAriaLabel: any;
2731
2901
  protected _currentInput: string;
2902
+ static _ctrlTemplate: string;
2903
+ _ariaLabelledby: string;
2904
+ _keyActionTab: TabKeyAction;
2905
+ /**
2906
+ * Gets or sets the template used to instantiate {@link InputDate} control.
2907
+ */
2908
+ static controlTemplate: string;
2732
2909
  /**
2733
2910
  * Initializes a new instance of the {@link InputDate} class.
2734
2911
  *
@@ -3120,15 +3297,49 @@ export declare class InputDate extends DropDown {
3120
3297
  private _tryFocus;
3121
3298
  _clamp(value: Date): Date;
3122
3299
  protected _getText(): string;
3123
- protected _commitText(noFocus?: boolean): void;
3124
- protected _triggerInvalidInputEvent(cancelEvtArgs: InputDateEventArgs, val: Date, rangeEnd?: Date): void;
3125
- protected _nullValueInvalidInput(cancelEvtArgs: InputDateEventArgs): void;
3300
+ protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
3301
+ protected _triggerInvalidInputEvent(cancelEvtArgs: InputDateEventArgs, val: Date, rangeEnd?: Date, shouldInvalid?: boolean): void;
3302
+ protected _nullValueInvalidInput(cancelEvtArgs: InputDateEventArgs, shouldInvalid?: boolean): void;
3126
3303
  protected _fromDateTime(value: Date): Date;
3127
3304
  protected _canChangeValue(): boolean;
3128
3305
  protected _isValidDate(value: Date): boolean;
3129
3306
  private _getRanges;
3130
3307
  private _updateRangeSelection;
3131
3308
  protected _copy(key: string, value: any): boolean;
3309
+ /**
3310
+ * Gets or sets whether to display the confirmation buttons in Calendar.
3311
+ * When this property is set to true, using the arrow keys will only change the focus.
3312
+ * And "OK" and "Cancel" buttons will be displayed below the dropdown.
3313
+ */
3314
+ showConfirmationButtons: boolean;
3315
+ /**
3316
+ * Gets or sets the aria-labelledby attribute of input element.
3317
+ */
3318
+ ariaLabelledBy: string;
3319
+ protected _updateInputAriaLabel(): void;
3320
+ getAriaLabelForScreenReader(): any;
3321
+ /**
3322
+ * Gets or sets the action to perform when the TAB key is pressed.
3323
+ *
3324
+ * The default setting for this property is {@link TabKeyAction.CloseAndMoveFocus},
3325
+ * which provides standard form navigation behavior by:
3326
+ * - Closing the dropdown (if open)
3327
+ * - Moving focus to the next focusable element
3328
+ *
3329
+ * For specialized cases, you can set this to {@link TabKeyAction.CloseAndKeepFocus}
3330
+ * to maintain focus on the control after closing the dropdown.
3331
+ *
3332
+ * This setting is particularly useful for controlling accessibility behavior
3333
+ * and keyboard navigation flow in form controls.
3334
+ *
3335
+ * Example:
3336
+ * ```typescript
3337
+ * // Change TAB key behavior
3338
+ * inputDate.keyActionTab = TabKeyAction.CloseAndMoveFocus;
3339
+ * ```
3340
+ */
3341
+ keyActionTab: TabKeyAction;
3342
+ _shouldRaiseInvalidInput(shouldInvalid: boolean): boolean;
3132
3343
  }
3133
3344
  /**
3134
3345
  * The {@link InputDateRange} control extends the {@link InputDate}
@@ -3144,6 +3355,12 @@ export declare class InputDate extends DropDown {
3144
3355
  * ranges that users can select from.
3145
3356
  */
3146
3357
  export declare class InputDateRange extends InputDate {
3358
+ static _ctrlTemplate: string;
3359
+ protected _inputAriaLabel: any;
3360
+ /**
3361
+ * Gets or sets the template used to instantiate {@link InputDateRange} control.
3362
+ */
3363
+ static controlTemplate: string;
3147
3364
  /**
3148
3365
  * Initializes a new instance of the {@link InputDateRange} class.
3149
3366
  *
@@ -3170,6 +3387,11 @@ export declare class InputColor extends DropDown {
3170
3387
  private _colorPicker;
3171
3388
  private _value;
3172
3389
  private _textInitialized;
3390
+ static _ctrlTemplate: string;
3391
+ /**
3392
+ * Gets or sets the template used to instantiate {@link InputColor} control.
3393
+ */
3394
+ static controlTemplate: string;
3173
3395
  /**
3174
3396
  * Initializes a new instance of the {@link InputColor} class.
3175
3397
  *
@@ -3239,6 +3461,7 @@ export declare class InputColor extends DropDown {
3239
3461
  protected _keydown(e: KeyboardEvent): void;
3240
3462
  protected _commitText(): void;
3241
3463
  protected _copy(key: string, value: any): boolean;
3464
+ getAriaLabelForScreenReader(): any;
3242
3465
  }
3243
3466
  /**
3244
3467
  * The {@link ComboBox} control allows users to pick strings from lists.
@@ -3291,6 +3514,16 @@ export declare class ComboBox<T = any> extends DropDown {
3291
3514
  _restoreComboboxTbxVal: boolean;
3292
3515
  _isWheel: boolean;
3293
3516
  _selItems: any;
3517
+ _oldFilter: any;
3518
+ static _ctrlTemplate: string;
3519
+ _keyActionTab: TabKeyAction;
3520
+ _keyActionPrintCharacters: KeyAction;
3521
+ _inputElementAriaLabel: string;
3522
+ _ariaLabelledby: string;
3523
+ /**
3524
+ * Gets or sets the template used to instantiate {@link ComboBox} control.
3525
+ */
3526
+ static controlTemplate: string;
3294
3527
  /**
3295
3528
  * Initializes a new instance of the {@link ComboBox} class.
3296
3529
  *
@@ -3476,6 +3709,44 @@ export declare class ComboBox<T = any> extends DropDown {
3476
3709
  * means the drop-down has no maximum width limit.
3477
3710
  */
3478
3711
  maxDropDownWidth: number;
3712
+ /**
3713
+ * Gets or sets the action to perform when printable character keys are pressed (letters, numbers, symbols).
3714
+ *
3715
+ * The default setting for this property is {@link KeyAction.OpenDropdown},
3716
+ * which opens the listbox and filters options as the user types.
3717
+ * This allows users to see matching options before making a selection.
3718
+ *
3719
+ * Alternatively, you can set this to {@link KeyAction.ChangeSelectionOnly}
3720
+ * to immediately change the selection to match the typed characters while keeping the listbox closed.
3721
+ * This is useful for quick selection in known-value scenarios.
3722
+ */
3723
+ keyActionPrintCharacters: KeyAction;
3724
+ /**
3725
+ * Gets or sets the action to perform when the TAB key is pressed.
3726
+ *
3727
+ * The default setting for this property is {@link TabKeyAction.CloseAndMoveFocus},
3728
+ * which provides standard form navigation behavior by:
3729
+ * - Closing the dropdown (if open)
3730
+ * - Moving focus to the next focusable element
3731
+ *
3732
+ * For specialized cases, you can set this to {@link TabKeyAction.CloseAndKeepFocus}
3733
+ * to maintain focus on the control after closing the dropdown.
3734
+ *
3735
+ * This setting is particularly useful for controlling accessibility behavior
3736
+ * and keyboard navigation flow in form controls.
3737
+ *
3738
+ * Example:
3739
+ * ```typescript
3740
+ * // Change TAB key behavior
3741
+ * comboBox.keyActionTab = TabKeyAction.CloseAndMoveFocus;
3742
+ * ```
3743
+ */
3744
+ keyActionTab: TabKeyAction;
3745
+ /**
3746
+ * Gets or sets the aria-labelledby attribute of input element.
3747
+ */
3748
+ ariaLabelledBy: string;
3749
+ _updateInputAndListBoxAriaLabel(): void;
3479
3750
  /**
3480
3751
  * Gets the string displayed in the input element for the item at a
3481
3752
  * given index (always plain text).
@@ -3484,6 +3755,8 @@ export declare class ComboBox<T = any> extends DropDown {
3484
3755
  * @param trimText Optionally override the value of the {@link trimText} property.
3485
3756
  */
3486
3757
  getDisplayText(index?: number, trimText?: boolean): string;
3758
+ _getDisplayText(index?: number, trimText?: boolean, ignoreItemFormatter?: boolean): string;
3759
+ _hasCustomFormatItem(): boolean;
3487
3760
  /**
3488
3761
  * Gets the index of the first item that matches a given string.
3489
3762
  *
@@ -3520,18 +3793,31 @@ export declare class ComboBox<T = any> extends DropDown {
3520
3793
  protected _setIsDisabled(value: boolean): void;
3521
3794
  protected _updateBtn(): void;
3522
3795
  protected _hasItems(): boolean;
3523
- private _updateAria;
3796
+ _updateTbxAria(): void;
3797
+ _updateInputAriaLabel(): void;
3524
3798
  protected _createDropDown(): void;
3525
3799
  protected _wheel(e: WheelEvent): void;
3526
3800
  protected _dropDownClick(e: MouseEvent): void;
3527
3801
  protected _setText(text: string, fullMatch: boolean, isDateTime?: boolean): void;
3528
3802
  protected _findNext(search: string, step: number, start?: number): number;
3803
+ _findNextWhenIsEditableFalse(search: string, step: number, start?: number): number;
3529
3804
  protected _keydown(e: KeyboardEvent): void;
3530
- protected _input(e: Event): void;
3805
+ _afterOpenDropdownByDownArrow(): void;
3806
+ _input(e: Event): void;
3807
+ _handleDragTextState(): void;
3808
+ _handleComposingState(): void;
3809
+ _shouldOpenDropdown(): boolean;
3810
+ _handleIsEditableFalseInput(): void;
3811
+ _updateSelection(index: number, editStart: number): void;
3812
+ _updateComponentText(): void;
3813
+ _updateEmptyValueFlag(): void;
3814
+ _controlDropdownVisibility(): void;
3815
+ _resetDragState(): void;
3531
3816
  protected _updateInputSelection(start: number): void;
3532
3817
  private _getSelStart;
3533
3818
  private _getSelEnd;
3534
3819
  private _setSelRange;
3820
+ getAriaLabelForScreenReader(): any;
3535
3821
  }
3536
3822
  /**
3537
3823
  * Represents a method that returns a string used as a header for a
@@ -3580,6 +3866,12 @@ export declare class MultiSelect extends ComboBox {
3580
3866
  private _hdrFormatter;
3581
3867
  private _msLbx;
3582
3868
  static _DEF_CHECKED_PATH: string;
3869
+ static _ctrlTemplate: string;
3870
+ _inputElementAriaLabel: string;
3871
+ /**
3872
+ * Gets or sets the template used to instantiate {@link MultiSelect} control.
3873
+ */
3874
+ static controlTemplate: string;
3583
3875
  /**
3584
3876
  * Initializes a new instance of the {@link MultiSelect} class.
3585
3877
  *
@@ -3708,6 +4000,7 @@ export declare class MultiSelect extends ComboBox {
3708
4000
  protected _keydown(e: KeyboardEvent): void;
3709
4001
  protected _hasItems(): boolean;
3710
4002
  private _updateHeader;
4003
+ getAriaLabelForScreenReader(): any;
3711
4004
  }
3712
4005
  /**
3713
4006
  * Interface implemented by command objects.
@@ -3780,6 +4073,11 @@ export declare class Menu extends ComboBox {
3780
4073
  _ariaLabel: string;
3781
4074
  _aFEnabledItem: boolean;
3782
4075
  static _evtHover: MouseEvent;
4076
+ static _ctrlTemplate: string;
4077
+ /**
4078
+ * Gets or sets the template used to instantiate {@link Menu} control.
4079
+ */
4080
+ static controlTemplate: string;
3783
4081
  /**
3784
4082
  * Initializes a new instance of the {@link Menu} class.
3785
4083
  *
@@ -4035,6 +4333,12 @@ export declare class InputTime extends ComboBox {
4035
4333
  _format: string;
4036
4334
  _msk: _MaskProvider;
4037
4335
  _hasCustomItems: boolean;
4336
+ static _ctrlTemplate: string;
4337
+ _inputElementAriaLabel: string;
4338
+ /**
4339
+ * Gets or sets the template used to instantiate {@link InputTime} control.
4340
+ */
4341
+ static controlTemplate: string;
4038
4342
  /**
4039
4343
  * Initializes a new instance of the {@link InputTime} class.
4040
4344
  *
@@ -4144,6 +4448,8 @@ export declare class InputTime extends ComboBox {
4144
4448
  private _reselectText;
4145
4449
  protected _commitText(): void;
4146
4450
  protected _copy(key: string, value: any): boolean;
4451
+ getAriaLabelForScreenReader(): any;
4452
+ _input(e: Event): void;
4147
4453
  }
4148
4454
  /**
4149
4455
  * The {@link InputDateTime} control extends the {@link InputDate} control to allows users
@@ -4171,6 +4477,7 @@ export declare class InputDateTime extends InputDate {
4171
4477
  private _ddDate;
4172
4478
  private _ddTime;
4173
4479
  static _ctrlTemplate: string;
4480
+ protected _inputAriaLabel: any;
4174
4481
  /**
4175
4482
  * Gets or sets the template used to instantiate {@link InputDateTime} controls.
4176
4483
  */
@@ -4238,7 +4545,7 @@ export declare class InputDateTime extends InputDate {
4238
4545
  protected _mouseWheel(e: WheelEvent): void;
4239
4546
  protected _keydown(e: KeyboardEvent): void;
4240
4547
  protected _updateDateTimeValue(step: number, specialChars: any, actualFormat: string): void;
4241
- protected _commitText(): void;
4548
+ protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
4242
4549
  }
4243
4550
  /**
4244
4551
  * Represents a method that returns data items asynchronously as the user types.
@@ -4293,6 +4600,12 @@ export declare class AutoComplete extends ComboBox {
4293
4600
  private _srchProps;
4294
4601
  private _oldSelectedIndex;
4295
4602
  _pendingSearchFn: any;
4603
+ static _ctrlTemplate: string;
4604
+ _inputElementAriaLabel: string;
4605
+ /**
4606
+ * Gets or sets the template used to instantiate {@link AutoComplete} control.
4607
+ */
4608
+ static controlTemplate: string;
4296
4609
  /**
4297
4610
  * Initializes a new instance of the {@link AutoComplete} class.
4298
4611
  *
@@ -4394,7 +4707,9 @@ export declare class AutoComplete extends ComboBox {
4394
4707
  * Raises the {@link selectedIndexChanged} event.
4395
4708
  */
4396
4709
  onSelectedIndexChanged(e?: EventArgs): void;
4710
+ _updateTbxAria(): void;
4397
4711
  _keydown(e: KeyboardEvent): void;
4712
+ _input(e: Event): void;
4398
4713
  private _isBlurInput;
4399
4714
  protected _commitText(noFocus?: boolean): void;
4400
4715
  _setText(text: string | null): void;
@@ -4409,6 +4724,8 @@ export declare class AutoComplete extends ComboBox {
4409
4724
  protected _formatListItem(sender: any, e: FormatItemEventArgs): void;
4410
4725
  private _enclosed;
4411
4726
  protected _wheel(e: WheelEvent): void;
4727
+ getAriaLabelForScreenReader(): any;
4728
+ _hasCustomFormatItem(): boolean;
4412
4729
  }
4413
4730
  /**
4414
4731
  * The {@link MultiAutoComplete} control allows users to pick items from lists
@@ -4428,6 +4745,12 @@ export declare class MultiAutoComplete extends AutoComplete {
4428
4745
  private _selPath;
4429
4746
  private _notAddItm;
4430
4747
  static _clsActive: string;
4748
+ static _ctrlTemplate: string;
4749
+ _inputElementAriaLabel: string;
4750
+ /**
4751
+ * Gets or sets the template used to instantiate {@link MultiAutoComplete} control.
4752
+ */
4753
+ static controlTemplate: string;
4431
4754
  /**
4432
4755
  * Initializes a new instance of the {@link MultiAutoComplete} class.
4433
4756
  *