@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/COMMERCIAL-LICENSE.pdf +0 -0
- package/es2015-commonjs.js +2 -2
- package/es2015-esm.js +2 -2
- package/es5-esm.js +2 -2
- package/index.d.ts +338 -15
- package/index.js +2 -2
- package/package.json +2 -2
- package/COMMERCIAL-LICENSE.html +0 -471
package/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/*!
|
|
2
2
|
*
|
|
3
|
-
* Wijmo Library 5.
|
|
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
|
|
1087
|
-
_selectPrev
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
*
|