@dhtmlx/grid 9.3.10 → 9.3.11

package/codebase/types/ts-combobox/sources/types.d.ts

@@ -29,6 +29,7 @@ export interface IComboboxConfig {
             [className: string]: (event: Event, id: Id) => void | boolean;
         };
     };
+    ariaLabel?: string;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */
     cellHeight?: number;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */

package/codebase/types/ts-grid/sources/Grid.d.ts

@@ -24,6 +24,7 @@ export declare class Grid extends View implements IGrid {
     protected _scroll: IScrollState;
     protected _events: IEventSystem<GridSystemEvents, ISystemEventHandlersMap>;
     protected _htmlEvents: any;
+    protected _tooltipFocusHandler: (e: Event) => void;
     protected _sortingStates: ISortingStates;
     protected _activeFilters: object;
     protected _dropManager: any;
@@ -36,6 +37,7 @@ export declare class Grid extends View implements IGrid {
     protected _colWidths: PrefixSums;
     protected _rowHeightsRebuild: boolean;
     private _observedEl;
+    private _liveRegion;
     private _filterData;
     private _hiddenFilters;
     private _commonSummary;
@@ -68,6 +70,17 @@ export declare class Grid extends View implements IGrid {
     editEnd(withoutSave?: boolean): void;
     getHeaderFilter(colId: Id): IHeaderFilter;
     getSummary(colId?: Id): ISummaryList;
+    /**
+     * Sends a message to the grid's polite live region, so a screen reader
+     * announces a status change that happened without moving focus.
+     */
+    announce(message: string): void;
+    /**
+     * The live region is kept as a sibling of the widget root, outside the
+     * `role="grid"` element: a `role="status"` node is not an allowed child of
+     * a grid, and the node must survive redraws, so it is not part of the vdom.
+     */
+    protected _getLiveRegion(): HTMLElement | null;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/suite/migration/ */
     getSortingState(): {
         dir?: TSortDir;

package/codebase/types/ts-grid/sources/ProGrid.d.ts

@@ -27,6 +27,7 @@ export declare class ProGrid implements IProGrid {
     history: IHistory;
     constructor(container: HTMLElement | string | null, config?: IProGridConfig);
     paint(): void;
+    announce(message: string): void;
     destructor(): void;
     expand(rowId: Id): void;
     collapse(rowId: Id): void;

package/codebase/types/ts-grid/sources/helpers/cells.d.ts

@@ -1,6 +1,7 @@
 import { ICell, ICol, IGrid, IRow, ISpan } from "./../types";
 import { Id } from "../../../ts-common/types";
 export declare function getWidth(columns: ICol[], colspan: number, index: number): number;
+export declare function getSourceCellIndex(currentIdx: number, minIdx: number, count: number): number;
 export declare function getSpanHeight(rows: IRow[], span: ISpan): number;
 export declare function getReducedColspan(columns: ICol[], colId: Id, colspan: number): number;
 export declare function getReducedRowspan(initialRows: IRow[], currRows: IRow[], rowIndex: number, span: ISpan): number;

package/codebase/types/ts-grid/sources/helpers/locale.d.ts

@@ -0,0 +1,10 @@
+export interface ILocaleParams {
+    [key: string]: string | number;
+}
+/**
+ * Returns a localized string by its key, substituting `{name}` placeholders.
+ *
+ * The locale object is read on every call, so `dhx.i18n.setLocale("grid", ...)`
+ * is picked up without rebuilding anything.
+ */
+export declare function getLocaleString(key: string, params?: ILocaleParams): string;

package/codebase/types/ts-grid/sources/locales/en.d.ts

@@ -3,5 +3,31 @@ declare const locale: {
     groupText: string;
     dropAreaTitle: string;
     dropAreaPlaceholder: string;
+    aria_sortedAscending: string;
+    aria_sortedDescending: string;
+    aria_filterApplied: string;
+    aria_filterCleared: string;
+    aria_rowsLoaded: string;
+    aria_valueOutOfRange: string;
+    aria_valueBelowMin: string;
+    aria_valueAboveMax: string;
+    aria_valueClamped: string;
+    aria_filter: string;
+    aria_filterByDate: string;
+    aria_sortBy: string;
+    aria_expandGroup: string;
+    aria_collapseGroup: string;
+    aria_expandRow: string;
+    aria_collapseRow: string;
+    aria_editContent: string;
+    aria_subRow: string;
+    aria_enterGrid: string;
+    aria_exitGrid: string;
+    aria_dragPanel: string;
+    aria_panelHeader: string;
+    aria_panelFooter: string;
+    aria_panelContent: string;
+    aria_draggableRows: string;
+    aria_rowId: string;
 };
 export default locale;

package/codebase/types/ts-grid/sources/modules/BlockSelection.d.ts

@@ -119,6 +119,5 @@ export declare class BlockSelection implements IBlockSelection {
     private _removeHandlers;
     private _getPageCoords;
     private _cellHandler;
-    private _getSourceCellIndex;
     private _paint;
 }

package/codebase/types/ts-grid/sources/types.d.ts

@@ -30,6 +30,7 @@ export interface IGrid {
     keyManager: IKeyManager;
     export: any;
     paint(): void;
+    announce(message: string): void;
     destructor(): void;
     setColumns(col: ICol[]): void;
     addRowCss(rowId: Id, css: string): void;
@@ -209,6 +210,7 @@ export interface IRendererConfig extends Required<IProGridConfig> {
     selection: any;
     dropManager: any;
     blockSelection: any;
+    range?: IRange;
     sort: ISortingStates;
     filterLocation?: string;
     content?: IContentList;
@@ -219,6 +221,7 @@ export interface IRendererConfig extends Required<IProGridConfig> {
     };
     $renderFrom?: RenderFrom;
     $isDragging?: boolean;
+    $rowIndexShift?: number;
     _events?: IEventSystem<GridSystemEvents>;
 }
 export declare enum GridEvents {
@@ -364,7 +367,8 @@ export declare enum GridSystemEvents {
     headerCellTouchMove = "headerCellTouchMove",
     headerCellTouchEnd = "headerCellTouchEnd",
     groupPanelItemTouchMove = "groupPanelItemTouchMove",
-    groupPanelItemItemTouchEnd = "groupPanelItemItemTouchEnd"
+    groupPanelItemItemTouchEnd = "groupPanelItemItemTouchEnd",
+    announce = "announce"
 }
 export interface ISystemEventHandlersMap {
     [key: string]: (...args: any[]) => any;
@@ -374,6 +378,7 @@ export interface ISystemEventHandlersMap {
     [GridSystemEvents.headerCellTouchEnd]: (cell: IHeader, col: ICol, event: TouchEvent) => void;
     [GridSystemEvents.groupPanelItemTouchMove]: (id: string, event: TouchEvent) => void;
     [GridSystemEvents.groupPanelItemItemTouchEnd]: (id: string, event: TouchEvent) => void;
+    [GridSystemEvents.announce]: (message: string) => void;
 }
 export interface ICol {
     id: Id;

package/codebase/types/ts-grid/sources/ui/cells.d.ts

@@ -1,5 +1,6 @@
 import { GridEvents, GridSystemEvents, ICoords, IGridConfig, IRendererConfig, ISpan, Split } from "../types";
 import { IDataCollection } from "../../../ts-data";
+import { Id } from "../../../ts-common/types";
 type mouseEvents = GridEvents.cellClick | GridEvents.cellMouseOver | GridEvents.cellMouseDown | GridEvents.cellDblClick | GridEvents.cellRightClick;
 type touchEvents = GridSystemEvents.cellTouchEnd | GridSystemEvents.cellTouchMove;
 declare function handleMouse(rowStart: number, colStart: number, conf: IRendererConfig, type: mouseEvents & touchEvents, e: any): void;
@@ -20,8 +21,8 @@ export declare function normalizeSpan(span: ISpan, config: IGridConfig, data: ID
     $renderFrom: any[];
     $rowsVisibility: number[];
     $colsVisibility: number[];
-    row: import("../../../ts-common/types").Id;
-    column: import("../../../ts-common/types").Id;
+    row: Id;
+    column: Id;
     rowspan?: number;
     colspan?: number;
     text?: string | ((args: import("../types").ISummaryList) => string);

package/codebase/types/ts-grid/sources/ui/common.d.ts

@@ -5,4 +5,11 @@ export declare function calcScrollBarWidth(config: IGridConfig | IRendererConfig
     height: number;
 }): IScrollBarWidth;
 export declare function getCurrFixedCols(config: IGridConfig, split: Split.left | Split.right): import("../types").ICol[];
+/**
+ * Number of header rows. `aria-rowindex` is a position within the whole grid,
+ * so header rows occupy the first indices and body rows are offset by this.
+ */
+export declare function getHeaderRowCount(config: IGridConfig | IRendererConfig): number;
+/** Number of footer rows; they are the last rows of the grid for `aria-rowcount`. */
+export declare function getFooterRowCount(config: IGridConfig | IRendererConfig): number;
 export declare function getNormalizeDateObject(item: string | Date, dateFormat: string): Date | null;

package/codebase/types/ts-grid/sources/ui/editors/InputEditor.d.ts

@@ -15,6 +15,9 @@ export declare class InputEditor implements IEditor {
     endEdit(withoutSave?: boolean): void;
     toHTML(value?: string | number): any;
     protected _initHandlers(): void;
+    private _setValidity;
+    private _isValueInvalid;
+    private _getRangeMessage;
     private _isValidWord;
     private _isCorrectRange;
     private _applyValuePattern;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dhtmlx/grid",
-  "version": "9.3.10",
+  "version": "9.3.11",
   "description": "DHTMLX Grid - JavaScript data grid library. GPL v2 edition for GPL-compatible open-source projects; commercial licenses are available for proprietary and production use.",
   "keywords": ["dhtmlx","grid","datagrid","table","treegrid","data-table","javascript","typescript"],
   "homepage":"https://docs.dhtmlx.com/suite/grid/",

package/whatsnew.txt

@@ -1,3 +1,31 @@
+# Version 9.3.11 (September 14, 2026)
+
+### Updates
+
+- Modal focus trapping and management:
+    - Implemented focus trapping for all modal windows, message dialogs, and popups compliant with **WCAG 2.4.3**.
+    - Opening a modal dialog moves keyboard focus to the first actionable element and keeps it within the dialog boundaries until the dialog closes.
+    - Closing a dialog restores focus to the previously active cell or trigger element.
+
+- Assistive technology support for block selection:
+    - The Grid exposes the block selection state to screen readers (**WCAG 1.3.1**, **WCAG 4.1.2**).
+    - Selected cell boundaries and multi-cell ranges reflect their `aria-selected` status in the accessibility tree, providing real-time feedback during keyboard and pointer selection.
+
+- Localization for ARIA labels:
+    - Moved all hardcoded English accessible names and labels into the locale system.
+    - Screen reader announcements, button descriptions, and status labels that developers can translate via the standard localization configuration.
+
+- Target size improvements for interactive controls:
+    - Enlarged hit areas for small interactive elements, including column resize handles and removal/action icons.
+    - Reduced accidental or missed clicks on touch-screen devices, accommodating users with motor precision needs.
+
+### Fixes
+
+- Fixed a console error that occurred when starting block selection in numeric columns or number-formatted cell ranges
+- Fixed broken `aria-labelledby` relationships in sub-rows, eliminating orphaned ID references
+- Corrected invalid ARIA attributes and roles, and fixed the `aria-rowindex` and `aria-rowcount` calculations so that they reflect the overall grid structure, including header rows
+- Fixed an issue where inline cell editors lost or failed to expose their accessible names on the first paint and on subsequent data updates
+
 # Version 9.3.10 (August 19, 2026)
 
 ### Fixes