| Ctrl (Cmd) + Enter | -stops cell’s editing, leaves selection on the cell | +stops cell's editing, leaves selection on the cell |
| F2 | @@ -28,6 +36,10 @@ Here is a list of hotkeys that you can use while working with DHTMLX SpreadsheetEsc | closes editor in a cell without saving changes |
| Alt (Option) + Enter | +opens the link of the active cell in a new tab | +
| Ctrl + F6 | +moves the focus to the next part of the Spreadsheet in the order: the menu, the toolbar, the sheet (the active cell), the sheet tabs, and then back to the menu. The formula bar and hidden parts are skipped. Saves the value of the edited cell first | +
| Ctrl + Shift + F6 | +moves the focus to the previous part of the Spreadsheet | +
| Left Arrow/Right Arrow Key | +moves the focus to the previous/next control of the toolbar, the menu bar or the sheet tabs | +
| Home/End | +moves the focus to the first/last control of the bar | +
| Enter/Space | +presses the focused control: runs the command, opens the dropdown, or switches to the sheet of the focused tab | +
| Down Arrow Key | +opens the dropdown of the focused control and moves the focus to its first item | +
| Up Arrow/Down Arrow Key | +moves the focus between the items of an open dropdown or menu | +
| Right Arrow Key | +opens the submenu of the focused menu item | +
| Left Arrow Key | +closes the submenu. In the first level of a dropdown, closes the dropdown and returns the focus to its control | +
| Esc | +closes the dropdown or the menu and returns the focus to the control that opened it. Closes the tooltip of a toolbar control. Without Esc, the tooltip stays open while the pointer is over it | +
| Shift + F10 or Menu key | +opens the context menu of the active cell or of the focused sheet tab and moves the focus into it. After Ctrl (Cmd) + Space, the context menu of a cell shows the commands for the column. Esc closes the context menu and returns the focus to the cell | +
| Ctrl (Cmd) + G | -moves selection to the next found match | +highlights the next found match |
| Ctrl (Cmd) + Shift + G | -moves selection to the previous found match | +highlights the previous found match | +
| Esc | +closes the search box and returns the focus to the active cell |
| Ctrl (Cmd) + Shift + 9 | +shows the hidden rows inside the selected range | +
| Ctrl (Cmd) + Shift + 0 | +shows the hidden columns inside the selected range | +
| Arrow keys | +move the focus between the colors of the palette or between the controls of the Border popup | +
| Home/End | +moves the focus to the first/last color of the palette | +
| Enter | +applies the focused color or border. After a text or background color is applied, the focus returns to the active cell | +
| Esc | +returns from the custom color mode to the palette. In a color or style popup opened over the Border popup, closes it and returns the focus to its button in the Border popup. Otherwise, closes the popup and returns the focus to its toolbar control | +
| Tab/Tab + Shift | +closes the popup and returns the focus to its toolbar control. In the Border popup and the popups opened over it, closes them all and returns the focus to the Border control. In the custom color mode, moves the focus between the controls of the color picker | +
| Up Arrow/Down Arrow Key | +moves through the list of values | +
| Enter | +chooses the value and closes the editor | +
| Esc | +closes the editor without saving changes | +
| Tab | +saves the value and moves selection one cell right | +
| Esc | +closes the filter popup and returns the focus to the cell | +
| Enter | +applies the size in the Column width and Row height dialogs | +
| Esc | +closes the Column width and Row height dialogs without changes |
Other content
~~~
- setting a theme to the container specified via an HTMLElement
~~~html
-
+
Other content
~~~
diff --git a/docs/using_typescript.md b/docs/using_typescript.md
index a665d927..5dd594f9 100644
--- a/docs/using_typescript.md
+++ b/docs/using_typescript.md
@@ -1,7 +1,7 @@
---
sidebar_label: TypeScript support
title: TypeScript support
-description: You can learn about using typescript with the DHTMLX JavaScript Spreadsheet library in the documentation. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Use the built-in TypeScript definitions of DHTMLX Spreadsheet for type checking, autocompletion and JSDoc hints in your IDE.
---
# TypeScript support
diff --git a/docs/vuejs_integration.md b/docs/vuejs_integration.md
index 978173c7..6e630880 100644
--- a/docs/vuejs_integration.md
+++ b/docs/vuejs_integration.md
@@ -1,7 +1,7 @@
---
sidebar_label: Integration with Vue
title: Vue Integration
-description: You can learn about the Vue integration of the DHTMLX JavaScript Spreadsheet library in the documentation. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Use DHTMLX Spreadsheet in a Vue application. Create a project, add Spreadsheet as a Vue component, load data and handle events.
---
# Integration with Vue
@@ -260,6 +260,10 @@ export default {
//...
~~~
+:::info
+The `destructor()` method removes the event handlers attached with `spreadsheet.events.on()`. When a new Spreadsheet instance is created, for example, when the component is created again, attach the handlers to the new instance.
+:::
+
After that, you can start the app to see Spreadsheet loaded with data on a page.
diff --git a/docs/whats_new.md b/docs/whats_new.md
index 9afbf47e..3ac591ce 100644
--- a/docs/whats_new.md
+++ b/docs/whats_new.md
@@ -1,13 +1,78 @@
---
sidebar_label: What's new
title: What's new in DHTMLX Spreadsheet
-description: You can learn what's new in the DHTMLX JavaScript Spreadsheet library in the documentation. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Release notes of DHTMLX Spreadsheet with the new functionality, updates, fixes and breaking changes of each version.
---
# What's new
If you are updating Spreadsheet from an older version, check [Migration to Newer Version](migration.md) for details.
+## Version 6.0.4
+
+Released on November 2, 2026
+
+### New functionality
+
+- Accessibility support that targets WCAG 2.2 AA, Section 508 and EN 301 549: keyboard operation of every part of the Spreadsheet, screen reader support and a visible focus in every theme. Check the [Accessibility](accessibility.md) guide and the [Accessibility Conformance Report](accessibility_conformance_report.md)
+- The ability to turn the selection of cells off and on:
+ - new configuration property: [`selection`](api/spreadsheet_selection_config.md)
+ - new methods of the selection module: [`enable()`](api/selection_enable_method.md), [`disable()`](api/selection_disable_method.md), [`isDisabled()`](api/selection_isdisabled_method.md)
+- The [`announce()`](api/spreadsheet_announce_method.md) method sends a status message to screen readers
+- New commands of the [context menu](customization.md#context-menu): [*Column width*, *Row height*](work_with_rows_cols.md#setting-column-width-and-row-height) and [*Open filter*](filtering_data.md#opening-a-filter-with-the-keyboard)
+
+### Updates
+
+- Keyboard navigation (check the [Hot keys list](hotkeys.md)):
+ - the focus stays on the active cell, `Tab` and `Shift + Tab` leave the cells from the last and the first cell of the sheet, and `Ctrl + F6` moves the focus between the menu, the toolbar, the sheet and the sheet tabs
+ - the toolbar, the menu bar and the sheet tabs are single tab stops navigated with the arrow keys
+ - new shortcuts are added, for example, `Shift + F10` for the context menu and `Ctrl (Cmd) + Shift + 9` / `Ctrl (Cmd) + Shift + 0` for showing hidden rows and columns
+ - the toolbar color and border popups take the focus when they open and close with `Esc` and `Tab`
+- The arrow keys stop at the first and last visible row and column instead of moving to the opposite edge, and an arrow key at the edge reduces a selected range to the active cell
+- Text composed with an input method editor (IME) is shown in the active cell and starts the edit through the [`startEdit()`](api/spreadsheet_startedit_method.md) method, so the `beforeEditStart` and `afterEditStart` events fire for it
+- The [`setFocusedCell()`](api/selection_setfocusedcell_method.md) method moves the keyboard focus to the cell
+- A [link in a cell](work_with_cells.md#inserting-a-hyperlink-into-a-cell) is rendered as a real link that opens in a new tab, and `Alt (Option) + Enter` opens the link of the active cell
+- The [read-only mode](api/spreadsheet_readonly_config.md) keeps the keyboard navigation, the selection, copying and search, and screen readers announce the refused edits. To turn the selection off, use the `selection: false` option
+- [Removing a row or a column through a merged cell](merge_cells.md#removing-rows-and-columns-of-merged-cells) removes all the rows or columns of the merged cell
+- New interface and screen reader strings in the [`spreadsheet` locale](localization.md#default-locale), and [translation of the built-in widgets](localization.md#localizing-built-in-widgets)
+- The [`--dhx-spreadsheet-focus-color`](/themes/#spreadsheet-specific-styles) variable for the keyboard focus, and the formula reference colors with a higher contrast in the light themes
+
+### Fixes
+
+- A merged cell was dropped instead of shifted when a row or column before it was deleted. Now a merged cell left with a single cell becomes an ordinary cell and keeps its value
+- Deleting a row or column through a merged cell removed only one line of the merge
+- The context menu labels for removing rows and columns didn't show all the rows or columns of a merged cell that would be removed
+- Rows were not deleted when they covered the whole filtered range
+- The frozen area didn't shrink when frozen rows or columns were deleted
+- Autofill threw an error when the dragged cells held no plain number
+- The page froze on `Home`, `End`, `Ctrl (Cmd) + Home`, `Ctrl (Cmd) + End` and `Ctrl (Cmd) + Arrow` keys when the first or last row or column was hidden
+- The font size was lost when cells were copied to Excel or pasted from Excel or within the Spreadsheet
+- The invalid-value tooltip appeared away from the invalid cell or wasn't shown
+- `Esc` and `Tab` didn't work in the list editor after the arrow keys were used
+- The search highlighted the second match first and didn't refresh the results after an edit or a sheet switch
+- A script error occurred on import or export in a browser without WebAssembly
+- Document listeners and inner widgets were left behind after `destructor()`
+- The keyboard focus was lost after the search bar closed
+- A closed context menu reopened
+- The active cell was scrolled one cell short of the viewport edge during keyboard navigation
+- A formula with an invalid reference showed a broken or repeated `#REF!` error instead of a single `#REF!`
+
+### React Spreadsheet
+
+React Spreadsheet includes all the Spreadsheet updates and fixes listed above. The changes below are specific to the React wrapper.
+
+#### Updates
+
+- The new [`selection`](react/props.md#runtime-props) prop
+- The [`ISelection`](react/types.md#re-exported-upstream-types) type is re-exported
+- [`readonly`](react/props.md#init-only-props) is an init-only prop
+
+#### Fixes
+
+- The event callbacks and `onStateChange` didn't fire after the Spreadsheet was recreated by an init-only prop change
+- The event handlers of the wrapper were not removed on unmount
+- The data from `loadUrl` was loaded twice on mount and again over the kept data after the Spreadsheet was recreated
+
## Version 6.0.3
Released on August 24, 2026
diff --git a/docs/work_with_cells.md b/docs/work_with_cells.md
index a922c78d..bd5cf3b3 100644
--- a/docs/work_with_cells.md
+++ b/docs/work_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: Editing cells
title: Editing cells
-description: You can learn about the work with cells in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Edit cells in DHTMLX Spreadsheet. Enter content, insert hyperlinks, use drop-down lists, fill several cells, copy cells to and from Excel and lock cells.
---
# Editing cells
@@ -138,21 +138,34 @@ You can automatically fill cells with data. This is how it works:
- copying the value
-For example, to make a series 4,4,4,4..., type 4 in the first cell only.
+For example, to make a series 4,4,4,4..., type 4 in the first cell only.
- following the pattern
- to make a series 1, 2, 3, 4, 5, ... , type 1 and 2 into the first two cells.
- to make a series 1 ,3, 5, 7, 9, ... , type 1 and 3 into the first two cells.
- to make a series 2 ,4, 6, 8, 10, ... , type 2 and 4 into the first two cells.
- besides numbers, you can also use letters in a pattern, for example, to make a series like 1, a, 2, b, 3, a, 4, b, ..., type 1, a, 2, b into the first four cells.
+ - to continue a number at the end of a text, type the first values, for example, to make a series item1, item2, item3, ..., type item1 and item2 into the first two cells.
+ - to make a series of dates, type a date into the first cell: each next cell gets the next day.
+- repeating the text
+
+For example, to make a series North, South, North, South, ..., type North and South into the first two cells. Numbers in the cells with the *Text* format are repeated in the same way.
3\. Drag the **Fill Handle**
+## Copying cells to and from Excel
+
+You can copy cells with **Ctrl (Cmd) + C** and paste them with **Ctrl (Cmd) + V** within the Spreadsheet and between the Spreadsheet and Microsoft Excel:
+
+- within the Spreadsheet, the cells keep their values, formulas, styles, number formats and links. The cell references in the formulas are shifted to the new position
+- in Excel, the pasted cells get the values (the results of the formulas, not the formulas), the styles (including the font size), merged cells and links. The rows hidden by a filter are skipped
+- cells copied from Excel keep their values, styles (including the font size), number formats, merged cells and links when you paste them into the Spreadsheet
+
## Locking cells
-You can lock cells to protect their values from changes. When you lock a cell, it shows a gray "key" in the top right corner. Locked cells do not respond to any attempts to edit them.
+You can lock cells to protect their values from changes. When you lock a cell, it shows a gray "key" in the top right corner. Locked cells do not respond to any attempts to edit them. Screen readers announce the refused edit: "The cell is locked" for a single cell, or "Locked cells were not changed" when the selected range holds locked cells.
diff --git a/docs/work_with_rows_cols.md b/docs/work_with_rows_cols.md
index caf55eb7..7b36492d 100644
--- a/docs/work_with_rows_cols.md
+++ b/docs/work_with_rows_cols.md
@@ -1,7 +1,7 @@
---
sidebar_label: Work with rows and columns
title: Work with rows and columns
-description: You can learn about how to work with rows and columns in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Work with rows and columns in DHTMLX Spreadsheet. Add and remove them, autofit and set the column width and row height, freeze, hide and show them.
---
# Work with rows and columns
@@ -54,6 +54,10 @@ To remove a row, take the following steps:
To remove several rows at once: select the rows, right-click to call the context menu and choose *Rows -> Remove rows [ids]*.
:::
+:::info
+If the selected cell is inside a merged cell, all the rows of the merged cell are removed. Check the [Merging cells](merge_cells.md#removing-rows-and-columns-of-merged-cells) article for details.
+:::
+
### Adding columns
To add a new column, take the following steps:
@@ -98,6 +102,10 @@ To remove a column, take the following steps:
To remove several columns at once: select the columns, right-click to call the context menu and choose *Columns -> Remove columns [ids]*.
:::
+:::info
+If the selected cell is inside a merged cell, all the columns of the merged cell are removed. Check the [Merging cells](merge_cells.md#removing-rows-and-columns-of-merged-cells) article for details.
+:::
+
## AutoFit column width
To change the column width so that it would automatically fit the longest content in the column, you can:
@@ -116,6 +124,50 @@ To change the column width so that it would automatically fit the longest conten
+## Setting column width and row height
+
+### Setting column width
+
+To set an exact width of columns, take the following steps:
+
+1\. Select a column or a cell in the column. To change several columns, select a range of cells that spans them.
+
+2\. Right-click the selection, or press `Shift + F10` or the Menu key, and choose *Columns -> Column width*. The same command is available in the menu of the 3 dots icon of the column.
+
+
+
+3\. In the *Column width* dialog, enter the width in pixels and click **Apply** or press `Enter`.
+
+
+
+### Setting row height
+
+To set an exact height of rows, take the following steps:
+
+1\. Select a row or a cell in the row. To change several rows, select a range of cells that spans them.
+
+2\. Right-click the selection, or press `Shift + F10` or the Menu key, and choose *Rows -> Row height*.
+
+
+
+3\. In the *Row height* dialog, enter the height in pixels and click **Apply** or press `Enter`.
+
+
+
+### How the new size is applied
+
+The dialog shows the current size of the first column or row of the selected range and applies the new size to every column or row of this range. If several ranges are selected, the last selected range is used.
+
+The size is rounded to whole pixels. The minimum width of a column is 20 px, and the minimum height of a row is 10 px: a smaller positive value is replaced with the minimum. While the field is empty or the value isn't a positive number, the **Apply** button is disabled.
+
+The **Cancel** button or `Esc` closes the dialog without changes. Screen readers announce the new size, for example, "Column width set to 120 pixels".
+
+### Undoing the change
+
+The new size can be undone with `Ctrl (Cmd) + Z`.
+
+To handle the change in code, use the `resizeCol` and `resizeRow` [actions](api/overview/actions_overview.md#list-of-actions).
+
## Freezing/unfreezing rows and columns
### Freezing rows
@@ -212,6 +264,10 @@ To hide a row, take the following steps:
+:::info
+If the active cell is in a row that becomes hidden, the active cell moves to the first visible row below it, and the selection is reduced to this cell. If there are no visible rows below, it moves to the last visible row above.
+:::
+
### Showing rows
To show hidden rows, take one of the following steps:
@@ -228,6 +284,8 @@ To show hidden rows, take one of the following steps:
+- or select rows or several cells so that the hidden rows were included into the selection, and press `Ctrl (Cmd) + Shift + 9`. For example, select rows 2-4 to show the hidden row 3. If the selection includes no hidden rows, screen readers announce "No hidden rows in the selection"
+
### Hiding columns
To hide a column, take the following steps:
@@ -244,6 +302,10 @@ To hide a column, take the following steps:
+:::info
+If the active cell is in a column that becomes hidden, the active cell moves to the first visible column on the right of it, and the selection is reduced to this cell. If there are no visible columns on the right, it moves to the last visible column on the left.
+:::
+
### Showing columns
To show hidden columns, take one of the following steps:
@@ -260,4 +322,4 @@ To show hidden columns, take one of the following steps:
-
+- or select columns or several cells so that the hidden columns were included into the selection, and press `Ctrl (Cmd) + Shift + 0`. If the selection includes no hidden columns, screen readers announce "No hidden columns in the selection"
diff --git a/docs/work_with_sheets.md b/docs/work_with_sheets.md
index d864f25d..90410bc8 100644
--- a/docs/work_with_sheets.md
+++ b/docs/work_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: Work with sheets
title: Work with Sheets
-description: You can learn about the work with sheets in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Add, remove, rename and switch sheets in DHTMLX Spreadsheet with the bottom toolbar and the sheet tabs, and refer to cells of other sheets in formulas.
---
# Work with sheets
diff --git a/docs/working_with_cells.md b/docs/working_with_cells.md
index b92c6f2f..595cc394 100644
--- a/docs/working_with_cells.md
+++ b/docs/working_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: Work with cells
title: Work with cells
-description: You can learn about working with cells in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Set and get cell values and styles, validate cells, insert links, and edit, lock, merge and select cells in DHTMLX Spreadsheet with the API.
---
# Work with cells
diff --git a/docs/working_with_sheets.md b/docs/working_with_sheets.md
index 05897d9c..316e9544 100644
--- a/docs/working_with_sheets.md
+++ b/docs/working_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: Work with sheets
title: Working with Sheets
-description: You can learn about working with sheets in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Load multiple sheets into DHTMLX Spreadsheet, and add, remove, get, clear and switch sheets with the API methods.
---
# Work with sheets
diff --git a/docs/working_with_ssheet.md b/docs/working_with_ssheet.md
index 008830a6..83b7d7f8 100644
--- a/docs/working_with_ssheet.md
+++ b/docs/working_with_ssheet.md
@@ -1,7 +1,7 @@
---
sidebar_label: Work with Spreadsheet
title: Working with Spreadsheet
-description: You can learn about working with spreadsheet in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+description: Undo and redo actions, add, remove, freeze and hide rows and columns, autofit column width, filter, search and sort data, and clear DHTMLX Spreadsheet with the API.
---
# Work with Spreadsheet
@@ -282,7 +282,7 @@ From v4.3, you can sort data in the spreadsheet with the [`sortCells()`](api/spr
- `dir` - the sorting direction: 1 - ascending sort order, -1 - descending sort order
~~~jsx {5}
-const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// config parameters
});
diff --git a/i18n/de/docusaurus-plugin-content-docs/current.json b/i18n/de/docusaurus-plugin-content-docs/current.json
index fdeac066..e32ca3e6 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current.json
+++ b/i18n/de/docusaurus-plugin-content-docs/current.json
@@ -83,6 +83,10 @@
"message": "Arbeit mit Zellen",
"description": "The generated-index page title for category 'Work with cells' in sidebar 'docs'"
},
+ "sidebar.docs.category.Accessibility": {
+ "message": "Barrierefreiheit",
+ "description": "The label for category 'Accessibility' in sidebar 'docs'"
+ },
"sidebar.docs.category.Frameworks & integrations": {
"message": "Frameworks und Integrationen",
"description": "The label for category 'Frameworks & integrations' in sidebar 'docs'"
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/.sync b/i18n/de/docusaurus-plugin-content-docs/current/.sync
index 96f6c508..0532604c 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/de/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-2b6d3c2fd433461ffce34526974de3f1ba5161a8
+9ff2cef64e00d4e77947433a670dc5d573fcc7f4
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/accessibility.md b/i18n/de/docusaurus-plugin-content-docs/current/accessibility.md
new file mode 100644
index 00000000..d057e6fb
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/current/accessibility.md
@@ -0,0 +1,449 @@
+---
+sidebar_label: Barrierefreiheit
+title: Barrierefreiheit
+description: Machen Sie DHTMLX Spreadsheet für Tastatur- und Screenreader-Nutzer zugänglich. Erfahren Sie mehr über WAI-ARIA-Unterstützung, Tastaturnavigation, Screenreader-Ansagen und Themes mit hohem Kontrast, die auf WCAG 2.2 AA ausgerichtet sind.
+---
+
+# Barrierefreiheit in DHTMLX Spreadsheet
+
+Dieser Leitfaden richtet sich an Entwickler, die DHTMLX Spreadsheet in eine Anwendung einbetten, die Anforderungen an die Barrierefreiheit erfüllen muss. Anhand des Leitfadens können Sie die Komponente mit Ihrer Checkliste abgleichen und für Nutzer von Tastatur, Screenreader und hohem Kontrast konfigurieren.
+
+Das Spreadsheet rendert WAI-ARIA-Rollen und -Zustände als Teil seines Markups. Der Tastaturfokus bleibt auf der aktiven Zelle, und die Symbolleiste, die Menüleiste und die Blattregisterkarten bilden jeweils einen einzigen Tabstopp. Änderungen, die kein eigenes Element haben, etwa eine abgelehnte Bearbeitung oder ein Suchergebnis, werden an eine Live-Region gesendet, die Screenreader vorlesen.
+
+:::info Ziel-Konformität
+DHTMLX Spreadsheet ist darauf ausgelegt, **WCAG 2.2 Level AA**, **Section 508** des U.S. Rehabilitation Act und **EN 301 549** (die technische Grundlage des European Accessibility Act) zu erfüllen.
+
+Die Konformität wird für DHTMLX Spreadsheet 6.0.4 Kriterium für Kriterium dokumentiert. Der ausführliche **Accessibility Conformance Report (VPAT® 2.5)** ist verfügbar: [Accessibility Conformance Report](accessibility_conformance_report.md).
+:::
+
+## Funktionen {#capabilities}
+
+| Bereich | Unterstützung |
+| ---- | ------- |
+| Tastaturbedienung | Jeder Befehl für die Zellen hat eine Taste. Die Symbolleiste, die Menüleiste und die Blattregisterkarten sind einzelne Tabstopps, die mit den Pfeiltasten navigiert werden. Spaltenbreite, Zeilenhöhe und Spaltenfilter haben Kontextmenübefehle, sodass weder Ziehen noch ein Klick auf ein Symbol erforderlich ist |
+| WAI-ARIA-Semantik | Die Zellen sind ein `grid` mit den Elementen `columnheader`, `rowheader` und `gridcell`. Die Rollen werden immer gerendert |
+| Fokusmodell | Der Tastaturfokus liegt auf der aktiven Zelle. Tab betritt das Blatt auf der aktiven Zelle und verlässt es von der letzten bzw. der ersten Zelle aus. Ctrl + F6 verschiebt den Fokus zwischen dem Menü, der Symbolleiste, dem Blatt und den Blattregisterkarten |
+| Auswahlmodell | Die aktive Zelle, ein Bereich und mehrere Bereiche werden über `aria-selected` bereitgestellt, und die Ausdehnung eines Bereichs wird angesagt. Die Auswahl lässt sich mit der Option [`selection`](api/spreadsheet_selection_config.md) deaktivieren |
+| Schreibgeschützter Modus | Das Blatt kann navigiert, ausgewählt, kopiert und durchsucht werden; Bearbeitungen werden abgelehnt und angesagt, und das Kontextmenü ist nicht verfügbar |
+| Screenreader | Getestet mit NVDA, JAWS und VoiceOver |
+| Visuelle Barrierefreiheit | Die Themes `contrast-light` und `contrast-dark`, ein sichtbarer Fokusindikator in jedem Theme sowie Hinweise, die nicht von der Farbe abhängen |
+| Textgröße und Zoom | Das Layout bleibt bei 200 % und 400 % Zoom sowie mit überschriebenen Textabständen bedienbar |
+| Anpassung | Die öffentliche Methode [`announce()`](api/spreadsheet_announce_method.md) für eigene Meldungen und übersetzbare `aria_*`-Locale-Strings für jeden integrierten Namen und jede integrierte Ansage |
+| Standards | WCAG 2.2 AA, Section 508, EN 301 549 |
+
+## Abgedeckte Bereiche {#covered-areas}
+
+Dieser Leitfaden behandelt das Spreadsheet-Widget:
+
+- die Zellen, die Spalten- und Zeilenköpfe, verbundene Zellen sowie fixierte Zeilen und Spalten
+- die Auswahl: die aktive Zelle, Bereiche und mehrere Bereiche
+- die Formelleiste und die Zelleneditoren, einschließlich des Editors einer Zelle mit einer Werteliste
+- die Symbolleiste mit ihren Farb- und Rahmen-Popups, die Menüleiste und die Kontextmenüs
+- die Blattregisterkarten
+- Sortierung, Filterung, Suche, Datenvalidierung, Links in Zellen, Import und Export
+- die Themes und den Fokusindikator
+
+Die Barrierefreiheit der fertigen Seite hängt auch von der Host-Anwendung ab. Siehe [Verantwortung der Host-Seite](#host-page-responsibilities).
+
+## WAI-ARIA-Unterstützung {#wai-aria-support}
+
+Das Spreadsheet fügt seinem Markup automatisch WAI-ARIA-Rollen und -Attribute hinzu, und Sie können diese nicht deaktivieren. Jeder Teil des Widgets hat eine eigene Rolle und einen eigenen Namen, und die Namen stammen aus der [Locale](#localization).
+
+### Spreadsheet-Container {#spreadsheet-container}
+
+Die Teile des Spreadsheets sind separate benannte Steuerelemente:
+
+| Teil | Rolle / Attribut | Zugänglicher Name |
+| ---- | ---------------- | --------------- |
+| Menüleiste | `role="menubar"` + `aria-label` | "Main" |
+| Symbolleiste | `role="toolbar"` + `aria-label` | "Formatting" |
+| Formelleiste | `aria-label` am Eingabefeld | "Formula bar, B7", mit der Adresse der aktiven Zelle |
+| Zellen | `role="grid"` + `aria-label` | "Spreadsheet" |
+| Blattregisterkarten | `role="toolbar"` + `aria-label` | "Sheets" |
+| Live-Region | `role="status"`, `aria-live="polite"`, `aria-atomic="true"` | visuell verborgen, neben dem Grid außerhalb von `role="grid"` platziert |
+
+Das Wurzelelement des Spreadsheets hat keine Landmark-Rolle, sodass Sie es in die Landmark platzieren können, die zu Ihrer Seite passt.
+
+### Zellenoberfläche {#cell-surface}
+
+Die folgenden Attribute beschreiben die Zellen als Ganzes. Das Element `.dhx_grid-content` trägt sie:
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| `.dhx_grid-content` | `role="grid"` | Das interaktive Grid der Zellen |
+| `.dhx_grid-content` | `aria-label` | "Spreadsheet", aus dem Locale-Schlüssel `aria_grid` |
+| `.dhx_grid-content` | `aria-rowcount` | Die Anzahl der Zeilen des Blatts plus die Kopfzeile |
+| `.dhx_grid-content` | `aria-colcount` | Die Anzahl der sichtbaren Spalten plus die Spalte der Zeilennummern |
+| `.dhx_grid-content` | `aria-readonly` | `"true"` im [schreibgeschützten Modus](api/spreadsheet_readonly_config.md) und solange die [Auswahl](api/spreadsheet_selection_config.md) deaktiviert ist |
+| `.dhx_grid-content` | `aria-multiselectable` | `"true"`; `"false"`, solange die Auswahl deaktiviert ist |
+
+### Zeilen und Zellen {#rows-and-cells}
+
+Die folgende Tabelle listet die Rollen sowie die Positions- und Zustandsattribute der Zeilen und Zellen auf:
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| Zeile | `role="row"` + `aria-rowindex` | Eine Zeile des Blatts. Zeile 1 des Blatts hat `aria-rowindex="2"`, da der Spaltenkopf die erste Zeile ist |
+| Zelle | `role="gridcell"` + `aria-colindex` | Eine Zelle. Spalte A hat `aria-colindex="2"`, da die Zeilennummern die erste Spalte bilden |
+| Zeilennummer | `role="rowheader"` | Der Kopf der Zeile |
+| Zelle | `aria-selected` | `"true"` an der aktiven Zelle und an jeder Zelle der ausgewählten Bereiche |
+| Zelle | `aria-readonly` | `"true"` im schreibgeschützten Modus, solange die [Auswahl](api/spreadsheet_selection_config.md) deaktiviert ist, und an [gesperrten Zellen](work_with_cells.md#locking-cells) |
+| Zelle | `tabindex` | `"0"` an der aktiven Zelle und `"-1"` an den übrigen Zellen, sodass die Zellen einen einzigen Tabstopp bilden |
+| Aktive Zelle | DOM-Fokus | Der Tastaturfokus liegt auf der aktiven Zelle selbst, nicht auf einem separaten Eingabefeld. Während die Zelle bearbeitet wird, liegt der Fokus auf dem Zelleneditor |
+| Verbundene Zelle | `aria-colspan` / `aria-rowspan` | Die Anzahl der Spalten bzw. Zeilen, die die verbundene Zelle umfasst. Die von ihr verdeckten Zellen werden mit `aria-hidden="true"` ausgeblendet |
+| Link in einer Zelle | `` mit `target="_blank"` und `rel="noopener noreferrer"` | Ein Link mit dem Schema `http`, `https`, `mailto`, `ftp` oder `tel` |
+
+Eine Zelle enthält außerdem visuell verborgenen Text, den Screenreader zusammen mit dem Wert vorlesen:
+
+| Verborgener Text | Wann |
+| ----------- | ---- |
+| Die Zellenadresse, zum Beispiel "B7" | An der aktiven Zelle und an jeder Zelle eines ausgewählten Bereichs. Screenreader lesen die Adresse vor dem Wert vor |
+| "link" | An einer ausgewählten Zelle mit einem Link. Alt + Enter öffnet den Link |
+| "locked" | An einer ausgewählten gesperrten Zelle |
+| Eine Beschreibung des Formelfehlers, zum Beispiel "Reference error. Check the cell references" | An einer Zelle mit einem Formelfehler |
+| "Invalid value. Choose a value from the list" | An einer Zelle, deren Wert nicht in ihrer [Werteliste](work_with_cells.md#using-drop-down-lists-in-cells) enthalten ist |
+| "Filter" / "Filter applied" | An einer Zelle mit dem Filtersymbol |
+
+### Spalten- und Zeilenköpfe {#column-and-row-headers}
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| Spaltenbuchstabe | `role="columnheader"` + `aria-colindex` | Der Kopf der Spalte |
+| Ecke "Alles auswählen" | `role="columnheader"` | Benannt "Select all" |
+| Zeilennummer | `role="rowheader"` | Der Kopf der Zeile |
+| Spaltenmenü-Symbol, Symbole ausgeblendeter Zeilen und Spalten | `aria-hidden="true"` | Dekorativ. Die Befehle befinden sich im Kontextmenü |
+
+Die Köpfe sind keine Tabstopps. Ein Klick auf einen Spaltenbuchstaben, eine Zeilennummer oder die Ecke wählt die Zeilen bzw. Spalten aus und gibt den Fokus an die aktive Zelle zurück.
+
+### Formelleiste und Editoren {#formula-bar-and-editors}
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| Eingabefeld der Formelleiste | `aria-label` | "Formula bar, B7", mit der Adresse der aktiven Zelle. Das Eingabefeld ist bei einer gesperrten Zelle `readonly`, sodass sein Wert weiterhin gelesen werden kann. Solange die Auswahl deaktiviert ist, ist die Formelleiste leer und gesperrt |
+| Eingabefeld des Zelleneditors | `aria-label` | "Cell editor, B7" |
+| Editor einer Zelle mit einer Werteliste | `role="combobox"`, `aria-controls`, `aria-expanded`, `aria-activedescendant` | Die Werteliste ist eine `listbox` aus `option`-Elementen, und die hervorgehobene Option hat `aria-selected` |
+| Editor mit einem ungültigen Wert | `aria-invalid="true"` | Der gespeicherte Wert der Zelle ist nicht in ihrer Werteliste enthalten. Das Attribut wird nach dem Speichern des Werts aktualisiert, nicht während der Eingabe |
+| Schließen-Symbol der Formelhilfe | `role="button"` + `aria-label` | "Close formula help" |
+
+### Symbolleiste und Menüs {#toolbar-and-menus}
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| Symbolleiste | `role="toolbar"` + `aria-label` | "Formatting"; die Symbolleisten des Rahmen-Popups, der Suchleiste und des Link-Popups heißen "Borders", "Search" und "Link" |
+| Symbolleisten-Schaltfläche | `aria-label` | Der Wert der Schaltfläche. Eine Symbolschaltfläche wird nach ihrem Tooltip benannt, zum Beispiel "Bold (ctrl+b)". Die Symbole werden mit `aria-hidden="true"` ausgeblendet |
+| Bold, Italic, Underline, Strikethrough, Lock, Filter | `aria-pressed` | Ob die Formatierung bzw. der Filter aktiv ist |
+| Schaltfläche, die ein Dropdown öffnet | `aria-haspopup="menu"`, `aria-expanded` | Das Dropdown ist ein `menu`, das nach seiner Schaltfläche benannt ist |
+| Ausrichtung, Textumbruch, Zahlenformate | `role="menuitemradio"` + `aria-checked` | Eine Option einer exklusiven Gruppe |
+| Text color, Background color, Border color | `aria-label` | Der Name des Steuerelements und der aktuellen Farbe, zum Beispiel "Text color: dark gray" |
+| Farbpalette | `role="grid"` aus `gridcell`-Elementen | Das Grid heißt "Color palette". Jede Farbzelle ist nach ihrer Farbe benannt, und die gewählte hat `aria-selected="true"` |
+| Liste der Rahmenstile | `role="listbox"` aus `option`-Elementen | Die Optionen heißen "Thin line", "Medium line", "Thick line", "Dashed line", "Dotted line", "Double line" |
+| Menüleiste | `role="menubar"` + `aria-label` | "Main". Ihre Einträge öffnen Popups mit `role="menu"`. In den Popups haben die Formatierungseinträge `role="menuitemcheckbox"`, und die Einträge für Ausrichtung, Textumbruch und Zahlenformate haben `role="menuitemradio"`. Beide melden ihren Zustand mit `aria-checked` |
+| Kontextmenüs | `role="menu"` + `aria-label` | "Cell" für die Zellen und "Sheet" für die Blattregisterkarten |
+
+### Blattregisterkarten {#sheet-tabs}
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| Leiste der Blattregisterkarten | `role="toolbar"` + `aria-label` | "Sheets" |
+| Blattregisterkarte | `button` + `aria-pressed` | Die Registerkarte ist nach ihrem Blatt benannt. Die Registerkarte des aktiven Blatts hat `aria-pressed="true"` |
+| Schaltfläche "Blatt hinzufügen" | `aria-label` | "Add sheet" |
+
+### Dialoge {#dialogs}
+
+| Selektor | Rolle / Attribut | Zweck |
+| -------- | ---------------- | ------- |
+| Dialoge für Spaltenbreite und Zeilenhöhe | `role="dialog"`, `aria-modal="true"`, `aria-label` | Benannt nach dem Dialogtitel. Das Eingabefeld ist mit "Width in pixels" / "Height in pixels" beschriftet |
+| Suchleiste | `role="dialog"` + `aria-label` | Benannt "Search". Das Suchfeld ist mit "Search" beschriftet, und die Schaltflächen heißen "Previous match", "Next match" und "Close search" |
+| Link einfügen, Datenvalidierung | `role="dialog"` + `aria-label` | Benannt nach dem Dialogtitel |
+| Warnmeldungen | `role="alertdialog"`, `aria-modal="true"`, `aria-labelledby`, `aria-describedby` | Benannt nach der Kopfzeile der Meldung und beschrieben durch ihren Text |
+
+### Ausgeblendete und dekorative Elemente {#hidden-and-decorative-elements}
+
+Das Spreadsheet blendet dekorative Teile mit `aria-hidden="true"` vor assistiven Technologien aus. Dazu gehören die Symbole für Sperre, Filter und Spaltenmenü, die Symbole ausgeblendeter Zeilen und Spalten sowie das Symbol "Alles auswählen". Ebenso ausgeblendet sind die Ebene, die die Auswahl, die Kopier- und Suchhervorhebungen sowie den Ausfüllpunkt zeichnet, die farbige Kopie der Formel in der Formelleiste und die von einer verbundenen Zelle verdeckten Zellen. Layout-Wrapper haben `role="presentation"`. Die Fokus-Sentinels vor und nach dem Grid leiten den Fokus lediglich an die aktive Zelle weiter.
+
+## Auswahl- und Bearbeitungsmodell {#selection-and-editing-model}
+
+Der DOM-Fokus liegt auf der aktiven Zelle selbst, sodass ein Screenreader die Zelle liest und kein separates Eingabefeld. Wenn sich die aktive Zelle bewegt, liest der Screenreader zuerst die Adresse der neuen Zelle, dann ihren Wert und ihre verborgenen Beschreibungen vor. Wenn der Nutzer mit der Tastatur oder der Maus einen Bereich auswählt, sagt der Screenreader die Ausdehnung des Bereichs an, sobald sich die Auswahl nicht mehr ändert. Eine Zelle, die zu mehreren Bereichen gehört, wird nur einmal gezählt, und die Zellen ausgeblendeter Zeilen und Spalten werden mitgezählt. Während eine Zelle bearbeitet wird, wird nichts angesagt. Wenn ein Bereich auf die aktive Zelle verkleinert wird, wird die Adresse der Zelle angesagt.
+
+| Situation | Was der Screenreader erhält |
+| --------- | --------------------------- |
+| Die aktive Zelle bewegt sich | Die Zelle mit ihrer Adresse, ihrem Wert und ihren Beschreibungen, zum Beispiel "B7, 120, locked" |
+| Ein Bereich wird ausgewählt | "B2 to D7, 18 cells" |
+| Mehrere Bereiche werden mit Ctrl ausgewählt | "B2 to B4, D2 to D4, 6 cells" |
+| Der Editor öffnet sich mit Enter, F2 oder durch Tippen | Das Eingabefeld des Editors mit dem Namen "Cell editor, B7" |
+| Der Editor einer Zelle mit einer Werteliste öffnet sich | Eine aufgeklappte Combobox. Nach ↑ oder ↓ wird die hervorgehobene Option der Liste vorgelesen |
+| Die Bearbeitung wird gespeichert | Neue Formelfehler in den bearbeiteten Zellen und in den davon abhängigen Zellen sowie ungültige Werte in den bearbeiteten Zellen werden angesagt |
+| Die Bearbeitung einer gesperrten Zelle wird abgelehnt | "The cell is locked" |
+| Im schreibgeschützten Modus wird eine Bearbeitungstaste gedrückt | "The sheet is read-only" |
+
+Enter, F2 oder Tippen öffnet den Editor. Enter speichert den Wert und geht nach unten, Tab speichert ihn und geht nach rechts, und Esc bricht die Bearbeitung ab.
+
+## Tastaturnavigation {#keyboard-navigation}
+
+Die Tastatur funktioniert, sobald sich das Spreadsheet auf der Seite befindet; eine Konfiguration ist nicht erforderlich. Die folgenden Tabellen fassen das Tastaturmodell zusammen. Den vollständigen Satz an Tastenkombinationen finden Sie in der [Liste der Hotkeys](hotkeys.md).
+
+
+
+### Zellen {#cells}
+
+| Tasten | Aktion |
+| ---- | ------ |
+| Pfeiltasten | Die aktive Zelle verschieben. Die aktive Zelle stoppt an der ersten und der letzten sichtbaren Zeile und Spalte |
+| Shift + Pfeiltasten | Den ausgewählten Bereich erweitern |
+| Home / End | Zur ersten bzw. letzten sichtbaren Zelle der Zeile wechseln |
+| Ctrl + Pfeiltasten, Ctrl + Home / End | Zum Rand des Blatts wechseln |
+| Tab / Shift + Tab | Innerhalb der Zeile nach rechts bzw. links wechseln. Von der letzten bzw. der ersten Zelle des Blatts aus den Fokus aus den Zellen heraus zum nächsten bzw. vorherigen Teil der Seite verschieben, zum Beispiel zu den Blattregisterkarten oder zur Formelleiste |
+| Enter, F2 | Den Editor öffnen |
+| Esc | Den Editor ohne Speichern schließen |
+| Ctrl + Space / Shift + Space | Die Spalte bzw. die Zeile auswählen |
+| Ctrl + Shift + 9 / 0 | Die ausgeblendeten Zeilen bzw. Spalten innerhalb des ausgewählten Bereichs einblenden |
+| Alt + Enter | Den Link der aktiven Zelle öffnen |
+| Shift + F10 oder die Menütaste | Das Kontextmenü mit den Befehlen für die Zelle öffnen, oder für die Spalte nach Ctrl + Space |
+| Alt + ↑ / ↓, Ctrl + Alt + Page Down / Page Up | Zum nächsten bzw. vorherigen Blatt wechseln |
+
+### Wechsel zwischen den Teilen {#moving-between-the-parts}
+
+| Tasten | Aktion |
+| ---- | ------ |
+| Ctrl + F6 / Ctrl + Shift + F6 | Den Fokus zum nächsten bzw. vorherigen Teil verschieben: das Menü, die Symbolleiste, das Blatt, die Blattregisterkarten. Die Formelleiste und ausgeblendete Teile werden übersprungen. Eine offene Bearbeitung wird zuerst gespeichert |
+| Tab / Shift + Tab | Den Fokus zum nächsten bzw. vorherigen Teil in der Tabulatorreihenfolge der Seite verschieben. Jede Leiste ist ein Tabstopp, und der Fokus landet auf dem zuletzt verwendeten Steuerelement |
+
+### Symbolleiste, Menüleiste und Blattregisterkarten {#toolbar-menu-bar-and-sheet-tabs}
+
+| Tasten | Aktion |
+| ---- | ------ |
+| ← / →, Home / End | Zwischen den Steuerelementen der Leiste wechseln |
+| Enter / Space | Das Steuerelement betätigen: den Befehl ausführen, das Dropdown öffnen oder zum Blatt wechseln |
+| ↓ | Das Dropdown öffnen und den Fokus auf seinen ersten Eintrag setzen |
+| ↑ / ↓ | Zwischen den Einträgen eines geöffneten Dropdowns oder Menüs wechseln |
+| → / ← | Ein Untermenü öffnen bzw. schließen |
+| Esc | Das Dropdown oder das Menü schließen und den Fokus an sein Steuerelement zurückgeben |
+
+### Popups und Dialoge {#popups-and-dialogs}
+
+| Tasten | Aktion |
+| ---- | ------ |
+| Pfeiltasten, Home / End | Zwischen den Farben der Farbpalette wechseln |
+| Enter | Die Farbe, den Rahmen oder die Größe in den Dialogen für Spaltenbreite und Zeilenhöhe anwenden |
+| Esc | Das Popup, den Dialog oder die Suchleiste schließen und den Fokus an das Steuerelement oder die Zelle zurückgeben, die sie geöffnet hat. Im Modus für benutzerdefinierte Farben zur Palette zurückkehren. In einem Farb- oder Stil-Popup, das aus dem Rahmen-Popup geöffnet wurde, es schließen und den Fokus an seine Schaltfläche im Rahmen-Popup zurückgeben |
+| Tab / Shift + Tab | Zwischen den Steuerelementen eines Dialogs oder des Modus für benutzerdefinierte Farben wechseln. In einem Farb-Popup oder im Rahmen-Popup es schließen und den Fokus an seine Symbolleisten-Schaltfläche zurückgeben |
+| ↑ / ↓, Enter | Durch die Werteliste einer Zelle navigieren und einen Wert auswählen |
+
+:::note
+Für Aktionen, die nur mit dem Zeigegerät möglich sind, gibt es Tastaturalternativen. Die Befehle *Column width* und *Row height* des Kontextmenüs legen eine exakte Größe ohne Ziehen fest, und der Befehl *Open filter* öffnet einen Filter ohne Klick auf sein Symbol.
+:::
+
+## Assistive Technologien {#assistive-technology}
+
+Das DHTMLX-Team testet das Spreadsheet mit den folgenden Screenreadern:
+
+| Screenreader | Browser | Plattform |
+| ------------- | ------- | -------- |
+| NVDA | Firefox | Windows |
+| JAWS | Chrome | Windows |
+| VoiceOver | Safari | macOS |
+
+Screenreader erhalten jeden Zustand von dem Element, zu dem er gehört:
+
+| Zustand | Bereitgestellt über | Gelesen an |
+| ----- | --------------- | ------- |
+| Position | `aria-rowindex`, `aria-colindex` und die Zellenadresse im Zellentext | Jeder Zelle. Die Adresse steht im Text der aktiven Zelle und der Zellen der ausgewählten Bereiche |
+| Auswahl | `aria-selected` | Der aktiven Zelle und den Zellen der ausgewählten Bereiche |
+| Bearbeitbarkeit | `aria-readonly` | Dem Grid und den Zellen im schreibgeschützten Modus und solange die Auswahl deaktiviert ist, sowie gesperrten Zellen |
+| Verbundene Zellen | `aria-colspan`, `aria-rowspan` | Der verbundenen Zelle |
+| Zeilenköpfe | `role="rowheader"` | Den Zeilennummern |
+| Umschaltzustand | `aria-pressed` | Den Schaltflächen Bold, Italic, Underline, Strikethrough, Lock und Filter sowie den Blattregisterkarten |
+| Markierungszustand | `aria-checked` | Den Formatierungseinträgen der Menüleiste sowie den Einträgen für Ausrichtung, Textumbruch und Zahlenformate |
+| Fehler und ungültige Werte | Verborgener Text in der Zelle, `aria-invalid` | Der Zelle und ihrem Editor |
+| Links | `` und der verborgene Text "link" | Der Zelle mit einem Link |
+
+## Hoher Kontrast und Fokus {#high-contrast-and-focus}
+
+### Themes {#themes}
+
+Das Spreadsheet hat vier integrierte Themes: `light` (Standard), `dark`, `contrast-light` und `contrast-dark`. Die Themes `contrast-light` und `contrast-dark` erfüllen die WCAG-AA-Kontrastanforderungen für Text. Ein Theme wechseln Sie mit der Methode `dhx.setTheme()` oder mit dem Attribut `data-dhx-theme`:
+
+~~~jsx
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+Details finden Sie im Artikel [Integrierte Themes](/themes/).
+
+In den hellen Themes haben die Farben, die die Zellbezüge einer Formel markieren, einen Kontrast von mindestens 4,5:1.
+
+Das Theme `contrast-light` zeichnet dunklen Text und dunkle Rahmen auf weißem Hintergrund. Im folgenden Spreadsheet ist das Kontextmenü einer Zelle mit dem Filtersymbol mit der Tastatur geöffnet. Sein fokussierter Befehl, [*Open filter*](filtering_data.md#opening-a-filter-with-the-keyboard), ist durch eine gestrichelte Kontur markiert, und die aktive Zelle ist durch einen durchgezogenen Rahmen in der Primärfarbe des Themes markiert:
+
+
+
+Das Theme `contrast-dark` zeichnet hellen Text und helle Rahmen auf dunklem Hintergrund. Wenn der Fokus auf einem Steuerelement der Symbolleiste liegt, ist das Steuerelement durch einen Fokusring in der Farbe `--dhx-spreadsheet-focus-color` markiert, die in den dunklen Themes heller ist als die Primärfarbe des Rahmens der aktiven Zelle:
+
+
+
+### Fokusindikator {#focus-indicator}
+
+Der Tastaturfokus wird in jedem Theme angezeigt:
+
+- die aktive Zelle hat einen durchgezogenen 2px-Rahmen in der Primärfarbe des Themes
+- eine Zelle und der Zelleneditor, die den Tastaturfokus haben, erhalten eine 2px-Kontur in der Primärfarbe des Themes
+- die Formelleiste und die Steuerelemente der Symbolleiste, der Menüleiste, der Blattregisterkarten, des Rahmen-Popups, des Link-Popups und der Suchleiste erhalten eine 2px-Kontur in der Farbe der Variable `--dhx-spreadsheet-focus-color`
+- in der Farbpalette, in der Liste der Rahmenstile, in den Dropdowns der Symbolleiste und der Menüleiste sowie in den Kontextmenüs erhält der fokussierte Eintrag eine gestrichelte 1px-Kontur in der Farbe `--dhx-color-focused`
+- im Listeneditor einer Zelle bleibt der Fokus im Editor, und der aktuelle Eintrag der Liste wird mit einer Hintergrundfarbe hervorgehoben
+
+Die Variable `--dhx-spreadsheet-focus-color` ist in den dunklen Themes heller als die Primärfarbe und kann in einem [benutzerdefinierten Theme](themes/custom_theme.md) neu definiert werden. Der Kontrast jedes Indikators in jedem Theme ist im [Accessibility Conformance Report](accessibility_conformance_report.md) angegeben.
+
+### Farbe und Zoom {#color-and-zoom}
+
+- **Farbe ist nicht das einzige Signal.** Die aktive Zelle und die Auswahl haben einen Rahmen und eine Füllung, ein ungültiger Wert hat eine Markierung und eine verborgene Beschreibung, und die Formatierungsschaltflächen melden ihren Zustand über `aria-pressed`. Die Farbschaltflächen haben den Namen der Farbe in ihrem zugänglichen Namen.
+- **Zoom und Reflow.** Das Spreadsheet bleibt bei 200 % und 400 % Zoom bedienbar. Die Zellen scrollen in zwei Richtungen, und die Symbolleiste, die Menüleiste und die Blattregisterkarten passen in eine Breite von 320 CSS px.
+- **Textabstände.** Mit den WCAG-Überschreibungen für Textabstände wird keine Steuerelement-Beschriftung abgeschnitten, und die Leiste der Blattregisterkarten scrollt, wenn die Registerkarten wachsen.
+- **Ins Sichtfeld scrollen.** Die aktive Zelle wird neben den fixierten Zeilen und Spalten ins Sichtfeld gescrollt.
+
+## Statusansagen {#status-announcements}
+
+Das Spreadsheet sagt die Änderungen, die kein eigenes Element haben, über eine höfliche (polite) Live-Region an, sodass der Screenreader zuerst den aktuellen Satz beendet:
+
+| Ereignis | Angesagter Text | Locale-Schlüssel |
+| ----- | -------------- | ---------- |
+| Ein Bereich wird ausgewählt | "B2 to D7, 18 cells" | `aria_selectedRange`, `aria_rangeExtent`, `aria_rangeSeparator` |
+| Eine Bearbeitung verursacht einen Formelfehler oder einen ungültigen Wert | "B7: Reference error. Check the cell references" | `aria_cellMessage` |
+| Eine Bearbeitung verursacht mehrere Fehler / ungültige Werte | "3 new errors. B7: ..." / "3 invalid values. B7: ..." | `aria_newErrors`, `aria_invalidValues` |
+| Die Bearbeitung einer gesperrten Zelle / eines gesperrten Bereichs wird abgelehnt | "The cell is locked" / "Locked cells were not changed" | `aria_lockedCell`, `aria_lockedCells` |
+| Im schreibgeschützten Modus wird eine Bearbeitungstaste gedrückt | "The sheet is read-only" | `aria_readonlySheet` |
+| Der Suchtext wird eingegeben | "Results: 5. 1 of 5, B2" oder "No results" | `aria_searchResults`, `aria_searchMatch`, `aria_searchNoResults` |
+| Der nächste oder vorherige Treffer wird angezeigt | "2 of 5, B7" | `aria_searchMatch` |
+| Eine Excel-Datei wird exportiert | "Exporting the file", "The file is exported" | `aria_exportStarted`, `aria_exportDone` |
+| Eine im Dateidialog gewählte Datei wird importiert | "Importing the file", "The file is imported" | `aria_importStarted`, `aria_importDone` |
+| Der Befehl Column width / Row height wird angewendet | "Column width set to 120 pixels" | `aria_columnWidthSet`, `aria_rowHeightSet` |
+| Ctrl + Shift + 9 / 0 findet nichts zum Einblenden | "No hidden rows in the selection" | `aria_noHiddenRows`, `aria_noHiddenCols` |
+
+Um das Ergebnis Ihres eigenen Befehls anzusagen, rufen Sie die Methode [`announce()`](api/spreadsheet_announce_method.md) auf:
+
+~~~jsx
+spreadsheet.announce("The report is saved");
+~~~
+
+## Lokalisierung {#localization}
+
+Die zugänglichen Namen, die Zellbeschreibungen und die Ansagen sind in der Locale `spreadsheet` als Schlüssel mit dem Präfix `aria_` neben den Beschriftungen der Oberfläche abgelegt. Übersetzen Sie sie mit der Methode `dhx.i18n.setLocale()`, bevor das Spreadsheet initialisiert wird:
+
+~~~jsx
+dhx.i18n.setLocale("spreadsheet", {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_cellEditor: "Zelleneditor, {cell}",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt",
+ aria_selectedRange: "{range}, {count} Zellen",
+ aria_rangeExtent: "{start} bis {end}"
+});
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+Die Teile in geschweiften Klammern, wie `{cell}` oder `{count}`, werden durch die Werte ersetzt und müssen in den übersetzten Strings erhalten bleiben. Die Namen der Farben und der Schaltflächen der Warnmeldungen stammen aus den Locales `colorpicker` und `message`. Die vollständige Liste der Schlüssel finden Sie unter [Lokalisierung](localization.md#default-locale) und Informationen zu den weiteren Locales unter [Lokalisierung integrierter Widgets](localization.md#localizing-built-in-widgets).
+
+## Konfigurationsbeispiele {#configuration-recipes}
+
+### Barrierefreie Standardeinrichtung {#accessible-default-setup}
+
+Das Spreadsheet benötigt für die Tastatur und die WAI-ARIA-Ausgabe keine Konfiguration. Um die WCAG-AA-Kontrastanforderungen für Text zu erfüllen, wählen Sie ein Kontrast-Theme. Weitere Möglichkeiten, ein Theme festzulegen, finden Sie unter [Integrierte Themes](/themes/):
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ // the keyboard navigation and the WAI-ARIA output need no configuration
+});
+spreadsheet.parse(data);
+
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+### Schreibgeschützte Einrichtung {#read-only-setup}
+
+Verwenden Sie die Option [`readonly`](api/spreadsheet_readonly_config.md), um Daten anzuzeigen, die Nutzer lesen und kopieren, aber nicht ändern können. Tastatur- und Screenreader-Nutzer können sich weiterhin durch die Zellen bewegen:
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ readonly: true
+});
+spreadsheet.parse(data);
+~~~
+
+Um die Daten ohne aktive Zelle und ohne Auswahl anzuzeigen, fügen Sie [`selection: false`](api/spreadsheet_selection_config.md) hinzu. Das Grid wird dann zu einem Tabstopp, den die Tastatur lediglich durchläuft.
+
+### Übersetzte Barrierefreiheits-Strings {#translated-accessibility-strings}
+
+Screenreader lesen die Barrierefreiheits-Strings aus vier Locales: `spreadsheet` enthält die Namen, Zellbeschreibungen und Ansagen, `colorpicker` enthält die Farbnamen, `message` enthält die Namen der Schaltflächen der Warnmeldungen, und `grid` enthält die Ansage der Anzahl geladener Zeilen. Legen Sie alle vier fest, bevor Sie das Spreadsheet erstellen. Die Schlüssel finden Sie unter [Lokalisierung integrierter Widgets](localization.md#localizing-built-in-widgets):
+
+~~~jsx
+const deSpreadsheet = {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt"
+};
+const deColorpicker = {
+ aria_palette: "Farbpalette",
+ aria_colorRed: "rot"
+};
+const deMessage = {
+ aria_confirm: "Bestätigen"
+};
+const deGrid = {
+ aria_rowsLoaded: "{count} Zeilen geladen"
+};
+
+dhx.i18n.setLocale("spreadsheet", deSpreadsheet);
+dhx.i18n.setLocale("colorpicker", deColorpicker);
+dhx.i18n.setLocale("message", deMessage);
+dhx.i18n.setLocale("grid", deGrid);
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+### Einen benutzerdefinierten Befehl ansagen {#announcing-a-custom-command}
+
+Wenn Ihr eigener Befehl die Daten ändert, informieren Sie Screenreader-Nutzer mit der Methode [`announce()`](api/spreadsheet_announce_method.md) über das Ergebnis. Das Beispiel fügt einen [Menü](customization.md#menu)-Befehl hinzu, der das aktive Blatt leert:
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+
+spreadsheet.menu.data.add({ id: "clear-sheet", value: "Clear sheet" });
+
+spreadsheet.menu.events.on("click", function (id) {
+ if (id === "clear-sheet") {
+ spreadsheet.sheets.clear();
+ spreadsheet.announce("The sheet is cleared");
+ }
+});
+~~~
+
+## Verantwortung der Host-Seite {#host-page-responsibilities}
+
+Einige Anforderungen betreffen die Seitenebene und nicht die Komponente selbst. Stellen Sie sicher, dass die Host-Seite:
+
+- die Dokumentsprache festlegt, zum Beispiel ``, sowie einen Seitentitel
+- eine Überschrift über dem Spreadsheet setzt und es innerhalb einer Landmark platziert, zum Beispiel `| Esc | schließt den Editor in einer Zelle ohne die Änderungen zu speichern | +
| Alt (Option) + Enter | +öffnet den Link der aktiven Zelle in einem neuen Tab | +
| Ctrl + F6 | +verschiebt den Fokus zum nächsten Teil von Spreadsheet in der Reihenfolge: Menü, Symbolleiste, Tabellenblatt (die aktive Zelle), Tabellenblatt-Register und dann zurück zum Menü. Die Formelleiste und ausgeblendete Teile werden übersprungen. Speichert zuvor den Wert der bearbeiteten Zelle | +
| Ctrl + Shift + F6 | +verschiebt den Fokus zum vorherigen Teil von Spreadsheet | +
| Linke Pfeiltaste/Rechte Pfeiltaste | +verschiebt den Fokus zum vorherigen/nächsten Steuerelement der Symbolleiste, der Menüleiste oder der Tabellenblatt-Register | +
| Home/End | +verschiebt den Fokus zum ersten/letzten Steuerelement der Leiste | +
| Enter/Leertaste | +betätigt das fokussierte Steuerelement: führt den Befehl aus, öffnet das Dropdown oder wechselt zum Tabellenblatt des fokussierten Registers | +
| Untere Pfeiltaste | +öffnet das Dropdown des fokussierten Steuerelements und verschiebt den Fokus zu dessen erstem Element | +
| Obere Pfeiltaste/Untere Pfeiltaste | +verschiebt den Fokus zwischen den Elementen eines geöffneten Dropdowns oder Menüs | +
| Rechte Pfeiltaste | +öffnet das Untermenü des fokussierten Menüelements | +
| Linke Pfeiltaste | +schließt das Untermenü. In der ersten Ebene eines Dropdowns schließt sie das Dropdown und gibt den Fokus an dessen Steuerelement zurück | +
| Esc | +schließt das Dropdown oder das Menü und gibt den Fokus an das Steuerelement zurück, das es geöffnet hat. Schließt den Tooltip eines Symbolleisten-Steuerelements. Ohne Esc bleibt der Tooltip geöffnet, solange sich der Mauszeiger darauf befindet | +
| Shift + F10 oder Menütaste | +öffnet das Kontextmenü der aktiven Zelle oder des fokussierten Tabellenblatt-Registers und verschiebt den Fokus hinein. Nach Ctrl (Cmd) + Space zeigt das Kontextmenü einer Zelle die Befehle für die Spalte. Esc schließt das Kontextmenü und gibt den Fokus an die Zelle zurück | +
| Ctrl (Cmd) + G | -verschiebt die Auswahl zum nächsten gefundenen Treffer | +hebt den nächsten gefundenen Treffer hervor |
| Ctrl (Cmd) + Shift + G | -verschiebt die Auswahl zum vorherigen gefundenen Treffer | +hebt den vorherigen gefundenen Treffer hervor | +
| Esc | +schließt das Suchfeld und gibt den Fokus an die aktive Zelle zurück |
| Ctrl (Cmd) + Shift + 9 | +blendet die ausgeblendeten Zeilen innerhalb des ausgewählten Bereichs ein | +
| Ctrl (Cmd) + Shift + 0 | +blendet die ausgeblendeten Spalten innerhalb des ausgewählten Bereichs ein | +
| Pfeiltasten | +verschieben den Fokus zwischen den Farben der Palette oder zwischen den Steuerelementen des Border-Popups | +
| Home/End | +verschiebt den Fokus zur ersten/letzten Farbe der Palette | +
| Enter | +wendet die fokussierte Farbe oder den fokussierten Rahmen an. Nachdem eine Text- oder Hintergrundfarbe angewendet wurde, kehrt der Fokus zur aktiven Zelle zurück | +
| Esc | +kehrt vom benutzerdefinierten Farbmodus zur Palette zurück. In einem über dem Border-Popup geöffneten Farb- oder Stil-Popup schließt sie dieses und gibt den Fokus an dessen Schaltfläche im Border-Popup zurück. Andernfalls schließt sie das Popup und gibt den Fokus an dessen Symbolleisten-Steuerelement zurück | +
| Tab/Tab + Shift | +schließt das Popup und gibt den Fokus an dessen Symbolleisten-Steuerelement zurück. Im Border-Popup und in den darüber geöffneten Popups werden alle geschlossen und der Fokus kehrt zum Border-Steuerelement zurück. Im benutzerdefinierten Farbmodus verschiebt sie den Fokus zwischen den Steuerelementen des Farbwählers | +
| Obere Pfeiltaste/Untere Pfeiltaste | +navigiert durch die Werteliste | +
| Enter | +wählt den Wert aus und schließt den Editor | +
| Esc | +schließt den Editor ohne die Änderungen zu speichern | +
| Tab | +speichert den Wert und verschiebt die Auswahl um eine Zelle nach rechts | +
| Esc | +schließt das Filter-Popup und gibt den Fokus an die Zelle zurück | +
| Enter | +wendet die Größe in den Dialogen Column width und Row height an | +
| Esc | +schließt die Dialoge Column width und Row height ohne Änderungen |
Other content
~~~
- Theme auf den via HTMLElement angegebenen Container setzen
~~~html
-
+
Other content
~~~
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/using_typescript.md b/i18n/de/docusaurus-plugin-content-docs/current/using_typescript.md
index 0a152380..ec2ac500 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/using_typescript.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/using_typescript.md
@@ -1,7 +1,7 @@
---
sidebar_label: TypeScript-Unterstützung
title: TypeScript-Unterstützung
-description: Sie erfahren, wie Sie TypeScript mit der DHTMLX JavaScript Spreadsheet-Bibliothek verwenden. Sehen Sie sich Entwicklerhandbücher und API-Referenzen an, probieren Sie Codebeispiele und Live-Demos aus, und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: Nutzen Sie die integrierten TypeScript-Definitionen von DHTMLX Spreadsheet für Typprüfung, Autovervollständigung und JSDoc-Hinweise in Ihrer IDE.
---
# TypeScript-Unterstützung {#typescript-support}
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/vuejs_integration.md b/i18n/de/docusaurus-plugin-content-docs/current/vuejs_integration.md
index b477fc26..82c0aabf 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/vuejs_integration.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/vuejs_integration.md
@@ -1,7 +1,7 @@
---
sidebar_label: Integration mit Vue
title: Vue-Integration
-description: In der Dokumentation erfahren Sie mehr über die Vue-Integration der DHTMLX JavaScript Spreadsheet-Bibliothek. Lesen Sie Entwickleranleitungen und die API-Referenz, probieren Sie Code-Beispiele und Live-Demos aus, und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: DHTMLX Spreadsheet in einer Vue-Anwendung verwenden. Erstellen Sie ein Projekt, fügen Sie Spreadsheet als Vue-Komponente hinzu, laden Sie Daten und verarbeiten Sie Events.
---
# Integration mit Vue {#integration-with-vue}
@@ -260,6 +260,10 @@ export default {
//...
~~~
+:::info
+Die Methode `destructor()` entfernt die mit `spreadsheet.events.on()` hinzugefügten Event-Handler. Wenn eine neue Spreadsheet-Instanz erstellt wird, zum Beispiel wenn die Komponente erneut erstellt wird, fügen Sie die Handler der neuen Instanz hinzu.
+:::
+
Danach können Sie die App starten, um Spreadsheet mit Daten auf einer Seite geladen zu sehen.
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/whats_new.md b/i18n/de/docusaurus-plugin-content-docs/current/whats_new.md
index 543c1739..f94d51a7 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/whats_new.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/whats_new.md
@@ -1,13 +1,78 @@
---
sidebar_label: Was ist neu
title: Was ist neu in DHTMLX Spreadsheet
-description: Sie erfahren in der Dokumentation, was neu in der DHTMLX JavaScript Spreadsheet-Bibliothek ist. Durchsuchen Sie Entwicklerhandbücher und API-Referenzen, testen Sie Code-Beispiele und Live-Demos, und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: Versionshinweise zu DHTMLX Spreadsheet mit neuen Funktionen, Aktualisierungen, Fehlerbehebungen und Breaking Changes jeder Version.
---
# Was ist neu {#whats-new}
Wenn Sie Spreadsheet von einer älteren Version aktualisieren, lesen Sie die [Migration auf eine neuere Version](migration.md) für Details.
+## Version 6.0.4 {#version-604}
+
+Veröffentlicht am 2. November 2026
+
+### Neue Funktionen {#new-functionality-604}
+
+- Unterstützung der Barrierefreiheit nach WCAG 2.2 AA, Section 508 und EN 301 549: Tastaturbedienung aller Teile von Spreadsheet, Screenreader-Unterstützung und ein sichtbarer Fokus in jedem Theme. Weitere Informationen finden Sie im Leitfaden [Accessibility](accessibility.md) und im [Accessibility Conformance Report](accessibility_conformance_report.md)
+- Die Möglichkeit, die Auswahl von Zellen aus- und einzuschalten:
+ - neue Konfigurationseigenschaft: [`selection`](api/spreadsheet_selection_config.md)
+ - neue Methoden des Selection-Moduls: [`enable()`](api/selection_enable_method.md), [`disable()`](api/selection_disable_method.md), [`isDisabled()`](api/selection_isdisabled_method.md)
+- Die Methode [`announce()`](api/spreadsheet_announce_method.md) sendet eine Statusmeldung an Screenreader
+- Neue Befehle des [Kontextmenüs](customization.md#context-menu): [*Column width*, *Row height*](work_with_rows_cols.md#setting-column-width-and-row-height) und [*Open filter*](filtering_data.md#opening-a-filter-with-the-keyboard)
+
+### Aktualisierungen {#updates-604}
+
+- Tastaturnavigation (siehe die [Liste der Hotkeys](hotkeys.md)):
+ - der Fokus bleibt auf der aktiven Zelle, `Tab` und `Shift + Tab` verlassen die Zellen von der letzten bzw. der ersten Zelle des Tabellenblatts aus, und `Ctrl + F6` verschiebt den Fokus zwischen Menü, Symbolleiste, Tabellenblatt und Tabellenblatt-Registerkarten
+ - die Symbolleiste, die Menüleiste und die Tabellenblatt-Registerkarten sind jeweils ein einzelner Tab-Stopp und werden mit den Pfeiltasten navigiert
+ - neue Tastenkombinationen wurden hinzugefügt, zum Beispiel `Shift + F10` für das Kontextmenü und `Ctrl (Cmd) + Shift + 9` / `Ctrl (Cmd) + Shift + 0` zum Einblenden ausgeblendeter Zeilen und Spalten
+ - die Farb- und Rahmen-Popups der Symbolleiste übernehmen beim Öffnen den Fokus und werden mit `Esc` und `Tab` geschlossen
+- Die Pfeiltasten stoppen an der ersten und letzten sichtbaren Zeile und Spalte, anstatt zum gegenüberliegenden Rand zu springen, und eine Pfeiltaste am Rand reduziert einen ausgewählten Bereich auf die aktive Zelle
+- Mit einem Input Method Editor (IME) eingegebener Text wird in der aktiven Zelle angezeigt und startet die Bearbeitung über die Methode [`startEdit()`](api/spreadsheet_startedit_method.md), sodass die Events `beforeEditStart` und `afterEditStart` dafür ausgelöst werden
+- Die Methode [`setFocusedCell()`](api/selection_setfocusedcell_method.md) verschiebt den Tastaturfokus auf die Zelle
+- Ein [Link in einer Zelle](work_with_cells.md#inserting-a-hyperlink-into-a-cell) wird als echter Link dargestellt, der in einem neuen Tab geöffnet wird, und `Alt (Option) + Enter` öffnet den Link der aktiven Zelle
+- Der [Nur-Lese-Modus](api/spreadsheet_readonly_config.md) behält die Tastaturnavigation, die Auswahl, das Kopieren und die Suche bei, und Screenreader kündigen abgelehnte Bearbeitungen an. Um die Auswahl auszuschalten, verwenden Sie die Option `selection: false`
+- [Das Entfernen einer Zeile oder Spalte über eine zusammengeführte Zelle](merge_cells.md#removing-rows-and-columns-of-merged-cells) entfernt alle Zeilen bzw. Spalten der zusammengeführten Zelle
+- Neue Oberflächen- und Screenreader-Texte im [Gebietsschema `spreadsheet`](localization.md#default-locale) sowie [Übersetzung der integrierten Widgets](localization.md#localizing-built-in-widgets)
+- Die Variable [`--dhx-spreadsheet-focus-color`](/themes/#spreadsheet-specific-styles) für den Tastaturfokus sowie die Referenzfarben von Formeln mit höherem Kontrast in den hellen Themes
+
+### Fehlerbehebungen {#fixes-604}
+
+- Eine zusammengeführte Zelle wurde verworfen, anstatt verschoben zu werden, wenn eine Zeile oder Spalte vor ihr gelöscht wurde. Jetzt wird eine zusammengeführte Zelle, von der nur eine einzelne Zelle übrig bleibt, zu einer gewöhnlichen Zelle und behält ihren Wert
+- Das Löschen einer Zeile oder Spalte über eine zusammengeführte Zelle entfernte nur eine Zeile bzw. Spalte der Zusammenführung
+- Die Beschriftungen des Kontextmenüs zum Entfernen von Zeilen und Spalten zeigten nicht alle Zeilen oder Spalten einer zusammengeführten Zelle an, die entfernt würden
+- Zeilen wurden nicht gelöscht, wenn sie den gesamten gefilterten Bereich abdeckten
+- Der fixierte Bereich wurde nicht kleiner, wenn fixierte Zeilen oder Spalten gelöscht wurden
+- Autofill löste einen Fehler aus, wenn die gezogenen Zellen keine einfache Zahl enthielten
+- Die Seite fror bei den Tasten `Home`, `End`, `Ctrl (Cmd) + Home`, `Ctrl (Cmd) + End` und `Ctrl (Cmd) + Pfeiltaste` ein, wenn die erste oder letzte Zeile oder Spalte ausgeblendet war
+- Die Schriftgröße ging verloren, wenn Zellen nach Excel kopiert oder aus Excel bzw. innerhalb von Spreadsheet eingefügt wurden
+- Der Tooltip für ungültige Werte erschien abseits der ungültigen Zelle oder wurde nicht angezeigt
+- `Esc` und `Tab` funktionierten im Listen-Editor nicht mehr, nachdem die Pfeiltasten verwendet wurden
+- Die Suche hob zuerst den zweiten Treffer hervor und aktualisierte die Ergebnisse nach einer Bearbeitung oder einem Wechsel des Tabellenblatts nicht
+- Beim Import oder Export in einem Browser ohne WebAssembly trat ein Skriptfehler auf
+- Nach `destructor()` blieben Dokument-Listener und innere Widgets zurück
+- Der Tastaturfokus ging verloren, nachdem die Suchleiste geschlossen wurde
+- Ein geschlossenes Kontextmenü wurde erneut geöffnet
+- Die aktive Zelle wurde bei der Tastaturnavigation eine Zelle zu kurz an den Rand des Viewports gescrollt
+- Eine Formel mit einem ungültigen Bezug zeigte einen fehlerhaften oder wiederholten `#REF!`-Fehler statt eines einzelnen `#REF!`
+
+### React Spreadsheet {#react-spreadsheet-604}
+
+React Spreadsheet enthält alle oben aufgeführten Aktualisierungen und Fehlerbehebungen von Spreadsheet. Die folgenden Änderungen betreffen nur den React-Wrapper.
+
+#### Aktualisierungen {#react-updates-604}
+
+- Die neue Prop [`selection`](react/props.md#runtime-props)
+- Der Typ [`ISelection`](react/types.md#re-exported-upstream-types) wird re-exportiert
+- [`readonly`](react/props.md#init-only-props) ist eine Init-only-Prop
+
+#### Fehlerbehebungen {#react-fixes-604}
+
+- Die Event-Callbacks und `onStateChange` wurden nicht ausgelöst, nachdem Spreadsheet durch eine Änderung einer Init-only-Prop neu erstellt wurde
+- Die Event-Handler des Wrappers wurden beim Unmount nicht entfernt
+- Die Daten aus `loadUrl` wurden beim Mount zweimal geladen und nach dem Neuerstellen von Spreadsheet erneut über die beibehaltenen Daten
+
## Version 6.0.3 {#version-603}
Veröffentlicht am 24. August 2026
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/work_with_cells.md b/i18n/de/docusaurus-plugin-content-docs/current/work_with_cells.md
index 635d959d..443817d7 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/work_with_cells.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/work_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: Zellen bearbeiten
title: Zellen bearbeiten
-description: In der Dokumentation der DHTMLX JavaScript Spreadsheet-Bibliothek erfahren Sie alles über die Arbeit mit Zellen. Lesen Sie Entwicklerhandbücher und die API-Referenz, testen Sie Codebeispiele und Live-Demos, und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: Bearbeiten Sie Zellen in DHTMLX Spreadsheet. Geben Sie Inhalte ein, fügen Sie Hyperlinks ein, verwenden Sie Dropdown-Listen, füllen Sie mehrere Zellen aus, kopieren Sie Zellen von und nach Excel und sperren Sie Zellen.
---
# Zellen bearbeiten {#editing-cells}
@@ -145,14 +145,27 @@ Sie können Zellen automatisch mit Daten füllen. So funktioniert es:
- Um die Reihe 1, 3, 5, 7, 9, ... zu erstellen, geben Sie 1 und 3 in die ersten beiden Zellen ein.
- Um die Reihe 2, 4, 6, 8, 10, ... zu erstellen, geben Sie 2 und 4 in die ersten beiden Zellen ein.
- Neben Zahlen können Sie auch Buchstaben in einem Muster verwenden, zum Beispiel: Um eine Reihe wie 1, a, 2, b, 3, a, 4, b, ... zu erstellen, geben Sie 1, a, 2, b in die ersten vier Zellen ein.
+ - Um eine Zahl am Ende eines Textes fortzusetzen, geben Sie die ersten Werte ein, zum Beispiel: Um eine Reihe item1, item2, item3, ... zu erstellen, geben Sie item1 und item2 in die ersten beiden Zellen ein.
+ - Um eine Reihe von Datumsangaben zu erstellen, geben Sie ein Datum in die erste Zelle ein: Jede weitere Zelle erhält den nächsten Tag.
+- Wiederholen des Texts
+
+Beispiel: Um die Reihe North, South, North, South, ... zu erstellen, geben Sie North und South in die ersten beiden Zellen ein. Zahlen in Zellen mit dem Format *Text* werden auf dieselbe Weise wiederholt.
3\. Ziehen Sie den **Ausfüllpunkt**
+## Zellen von und nach Excel kopieren {#copying-cells-to-and-from-excel}
+
+Sie können Zellen mit **Ctrl (Cmd) + C** kopieren und mit **Ctrl (Cmd) + V** einfügen, und zwar innerhalb von Spreadsheet sowie zwischen Spreadsheet und Microsoft Excel:
+
+- innerhalb von Spreadsheet behalten die Zellen ihre Werte, Formeln, Stile, Zahlenformate und Links. Die Zellbezüge in den Formeln werden an die neue Position verschoben
+- in Excel erhalten die eingefügten Zellen die Werte (die Ergebnisse der Formeln, nicht die Formeln), die Stile (einschließlich der Schriftgröße), zusammengeführte Zellen und Links. Zeilen, die durch einen Filter ausgeblendet sind, werden übersprungen
+- aus Excel kopierte Zellen behalten beim Einfügen in Spreadsheet ihre Werte, Stile (einschließlich der Schriftgröße), Zahlenformate, zusammengeführte Zellen und Links
+
## Zellen sperren {#locking-cells}
-Sie können Zellen sperren, um ihre Werte vor Änderungen zu schützen. Wenn Sie eine Zelle sperren, wird in der oberen rechten Ecke ein graues "Schlüssel"-Symbol angezeigt. Gesperrte Zellen reagieren nicht auf Bearbeitungsversuche.
+Sie können Zellen sperren, um ihre Werte vor Änderungen zu schützen. Wenn Sie eine Zelle sperren, wird in der oberen rechten Ecke ein graues "Schlüssel"-Symbol angezeigt. Gesperrte Zellen reagieren nicht auf Bearbeitungsversuche. Screenreader kündigen die abgelehnte Bearbeitung an: „Die Zelle ist gesperrt" ("The cell is locked") bei einer einzelnen Zelle oder „Gesperrte Zellen wurden nicht geändert" ("Locked cells were not changed"), wenn der ausgewählte Bereich gesperrte Zellen enthält.
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/work_with_rows_cols.md b/i18n/de/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
index ff40c61f..97ce073d 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
@@ -1,7 +1,7 @@
---
sidebar_label: Arbeiten mit Zeilen und Spalten
title: Arbeiten mit Zeilen und Spalten
-description: Sie erfahren, wie Sie in der DHTMLX JavaScript Spreadsheet-Bibliothek mit Zeilen und Spalten arbeiten. Entdecken Sie Entwicklerhandbücher und API-Referenz, probieren Sie Code-Beispiele und Live-Demos aus, und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: Arbeiten Sie in DHTMLX Spreadsheet mit Zeilen und Spalten. Fügen Sie sie hinzu und entfernen Sie sie, passen Sie die Spaltenbreite automatisch an, legen Sie Spaltenbreite und Zeilenhöhe fest, fixieren Sie sie und blenden Sie sie aus und ein.
---
# Arbeiten mit Zeilen und Spalten {#work-with-rows-and-columns}
@@ -54,6 +54,10 @@ Um eine Zeile zu entfernen, führen Sie die folgenden Schritte aus:
Um mehrere Zeilen auf einmal zu entfernen: Wahlen Sie die Zeilen aus, klicken Sie mit der rechten Maustaste, um das Kontextmenü aufzurufen, und wählen Sie *Rows -> Remove rows [ids]*.
:::
+:::info
+Wenn die ausgewählte Zelle innerhalb einer zusammengeführten Zelle liegt, werden alle Zeilen der zusammengeführten Zelle entfernt. Details finden Sie im Artikel [Zellen zusammenführen](merge_cells.md#removing-rows-and-columns-of-merged-cells).
+:::
+
### Spalten hinzufügen {#adding-columns}
Um eine neue Spalte hinzuzufügen, führen Sie die folgenden Schritte aus:
@@ -98,6 +102,10 @@ Um eine Spalte zu entfernen, führen Sie die folgenden Schritte aus:
Um mehrere Spalten auf einmal zu entfernen: Wahlen Sie die Spalten aus, klicken Sie mit der rechten Maustaste, um das Kontextmenü aufzurufen, und wählen Sie *Columns -> Remove columns [ids]*.
:::
+:::info
+Wenn die ausgewählte Zelle innerhalb einer zusammengeführten Zelle liegt, werden alle Spalten der zusammengeführten Zelle entfernt. Details finden Sie im Artikel [Zellen zusammenführen](merge_cells.md#removing-rows-and-columns-of-merged-cells).
+:::
+
## Spaltenbreite automatisch anpassen {#autofit-column-width}
Um die Spaltenbreite so zu ändern, dass sie automatisch dem längsten Inhalt der Spalte entspricht, können Sie:
@@ -116,6 +124,50 @@ Um die Spaltenbreite so zu ändern, dass sie automatisch dem längsten Inhalt de
+## Spaltenbreite und Zeilenhöhe festlegen {#setting-column-width-and-row-height}
+
+### Spaltenbreite festlegen {#setting-column-width}
+
+Um eine genaue Breite für Spalten festzulegen, führen Sie die folgenden Schritte aus:
+
+1\. Wählen Sie eine Spalte oder eine Zelle in der Spalte aus. Um mehrere Spalten zu ändern, wählen Sie einen Zellbereich aus, der sie umfasst.
+
+2\. Klicken Sie mit der rechten Maustaste auf die Auswahl oder drücken Sie `Shift + F10` bzw. die Menütaste und wählen Sie *Columns -> Column width*. Derselbe Befehl ist im Menü des 3-Punkte-Symbols der Spalte verfügbar.
+
+
+
+3\. Geben Sie im Dialog *Column width* die Breite in Pixeln ein und klicken Sie auf **Apply** oder drücken Sie `Enter`.
+
+
+
+### Zeilenhöhe festlegen {#setting-row-height}
+
+Um eine genaue Höhe für Zeilen festzulegen, führen Sie die folgenden Schritte aus:
+
+1\. Wählen Sie eine Zeile oder eine Zelle in der Zeile aus. Um mehrere Zeilen zu ändern, wählen Sie einen Zellbereich aus, der sie umfasst.
+
+2\. Klicken Sie mit der rechten Maustaste auf die Auswahl oder drücken Sie `Shift + F10` bzw. die Menütaste und wählen Sie *Rows -> Row height*.
+
+
+
+3\. Geben Sie im Dialog *Row height* die Höhe in Pixeln ein und klicken Sie auf **Apply** oder drücken Sie `Enter`.
+
+
+
+### Anwendung der neuen Größe {#how-the-new-size-is-applied}
+
+Der Dialog zeigt die aktuelle Größe der ersten Spalte bzw. Zeile des ausgewählten Bereichs an und wendet die neue Größe auf jede Spalte bzw. Zeile dieses Bereichs an. Wenn mehrere Bereiche ausgewählt sind, wird der zuletzt ausgewählte Bereich verwendet.
+
+Die Größe wird auf ganze Pixel gerundet. Die Mindestbreite einer Spalte beträgt 20 px und die Mindesthöhe einer Zeile 10 px: Ein kleinerer positiver Wert wird durch das Minimum ersetzt. Solange das Feld leer ist oder der Wert keine positive Zahl ist, ist die Schaltfläche **Apply** deaktiviert.
+
+Die Schaltfläche **Cancel** oder `Esc` schließt den Dialog ohne Änderungen. Screenreader kündigen die neue Größe an, zum Beispiel „Column width set to 120 pixels".
+
+### Änderung rückgängig machen {#undoing-the-change}
+
+Die neue Größe kann mit `Ctrl (Cmd) + Z` rückgängig gemacht werden.
+
+Um die Änderung im Code zu verarbeiten, verwenden Sie die [Actions](api/overview/actions_overview.md#list-of-actions) `resizeCol` und `resizeRow`.
+
## Zeilen und Spalten fixieren/Fixierung aufheben {#freezingunfreezing-rows-and-columns}
### Zeilen fixieren {#freezing-rows}
@@ -212,6 +264,10 @@ Um eine Zeile auszublenden, führen Sie die folgenden Schritte aus:
+:::info
+Wenn sich die aktive Zelle in einer Zeile befindet, die ausgeblendet wird, wechselt die aktive Zelle zur ersten sichtbaren Zeile darunter, und die Auswahl wird auf diese Zelle reduziert. Wenn darunter keine sichtbaren Zeilen vorhanden sind, wechselt sie zur letzten sichtbaren Zeile darüber.
+:::
+
### Zeilen einblenden {#showing-rows}
Um ausgeblendete Zeilen einzublenden, führen Sie einen der folgenden Schritte aus:
@@ -228,6 +284,8 @@ Um ausgeblendete Zeilen einzublenden, führen Sie einen der folgenden Schritte a
+- oder wählen Sie Zeilen oder mehrere Zellen aus, sodass die ausgeblendeten Zeilen in die Auswahl eingeschlossen sind, und drücken Sie `Ctrl (Cmd) + Shift + 9`. Wählen Sie zum Beispiel die Zeilen 2-4 aus, um die ausgeblendete Zeile 3 einzublenden. Wenn die Auswahl keine ausgeblendeten Zeilen enthält, kündigen Screenreader „No hidden rows in the selection" an
+
### Spalten ausblenden {#hiding-columns}
Um eine Spalte auszublenden, führen Sie die folgenden Schritte aus:
@@ -244,6 +302,10 @@ Um eine Spalte auszublenden, führen Sie die folgenden Schritte aus:
+:::info
+Wenn sich die aktive Zelle in einer Spalte befindet, die ausgeblendet wird, wechselt die aktive Zelle zur ersten sichtbaren Spalte rechts davon, und die Auswahl wird auf diese Zelle reduziert. Wenn rechts keine sichtbaren Spalten vorhanden sind, wechselt sie zur letzten sichtbaren Spalte links.
+:::
+
### Spalten einblenden {#showing-columns}
Um ausgeblendete Spalten einzublenden, führen Sie einen der folgenden Schritte aus:
@@ -259,3 +321,5 @@ Um ausgeblendete Spalten einzublenden, führen Sie einen der folgenden Schritte
(*In der folgenden Abbildung ist die Spalte C ausgeblendet*)
+
+- oder wählen Sie Spalten oder mehrere Zellen aus, sodass die ausgeblendeten Spalten in die Auswahl eingeschlossen sind, und drücken Sie `Ctrl (Cmd) + Shift + 0`. Wenn die Auswahl keine ausgeblendeten Spalten enthält, kündigen Screenreader „No hidden columns in the selection" an
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/work_with_sheets.md b/i18n/de/docusaurus-plugin-content-docs/current/work_with_sheets.md
index e6dce490..b9d8bcba 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/work_with_sheets.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/work_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: Mit Tabellenblättern arbeiten
title: Mit Tabellenblättern arbeiten
-description: In der Dokumentation der DHTMLX JavaScript Spreadsheet-Bibliothek erfahren Sie, wie Sie mit Tabellenblättern arbeiten. Durchsuchen Sie Entwicklerhandbücher und die API-Referenz, probieren Sie Codebeispiele und Live-Demos aus und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: Fügen Sie in DHTMLX Spreadsheet über die untere Toolbar und die Blattregister Tabellenblätter hinzu, entfernen, benennen und wechseln Sie sie und verweisen Sie in Formeln auf Zellen anderer Blätter.
---
# Mit Tabellenblättern arbeiten {#work-with-sheets}
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/working_with_cells.md b/i18n/de/docusaurus-plugin-content-docs/current/working_with_cells.md
index 9a6be8f4..24849540 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/working_with_cells.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/working_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: Mit Zellen arbeiten
title: Mit Zellen arbeiten
-description: In der Dokumentation der DHTMLX JavaScript Spreadsheet-Bibliothek erfahren Sie, wie Sie mit Zellen arbeiten. Entwickleranleitungen und API-Referenz, Code-Beispiele, Live-Demos und eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet stehen zur Verfügung.
+description: Setzen und lesen Sie über die API Werte und Stile von Zellen in DHTMLX Spreadsheet, validieren Sie Zellen, fügen Sie Links ein und bearbeiten, sperren, verbinden und markieren Sie Zellen.
---
# Mit Zellen arbeiten {#work-with-cells}
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/working_with_sheets.md b/i18n/de/docusaurus-plugin-content-docs/current/working_with_sheets.md
index 0b5ac0a5..9374487d 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/working_with_sheets.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/working_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: Mit Tabellen arbeiten
title: Mit Tabellen arbeiten
-description: In der Dokumentation der DHTMLX JavaScript Spreadsheet-Bibliothek erfahren Sie, wie Sie mit Tabellen arbeiten. Hier finden Sie Entwickleranleitungen und API-Referenzen, Codebeispiele und Live-Demos sowie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet.
+description: Laden Sie mehrere Tabellenblätter in DHTMLX Spreadsheet und fügen Sie Blätter mit API-Methoden hinzu, entfernen, lesen, leeren und wechseln Sie sie.
---
# Mit Tabellen arbeiten
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/working_with_ssheet.md b/i18n/de/docusaurus-plugin-content-docs/current/working_with_ssheet.md
index dcc430d9..59d3d55a 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/working_with_ssheet.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/working_with_ssheet.md
@@ -1,7 +1,7 @@
---
sidebar_label: Mit der Tabellenkalkulation arbeiten
title: Mit der Tabellenkalkulation arbeiten
-description: Sie können in der Dokumentation der DHTMLX JavaScript Spreadsheet-Bibliothek erfahren, wie Sie mit der Tabellenkalkulation arbeiten. Durchsuchen Sie Entwicklerhandbücher und die API-Referenz, testen Sie Codebeispiele und Live-Demos, und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Spreadsheet herunter.
+description: Machen Sie über die API Aktionen in DHTMLX Spreadsheet rückgängig und wiederholen Sie sie, fügen Sie Zeilen und Spalten hinzu, entfernen, fixieren und blenden Sie sie aus, passen Sie die Spaltenbreite an, filtern, durchsuchen und sortieren Sie Daten und leeren Sie die Tabelle.
---
# Mit der Tabellenkalkulation arbeiten {#work-with-spreadsheet}
@@ -282,7 +282,7 @@ Ab v4.3 können Sie Daten in der Tabellenkalkulation mit der Methode [`sortCells
- `dir` - die Sortierrichtung: 1 - aufsteigende Sortierreihenfolge, -1 - absteigende Sortierreihenfolge
~~~jsx {5}
-const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// Konfigurationsparameter
});
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current.json b/i18n/ko/docusaurus-plugin-content-docs/current.json
index 1bf9b07c..4648be09 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current.json
+++ b/i18n/ko/docusaurus-plugin-content-docs/current.json
@@ -83,6 +83,10 @@
"message": "셀 작업",
"description": "The generated-index page title for category 'Work with cells' in sidebar 'docs'"
},
+ "sidebar.docs.category.Accessibility": {
+ "message": "접근성",
+ "description": "The label for category 'Accessibility' in sidebar 'docs'"
+ },
"sidebar.docs.category.Frameworks & integrations": {
"message": "프레임워크 및 통합",
"description": "The label for category 'Frameworks & integrations' in sidebar 'docs'"
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/.sync b/i18n/ko/docusaurus-plugin-content-docs/current/.sync
index 96f6c508..0532604c 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-2b6d3c2fd433461ffce34526974de3f1ba5161a8
+9ff2cef64e00d4e77947433a670dc5d573fcc7f4
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/accessibility.md b/i18n/ko/docusaurus-plugin-content-docs/current/accessibility.md
new file mode 100644
index 00000000..bced66c2
--- /dev/null
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/accessibility.md
@@ -0,0 +1,449 @@
+---
+sidebar_label: 접근성
+title: 접근성
+description: DHTMLX Spreadsheet를 키보드 및 스크린 리더 사용자가 이용할 수 있도록 만드는 방법을 설명합니다. WCAG 2.2 AA를 목표로 하는 WAI-ARIA 지원, 키보드 탐색, 스크린 리더 안내 및 고대비 테마에 대해 알아보십시오.
+---
+
+# DHTMLX Spreadsheet의 접근성
+
+이 가이드는 접근성 요구 사항을 충족해야 하는 애플리케이션에 DHTMLX Spreadsheet를 포함하는 개발자를 위한 문서입니다. 이 가이드를 사용하여 컴포넌트를 체크리스트와 대조하고, 키보드, 스크린 리더 및 고대비 사용자를 위해 컴포넌트를 구성하십시오.
+
+Spreadsheet는 마크업의 일부로 WAI-ARIA 역할과 상태를 렌더링합니다. 키보드 포커스는 활성 셀에 유지되며, 툴바, 메뉴 바 및 시트 탭은 각각 하나의 탭 정지점입니다. 거부된 편집이나 검색 결과처럼 별도의 요소가 없는 변경 사항은 스크린 리더가 소리 내어 읽는 라이브 영역(live region)으로 전달됩니다.
+
+:::info 목표 준수 수준
+DHTMLX Spreadsheet는 **WCAG 2.2 Level AA**, 미국 재활법 **Section 508**, 그리고 **EN 301 549**(유럽 접근성법의 기술 기준)를 충족하도록 설계되었습니다.
+
+준수 여부는 DHTMLX Spreadsheet 6.0.4에 대해 기준별로 보고됩니다. 상세한 **Accessibility Conformance Report (VPAT® 2.5)** 는 다음에서 확인할 수 있습니다. [Accessibility Conformance Report](accessibility_conformance_report.md).
+:::
+
+## 기능 {#capabilities}
+
+| 영역 | 지원 내용 |
+| ---- | ------- |
+| 키보드 조작 | 셀에 대한 모든 명령에 키가 있습니다. 툴바, 메뉴 바 및 시트 탭은 화살표 키로 탐색하는 단일 탭 정지점입니다. 열 너비, 행 높이 및 열 필터에는 컨텍스트 메뉴 명령이 있으므로 드래그하거나 아이콘을 클릭할 필요가 없습니다 |
+| WAI-ARIA 시맨틱 | 셀은 `columnheader`, `rowheader` 및 `gridcell` 요소가 포함된 `grid`입니다. 역할은 항상 렌더링됩니다 |
+| 포커스 모델 | 키보드 포커스는 활성 셀에 있습니다. Tab은 활성 셀을 통해 시트로 진입하며 마지막 셀과 첫 번째 셀에서 시트를 벗어납니다. Ctrl + F6은 메뉴, 툴바, 시트 및 시트 탭 간에 포커스를 이동합니다 |
+| 선택 모델 | 활성 셀, 범위 및 여러 범위는 `aria-selected`를 통해 노출되며, 범위의 크기가 안내됩니다. 선택은 [`selection`](api/spreadsheet_selection_config.md) 옵션으로 끌 수 있습니다 |
+| 읽기 전용 모드 | 시트에서 탐색, 선택, 복사 및 검색할 수 있습니다. 편집은 거부되고 안내되며, 컨텍스트 메뉴는 사용할 수 없습니다 |
+| 스크린 리더 | NVDA, JAWS 및 VoiceOver로 테스트되었습니다 |
+| 시각적 접근성 | `contrast-light` 및 `contrast-dark` 테마, 모든 테마에서 보이는 포커스 표시기, 색상에 의존하지 않는 단서 |
+| 텍스트 크기 조정 및 확대 | 200% 및 400% 확대와 텍스트 간격 재정의 상태에서도 레이아웃을 조작할 수 있습니다 |
+| 사용자 정의 | 사용자 고유의 메시지를 위한 공개 [`announce()`](api/spreadsheet_announce_method.md) 메서드와 모든 기본 제공 이름 및 안내를 위한 번역 가능한 `aria_*` 로캘 문자열 |
+| 표준 | WCAG 2.2 AA, Section 508, EN 301 549 |
+
+## 적용 범위 {#covered-areas}
+
+이 가이드는 Spreadsheet 위젯을 다룹니다.
+
+- 셀, 열 및 행 헤더, 병합된 셀, 고정된 행과 열
+- 선택: 활성 셀, 범위 및 여러 범위
+- 수식 입력줄과 셀 에디터(값 목록이 있는 셀의 에디터 포함)
+- 색상 및 테두리 팝업이 있는 툴바, 메뉴 바 및 컨텍스트 메뉴
+- 시트 탭
+- 정렬, 필터링, 검색, 데이터 유효성 검사, 셀의 링크, 가져오기 및 내보내기
+- 테마와 포커스 표시기
+
+최종 페이지의 접근성은 호스트 애플리케이션에도 좌우됩니다. [Host-page responsibilities](#host-page-responsibilities)를 참조하십시오.
+
+## WAI-ARIA 지원 {#wai-aria-support}
+
+Spreadsheet는 마크업에 WAI-ARIA 역할과 속성을 자동으로 추가하며, 이를 끌 수 없습니다. 위젯의 각 부분에는 고유한 역할과 이름이 있으며, 이름은 [로캘](#localization)에서 가져옵니다.
+
+### Spreadsheet 컨테이너 {#spreadsheet-container}
+
+Spreadsheet의 각 부분은 이름이 지정된 별도의 컨트롤입니다.
+
+| 부분 | 역할 / 속성 | 접근 가능한 이름 |
+| ---- | ---------------- | --------------- |
+| 메뉴 바 | `role="menubar"` + `aria-label` | "Main" |
+| 툴바 | `role="toolbar"` + `aria-label` | "Formatting" |
+| 수식 입력줄 | 입력란의 `aria-label` | "Formula bar, B7", 활성 셀의 주소 포함 |
+| 셀 | `role="grid"` + `aria-label` | "Spreadsheet" |
+| 시트 탭 | `role="toolbar"` + `aria-label` | "Sheets" |
+| 라이브 영역 | `role="status"`, `aria-live="polite"`, `aria-atomic="true"` | 시각적으로 숨겨져 있으며, `role="grid"` 바깥의 그리드 옆에 배치됩니다 |
+
+Spreadsheet의 루트 요소에는 랜드마크 역할이 없으므로 페이지에 맞는 랜드마크 안에 배치할 수 있습니다.
+
+### 셀 영역 {#cell-surface}
+
+다음 속성은 셀 전체를 설명합니다. `.dhx_grid-content` 요소가 이 속성들을 가집니다.
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| `.dhx_grid-content` | `role="grid"` | 셀의 대화형 그리드 |
+| `.dhx_grid-content` | `aria-label` | "Spreadsheet", `aria_grid` 로캘 키에서 가져옴 |
+| `.dhx_grid-content` | `aria-rowcount` | 시트의 행 수에 헤더 행을 더한 값 |
+| `.dhx_grid-content` | `aria-colcount` | 표시되는 열 수에 행 번호 열을 더한 값 |
+| `.dhx_grid-content` | `aria-readonly` | [읽기 전용 모드](api/spreadsheet_readonly_config.md)이거나 [선택](api/spreadsheet_selection_config.md)이 꺼져 있는 동안 `"true"` |
+| `.dhx_grid-content` | `aria-multiselectable` | `"true"`. 선택이 꺼져 있는 동안에는 `"false"` |
+
+### 행과 셀 {#rows-and-cells}
+
+다음 표는 행과 셀의 역할, 위치 및 상태 속성을 나열합니다.
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| 행 | `role="row"` + `aria-rowindex` | 시트의 행. 열 헤더가 첫 번째 행이므로 시트의 1행은 `aria-rowindex="2"`를 가집니다 |
+| 셀 | `role="gridcell"` + `aria-colindex` | 셀. 행 번호가 첫 번째 열이므로 A열은 `aria-colindex="2"`를 가집니다 |
+| 행 번호 | `role="rowheader"` | 행의 헤더 |
+| 셀 | `aria-selected` | 활성 셀과 선택된 범위의 모든 셀에서 `"true"` |
+| 셀 | `aria-readonly` | 읽기 전용 모드, [선택](api/spreadsheet_selection_config.md)이 꺼져 있는 동안, 그리고 [잠긴 셀](work_with_cells.md#locking-cells)에서 `"true"` |
+| 셀 | `tabindex` | 활성 셀에서 `"0"`, 다른 셀에서 `"-1"`이므로 셀은 하나의 탭 정지점입니다 |
+| 활성 셀 | DOM 포커스 | 키보드 포커스는 별도의 입력란이 아니라 활성 셀 자체에 있습니다. 셀을 편집하는 동안에는 포커스가 셀 에디터에 있습니다 |
+| 병합된 셀 | `aria-colspan` / `aria-rowspan` | 병합된 셀이 걸쳐 있는 열 또는 행의 수. 병합된 셀에 가려진 셀은 `aria-hidden="true"`로 숨겨집니다 |
+| 셀의 링크 | `target="_blank"` 및 `rel="noopener noreferrer"`가 있는 `` | `http`, `https`, `mailto`, `ftp` 또는 `tel` 스킴을 사용하는 링크 |
+
+셀에는 값과 함께 스크린 리더가 읽는 시각적으로 숨겨진 텍스트도 포함됩니다.
+
+| 숨겨진 텍스트 | 시점 |
+| ----------- | ---- |
+| 셀 주소(예: "B7") | 활성 셀과 선택된 범위의 모든 셀. 스크린 리더는 값보다 먼저 주소를 읽습니다 |
+| "link" | 링크가 있는 선택된 셀. Alt + Enter로 링크를 엽니다 |
+| "locked" | 선택된 잠긴 셀 |
+| 수식 오류에 대한 설명(예: "Reference error. Check the cell references") | 수식 오류가 있는 셀 |
+| "Invalid value. Choose a value from the list" | 값이 [값 목록](work_with_cells.md#using-drop-down-lists-in-cells)에 없는 셀 |
+| "Filter" / "Filter applied" | 필터 아이콘이 있는 셀 |
+
+### 열 및 행 헤더 {#column-and-row-headers}
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| 열 문자 | `role="columnheader"` + `aria-colindex` | 열의 헤더 |
+| 모두 선택 모서리 | `role="columnheader"` | "Select all"로 명명됨 |
+| 행 번호 | `role="rowheader"` | 행의 헤더 |
+| 열 메뉴 아이콘, 숨겨진 행과 열의 아이콘 | `aria-hidden="true"` | 장식용. 명령은 컨텍스트 메뉴에 있습니다 |
+
+헤더는 탭 정지점이 아닙니다. 열 문자, 행 번호 또는 모서리를 클릭하면 행이나 열이 선택되고 포커스가 활성 셀로 돌아갑니다.
+
+### 수식 입력줄과 에디터 {#formula-bar-and-editors}
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| 수식 입력줄 입력란 | `aria-label` | "Formula bar, B7", 활성 셀의 주소 포함. 잠긴 셀에서는 입력란이 `readonly`이므로 값을 읽을 수 있습니다. 선택이 꺼져 있는 동안 수식 입력줄은 비어 있고 잠깁니다 |
+| 셀 에디터 입력란 | `aria-label` | "Cell editor, B7" |
+| 값 목록이 있는 셀의 에디터 | `role="combobox"`, `aria-controls`, `aria-expanded`, `aria-activedescendant` | 값 목록은 `option` 요소로 구성된 `listbox`이며, 강조 표시된 옵션은 `aria-selected`입니다 |
+| 잘못된 값이 있는 에디터 | `aria-invalid="true"` | 셀의 저장된 값이 값 목록에 없습니다. 이 속성은 사용자가 입력하는 동안이 아니라 값이 저장된 후에 업데이트됩니다 |
+| 수식 도움말의 닫기 아이콘 | `role="button"` + `aria-label` | "Close formula help" |
+
+### 툴바와 메뉴 {#toolbar-and-menus}
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| 툴바 | `role="toolbar"` + `aria-label` | "Formatting". 테두리 팝업, 검색 바 및 링크 팝업의 툴바는 "Borders", "Search" 및 "Link"로 명명됩니다 |
+| 툴바 버튼 | `aria-label` | 버튼의 값. 아이콘 버튼은 툴팁으로 명명됩니다(예: "Bold (ctrl+b)"). 아이콘은 `aria-hidden="true"`로 숨겨집니다 |
+| Bold, Italic, Underline, Strikethrough, Lock, Filter | `aria-pressed` | 서식 또는 필터가 켜져 있는지 여부 |
+| 드롭다운을 여는 버튼 | `aria-haspopup="menu"`, `aria-expanded` | 드롭다운은 해당 버튼의 이름을 따른 `menu`입니다 |
+| 정렬, 텍스트 줄 바꿈, 숫자 형식 | `role="menuitemradio"` + `aria-checked` | 배타적 집합의 한 옵션 |
+| Text color, Background color, Border color | `aria-label` | 컨트롤과 현재 색상의 이름(예: "Text color: dark gray") |
+| 색상 팔레트 | `gridcell` 요소로 구성된 `role="grid"` | 그리드는 "Color palette"로 명명됩니다. 각 색상 셀은 해당 색상의 이름을 가지며, 선택된 셀은 `aria-selected="true"`를 가집니다 |
+| 테두리 스타일 목록 | `option` 요소로 구성된 `role="listbox"` | 옵션은 "Thin line", "Medium line", "Thick line", "Dashed line", "Dotted line", "Double line"으로 명명됩니다 |
+| 메뉴 바 | `role="menubar"` + `aria-label` | "Main". 항목은 `role="menu"`가 있는 팝업을 엽니다. 팝업에서 서식 항목은 `role="menuitemcheckbox"`를, 정렬, 텍스트 줄 바꿈 및 숫자 형식 항목은 `role="menuitemradio"`를 가집니다. 둘 다 `aria-checked`로 상태를 보고합니다 |
+| 컨텍스트 메뉴 | `role="menu"` + `aria-label` | 셀용은 "Cell", 시트 탭용은 "Sheet" |
+
+### 시트 탭 {#sheet-tabs}
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| 시트 탭 바 | `role="toolbar"` + `aria-label` | "Sheets" |
+| 시트 탭 | `button` + `aria-pressed` | 탭은 해당 시트의 이름을 따릅니다. 활성 시트의 탭은 `aria-pressed="true"`를 가집니다 |
+| 시트 추가 버튼 | `aria-label` | "Add sheet" |
+
+### 대화 상자 {#dialogs}
+
+| 선택자 | 역할 / 속성 | 용도 |
+| -------- | ---------------- | ------- |
+| Column width 및 Row height 대화 상자 | `role="dialog"`, `aria-modal="true"`, `aria-label` | 대화 상자 제목으로 명명됩니다. 입력란의 레이블은 "Width in pixels" / "Height in pixels"입니다 |
+| 검색 바 | `role="dialog"` + `aria-label` | "Search"로 명명됩니다. 검색 입력란의 레이블은 "Search"이며, 버튼은 "Previous match", "Next match" 및 "Close search"로 명명됩니다 |
+| Insert link, Data validation | `role="dialog"` + `aria-label` | 대화 상자 제목으로 명명됩니다 |
+| 알림 | `role="alertdialog"`, `aria-modal="true"`, `aria-labelledby`, `aria-describedby` | 알림 헤더로 명명되고 알림 텍스트로 설명됩니다 |
+
+### 숨겨진 요소와 장식 요소 {#hidden-and-decorative-elements}
+
+Spreadsheet는 `aria-hidden="true"`를 사용하여 보조 기술에서 장식 부분을 숨깁니다. 여기에는 잠금, 필터 및 열 메뉴 아이콘, 숨겨진 행과 열의 아이콘, 모두 선택 아이콘이 포함됩니다. 선택 영역, 복사 및 검색 강조 표시, 채우기 핸들을 그리는 레이어도 숨겨집니다. 수식 입력줄에 있는 수식의 색상 복사본과 병합된 셀에 가려진 셀도 마찬가지입니다. 레이아웃 래퍼에는 `role="presentation"`이 있습니다. 그리드 앞뒤의 포커스 센티널은 포커스를 활성 셀로 전달하는 역할만 합니다.
+
+## 선택 및 편집 모델 {#selection-and-editing-model}
+
+DOM 포커스는 활성 셀 자체에 있으므로 스크린 리더는 별도의 입력란이 아니라 셀을 읽습니다. 활성 셀이 이동하면 스크린 리더는 새 셀의 주소를 먼저 읽고, 그다음 값과 숨겨진 설명을 읽습니다. 사용자가 키보드나 마우스로 범위를 선택하면 선택 변경이 멈춘 후 스크린 리더가 범위의 크기를 한 번 안내합니다. 여러 범위에 공유된 셀은 한 번만 계산되며, 숨겨진 행과 열의 셀도 계산됩니다. 셀을 편집하는 동안에는 아무것도 안내되지 않습니다. 범위가 활성 셀 하나로 줄어들면 해당 셀의 주소가 안내됩니다.
+
+| 상황 | 스크린 리더가 받는 내용 |
+| --------- | --------------------------- |
+| 활성 셀이 이동함 | 주소, 값 및 설명이 포함된 셀(예: "B7, 120, locked") |
+| 범위가 선택됨 | "B2 to D7, 18 cells" |
+| Ctrl로 여러 범위가 선택됨 | "B2 to B4, D2 to D4, 6 cells" |
+| Enter, F2 또는 입력으로 에디터가 열림 | "Cell editor, B7"로 명명된 에디터 입력란 |
+| 값 목록이 있는 셀의 에디터가 열림 | 확장된 콤보박스. ↑ 또는 ↓를 누르면 목록에서 강조 표시된 옵션을 읽습니다 |
+| 편집이 저장됨 | 편집된 셀과 그 셀에 의존하는 셀의 새 수식 오류, 그리고 편집된 셀의 잘못된 값이 안내됩니다 |
+| 잠긴 셀의 편집이 거부됨 | "The cell is locked" |
+| 읽기 전용 모드에서 편집 키를 누름 | "The sheet is read-only" |
+
+Enter, F2 또는 입력으로 에디터가 열립니다. Enter는 값을 저장하고 아래로 이동하며, Tab은 값을 저장하고 오른쪽으로 이동하고, Esc는 편집을 취소합니다.
+
+## 키보드 탐색 {#keyboard-navigation}
+
+키보드는 Spreadsheet가 페이지에 표시되는 즉시 작동하며 별도의 구성이 필요하지 않습니다. 아래 표는 키보드 모델을 요약합니다. 전체 단축키는 [Hot keys list](hotkeys.md)를 참조하십시오.
+
+
+
+### 셀 {#cells}
+
+| 키 | 동작 |
+| ---- | ------ |
+| 화살표 키 | 활성 셀을 이동합니다. 활성 셀은 표시되는 첫 번째와 마지막 행 및 열에서 멈춥니다 |
+| Shift + 화살표 키 | 선택된 범위를 확장합니다 |
+| Home / End | 행에서 표시되는 첫 번째 또는 마지막 셀로 이동합니다 |
+| Ctrl + 화살표 키, Ctrl + Home / End | 시트의 가장자리로 이동합니다 |
+| Tab / Shift + Tab | 행 안에서 오른쪽 또는 왼쪽으로 이동합니다. 시트의 마지막 또는 첫 번째 셀에서는 포커스를 셀 밖의 다음 또는 이전 페이지 부분(예: 시트 탭 또는 수식 입력줄)으로 이동합니다 |
+| Enter, F2 | 에디터를 엽니다 |
+| Esc | 저장하지 않고 에디터를 닫습니다 |
+| Ctrl + Space / Shift + Space | 열 또는 행을 선택합니다 |
+| Ctrl + Shift + 9 / 0 | 선택된 범위 안의 숨겨진 행 또는 열을 표시합니다 |
+| Alt + Enter | 활성 셀의 링크를 엽니다 |
+| Shift + F10 또는 Menu 키 | 셀에 대한 명령이 있는 컨텍스트 메뉴를 엽니다. Ctrl + Space 이후에는 열에 대한 컨텍스트 메뉴를 엽니다 |
+| Alt + ↑ / ↓, Ctrl + Alt + Page Down / Page Up | 다음 또는 이전 시트로 전환합니다 |
+
+### 부분 간 이동 {#moving-between-the-parts}
+
+| 키 | 동작 |
+| ---- | ------ |
+| Ctrl + F6 / Ctrl + Shift + F6 | 포커스를 다음 또는 이전 부분(메뉴, 툴바, 시트, 시트 탭)으로 이동합니다. 수식 입력줄과 숨겨진 부분은 건너뜁니다. 열려 있는 편집은 먼저 저장됩니다 |
+| Tab / Shift + Tab | 페이지 탭 순서에서 포커스를 다음 또는 이전 부분으로 이동합니다. 각 바는 하나의 탭 정지점이며, 포커스는 마지막으로 사용한 컨트롤에 놓입니다 |
+
+### 툴바, 메뉴 바 및 시트 탭 {#toolbar-menu-bar-and-sheet-tabs}
+
+| 키 | 동작 |
+| ---- | ------ |
+| ← / →, Home / End | 바의 컨트롤 간에 이동합니다 |
+| Enter / Space | 컨트롤을 누릅니다. 명령을 실행하거나, 드롭다운을 열거나, 시트로 전환합니다 |
+| ↓ | 드롭다운을 열고 포커스를 첫 번째 항목으로 이동합니다 |
+| ↑ / ↓ | 열려 있는 드롭다운 또는 메뉴의 항목 간에 이동합니다 |
+| → / ← | 하위 메뉴를 열거나 닫습니다 |
+| Esc | 드롭다운 또는 메뉴를 닫고 포커스를 해당 컨트롤로 되돌립니다 |
+
+### 팝업 및 대화 상자 {#popups-and-dialogs}
+
+| 키 | 동작 |
+| ---- | ------ |
+| 화살표 키, Home / End | 색상 팔레트의 색상 간에 이동합니다 |
+| Enter | 색상, 테두리 또는 Column width 및 Row height 대화 상자의 크기를 적용합니다 |
+| Esc | 팝업, 대화 상자 또는 검색 바를 닫고 포커스를 이를 연 컨트롤 또는 셀로 되돌립니다. 사용자 지정 색상 모드에서는 팔레트로 돌아갑니다. 테두리 팝업에서 연 색상 또는 스타일 팝업에서는 팝업을 닫고 포커스를 테두리 팝업의 해당 버튼으로 되돌립니다 |
+| Tab / Shift + Tab | 대화 상자 또는 사용자 지정 색상 모드의 컨트롤 간에 이동합니다. 색상 팝업 또는 테두리 팝업에서는 팝업을 닫고 포커스를 해당 툴바 버튼으로 되돌립니다 |
+| ↑ / ↓, Enter | 셀의 값 목록을 탐색하고 값을 선택합니다 |
+
+:::note
+포인터 전용 동작에는 키보드 대안이 있습니다. 컨텍스트 메뉴의 *Column width* 및 *Row height* 명령은 드래그하지 않고도 정확한 크기를 설정하며, *Open filter* 명령은 아이콘을 클릭하지 않고도 필터를 엽니다.
+:::
+
+## 보조 기술 {#assistive-technology}
+
+DHTMLX 팀은 다음 스크린 리더로 Spreadsheet를 테스트합니다.
+
+| 스크린 리더 | 브라우저 | 플랫폼 |
+| ------------- | ------- | -------- |
+| NVDA | Firefox | Windows |
+| JAWS | Chrome | Windows |
+| VoiceOver | Safari | macOS |
+
+스크린 리더는 각 상태를 해당 상태가 속한 요소에서 가져옵니다.
+
+| 상태 | 노출 방식 | 읽는 대상 |
+| ----- | --------------- | ------- |
+| 위치 | `aria-rowindex`, `aria-colindex` 및 셀 텍스트의 셀 주소 | 각 셀. 주소는 활성 셀과 선택된 범위의 셀 텍스트에 있습니다 |
+| 선택 | `aria-selected` | 활성 셀과 선택된 범위의 셀 |
+| 편집 가능 여부 | `aria-readonly` | 읽기 전용 모드와 선택이 꺼져 있는 동안의 그리드 및 셀, 그리고 잠긴 셀 |
+| 병합된 셀 | `aria-colspan`, `aria-rowspan` | 병합된 셀 |
+| 행 헤더 | `role="rowheader"` | 행 번호 |
+| 토글 상태 | `aria-pressed` | Bold, Italic, Underline, Strikethrough, Lock 및 Filter 버튼과 시트 탭 |
+| 선택 상태 | `aria-checked` | 메뉴 바의 서식 항목, 그리고 정렬, 텍스트 줄 바꿈 및 숫자 형식 항목 |
+| 오류 및 잘못된 값 | 셀의 숨겨진 텍스트, `aria-invalid` | 셀과 해당 에디터 |
+| 링크 | `` 및 숨겨진 텍스트 "link" | 링크가 있는 셀 |
+
+## 고대비 및 포커스 {#high-contrast-and-focus}
+
+### 테마 {#themes}
+
+Spreadsheet에는 `light`(기본값), `dark`, `contrast-light` 및 `contrast-dark`의 네 가지 기본 제공 테마가 있습니다. `contrast-light` 및 `contrast-dark` 테마는 텍스트에 대한 WCAG AA 대비 요구 사항을 충족합니다. `dhx.setTheme()` 메서드 또는 `data-dhx-theme` 속성으로 테마를 전환하십시오.
+
+~~~jsx
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+자세한 내용은 [Built-in themes](/themes/) 문서를 참조하십시오.
+
+밝은 테마에서 수식의 셀 참조를 표시하는 색상은 최소 4.5:1의 대비를 가집니다.
+
+`contrast-light` 테마는 흰색 배경에 어두운 텍스트와 테두리를 그립니다. 아래 Spreadsheet에서는 필터 아이콘이 있는 셀의 컨텍스트 메뉴를 키보드로 열었습니다. 포커스가 있는 명령인 [*Open filter*](filtering_data.md#opening-a-filter-with-the-keyboard)는 점선 윤곽선으로 표시되고, 활성 셀은 테마의 기본 색상으로 된 실선 테두리로 표시됩니다.
+
+
+
+`contrast-dark` 테마는 어두운 배경에 밝은 텍스트와 테두리를 그립니다. 포커스가 툴바 컨트롤에 있으면 해당 컨트롤은 `--dhx-spreadsheet-focus-color` 색상의 포커스 링으로 표시되며, 이 색상은 어두운 테마에서 활성 셀 테두리의 기본 색상보다 밝습니다.
+
+
+
+### 포커스 표시기 {#focus-indicator}
+
+키보드 포커스는 모든 테마에서 표시됩니다.
+
+- 활성 셀에는 테마의 기본 색상으로 된 2px 실선 테두리가 있습니다
+- 키보드 포커스가 있는 셀과 셀 에디터에는 테마의 기본 색상으로 된 2px 윤곽선이 적용됩니다
+- 수식 입력줄과 툴바, 메뉴 바, 시트 탭, 테두리 팝업, 링크 팝업 및 검색 바의 컨트롤에는 `--dhx-spreadsheet-focus-color` 변수 색상으로 된 2px 윤곽선이 적용됩니다
+- 색상 팔레트, 테두리 스타일 목록, 툴바와 메뉴 바의 드롭다운 및 컨텍스트 메뉴에서는 포커스가 있는 항목에 `--dhx-color-focused` 색상으로 된 1px 점선 윤곽선이 적용됩니다
+- 셀의 목록 에디터에서는 포커스가 에디터에 유지되며, 목록의 현재 항목은 배경색으로 강조 표시됩니다
+
+`--dhx-spreadsheet-focus-color` 변수는 어두운 테마에서 기본 색상보다 밝으며 [사용자 지정 테마](themes/custom_theme.md)에서 다시 정의할 수 있습니다. 각 테마에서 각 표시기의 대비는 [Accessibility Conformance Report](accessibility_conformance_report.md)에 나와 있습니다.
+
+### 색상 및 확대 {#color-and-zoom}
+
+- **색상이 유일한 신호가 아닙니다.** 활성 셀과 선택 영역에는 테두리와 채우기가 있고, 잘못된 값에는 표시기와 숨겨진 설명이 있으며, 서식 버튼은 `aria-pressed`를 통해 상태를 보고합니다. 색상 버튼의 접근 가능한 이름에는 색상 이름이 포함됩니다.
+- **확대 및 리플로.** Spreadsheet는 200% 및 400% 확대에서도 조작할 수 있습니다. 셀은 두 방향으로 스크롤되며, 툴바, 메뉴 바 및 시트 탭은 320 CSS px 너비에 맞습니다.
+- **텍스트 간격.** WCAG 텍스트 간격 재정의를 적용해도 컨트롤 레이블이 잘리지 않으며, 탭이 늘어나면 시트 탭 바가 스크롤됩니다.
+- **보이는 위치로 스크롤.** 활성 셀은 고정된 행과 열 옆에서 보이는 위치로 스크롤됩니다.
+
+## 상태 안내 {#status-announcements}
+
+Spreadsheet는 별도의 요소가 없는 변경 사항을 polite 라이브 영역을 통해 안내하므로 스크린 리더는 현재 문장을 먼저 끝까지 읽습니다.
+
+| 이벤트 | 안내 텍스트 | 로캘 키 |
+| ----- | -------------- | ---------- |
+| 범위가 선택됨 | "B2 to D7, 18 cells" | `aria_selectedRange`, `aria_rangeExtent`, `aria_rangeSeparator` |
+| 편집으로 수식 오류 또는 잘못된 값이 발생함 | "B7: Reference error. Check the cell references" | `aria_cellMessage` |
+| 편집으로 여러 오류 / 잘못된 값이 발생함 | "3 new errors. B7: ..." / "3 invalid values. B7: ..." | `aria_newErrors`, `aria_invalidValues` |
+| 잠긴 셀 / 범위의 편집이 거부됨 | "The cell is locked" / "Locked cells were not changed" | `aria_lockedCell`, `aria_lockedCells` |
+| 읽기 전용 모드에서 편집 키를 누름 | "The sheet is read-only" | `aria_readonlySheet` |
+| 검색 텍스트를 입력함 | "Results: 5. 1 of 5, B2" 또는 "No results" | `aria_searchResults`, `aria_searchMatch`, `aria_searchNoResults` |
+| 다음 또는 이전 일치 항목이 표시됨 | "2 of 5, B7" | `aria_searchMatch` |
+| Excel 파일을 내보냄 | "Exporting the file", "The file is exported" | `aria_exportStarted`, `aria_exportDone` |
+| 파일 대화 상자에서 선택한 파일을 가져옴 | "Importing the file", "The file is imported" | `aria_importStarted`, `aria_importDone` |
+| Column width / Row height 명령이 적용됨 | "Column width set to 120 pixels" | `aria_columnWidthSet`, `aria_rowHeightSet` |
+| Ctrl + Shift + 9 / 0으로 표시할 항목을 찾지 못함 | "No hidden rows in the selection" | `aria_noHiddenRows`, `aria_noHiddenCols` |
+
+사용자 고유의 명령 결과를 안내하려면 [`announce()`](api/spreadsheet_announce_method.md) 메서드를 호출하십시오.
+
+~~~jsx
+spreadsheet.announce("The report is saved");
+~~~
+
+## 현지화 {#localization}
+
+접근 가능한 이름, 셀 설명 및 안내는 인터페이스 레이블 옆에 `aria_` 접두사가 있는 키로 `spreadsheet` 로캘에 저장됩니다. Spreadsheet를 초기화하기 전에 `dhx.i18n.setLocale()` 메서드로 번역하십시오.
+
+~~~jsx
+dhx.i18n.setLocale("spreadsheet", {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_cellEditor: "Zelleneditor, {cell}",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt",
+ aria_selectedRange: "{range}, {count} Zellen",
+ aria_rangeExtent: "{start} bis {end}"
+});
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+`{cell}` 또는 `{count}`와 같이 중괄호로 묶인 부분은 값으로 대체되므로 번역된 문자열에서도 유지해야 합니다. 색상 이름과 알림 버튼의 이름은 `colorpicker` 및 `message` 로캘에서 가져옵니다. 전체 키 목록은 [Localization](localization.md#default-locale)을, 다른 로캘은 [Localizing built-in widgets](localization.md#localizing-built-in-widgets)를 참조하십시오.
+
+## 구성 예시 {#configuration-recipes}
+
+### 접근성을 고려한 기본 설정 {#accessible-default-setup}
+
+Spreadsheet는 키보드와 WAI-ARIA 출력을 위해 별도의 구성이 필요하지 않습니다. 텍스트에 대한 WCAG AA 대비 요구 사항을 충족하려면 고대비 테마를 선택하십시오. 테마를 설정하는 다른 방법은 [Built-in themes](/themes/)를 참조하십시오.
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ // the keyboard navigation and the WAI-ARIA output need no configuration
+});
+spreadsheet.parse(data);
+
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+### 읽기 전용 설정 {#read-only-setup}
+
+사용자가 읽고 복사할 수 있지만 변경할 수 없는 데이터를 표시하려면 [`readonly`](api/spreadsheet_readonly_config.md) 옵션을 사용하십시오. 키보드 및 스크린 리더 사용자는 여전히 셀 사이를 이동할 수 있습니다.
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ readonly: true
+});
+spreadsheet.parse(data);
+~~~
+
+활성 셀과 선택 없이 데이터를 표시하려면 [`selection: false`](api/spreadsheet_selection_config.md)를 추가하십시오. 그러면 그리드는 키보드가 통과하는 하나의 탭 정지점이 됩니다.
+
+### 번역된 접근성 문자열 {#translated-accessibility-strings}
+
+스크린 리더는 네 개의 로캘에서 접근성 문자열을 읽습니다. `spreadsheet`에는 이름, 셀 설명 및 안내가, `colorpicker`에는 색상 이름이, `message`에는 알림 버튼의 이름이, `grid`에는 로드된 행 수 안내가 포함됩니다. Spreadsheet를 생성하기 전에 네 가지 모두 설정하십시오. 키는 [Localizing built-in widgets](localization.md#localizing-built-in-widgets)를 참조하십시오.
+
+~~~jsx
+const deSpreadsheet = {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt"
+};
+const deColorpicker = {
+ aria_palette: "Farbpalette",
+ aria_colorRed: "rot"
+};
+const deMessage = {
+ aria_confirm: "Bestätigen"
+};
+const deGrid = {
+ aria_rowsLoaded: "{count} Zeilen geladen"
+};
+
+dhx.i18n.setLocale("spreadsheet", deSpreadsheet);
+dhx.i18n.setLocale("colorpicker", deColorpicker);
+dhx.i18n.setLocale("message", deMessage);
+dhx.i18n.setLocale("grid", deGrid);
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+### 사용자 지정 명령 안내 {#announcing-a-custom-command}
+
+사용자 고유의 명령이 데이터를 변경하는 경우 [`announce()`](api/spreadsheet_announce_method.md) 메서드로 스크린 리더 사용자에게 결과를 알려 주십시오. 이 예제는 활성 시트를 지우는 [메뉴](customization.md#menu) 명령을 추가합니다.
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+
+spreadsheet.menu.data.add({ id: "clear-sheet", value: "Clear sheet" });
+
+spreadsheet.menu.events.on("click", function (id) {
+ if (id === "clear-sheet") {
+ spreadsheet.sheets.clear();
+ spreadsheet.announce("The sheet is cleared");
+ }
+});
+~~~
+
+## 호스트 페이지의 책임 {#host-page-responsibilities}
+
+일부 요구 사항은 컴포넌트 내부가 아니라 페이지 수준에 있습니다. 호스트 페이지가 다음을 충족하는지 확인하십시오.
+
+- 문서 언어(예: ``)와 페이지 제목을 설정합니다
+- Spreadsheet 위에 제목을 두고 랜드마크(예: `| Esc | 변경 사항을 저장하지 않고 셀 편집기를 닫습니다 | +
| Alt (Option) + Enter | +활성 셀의 링크를 새 탭에서 엽니다 | +
| Ctrl + F6 | +포커스를 Spreadsheet의 다음 부분으로 이동합니다. 순서는 메뉴, 툴바, 시트(활성 셀), 시트 탭이며, 이후 다시 메뉴로 돌아갑니다. 수식 입력줄과 숨겨진 부분은 건너뜁니다. 먼저 편집 중인 셀의 값을 저장합니다 | +
| Ctrl + Shift + F6 | +포커스를 Spreadsheet의 이전 부분으로 이동합니다 | +
| Left Arrow/Right Arrow Key | +포커스를 툴바, 메뉴 바 또는 시트 탭의 이전/다음 컨트롤로 이동합니다 | +
| Home/End | +포커스를 바의 첫 번째/마지막 컨트롤로 이동합니다 | +
| Enter/Space | +포커스된 컨트롤을 누릅니다. 명령을 실행하거나, 드롭다운을 열거나, 포커스된 탭의 시트로 전환합니다 | +
| Down Arrow Key | +포커스된 컨트롤의 드롭다운을 열고 포커스를 첫 번째 항목으로 이동합니다 | +
| Up Arrow/Down Arrow Key | +열린 드롭다운 또는 메뉴의 항목 간에 포커스를 이동합니다 | +
| Right Arrow Key | +포커스된 메뉴 항목의 하위 메뉴를 엽니다 | +
| Left Arrow Key | +하위 메뉴를 닫습니다. 드롭다운의 첫 번째 수준에서는 드롭다운을 닫고 포커스를 해당 컨트롤로 되돌립니다 | +
| Esc | +드롭다운 또는 메뉴를 닫고 포커스를 이를 연 컨트롤로 되돌립니다. 툴바 컨트롤의 툴팁을 닫습니다. Esc를 누르지 않으면 포인터가 툴팁 위에 있는 동안 툴팁이 열린 상태로 유지됩니다 | +
| Shift + F10 or Menu key | +활성 셀 또는 포커스된 시트 탭의 컨텍스트 메뉴를 열고 포커스를 메뉴로 이동합니다. Ctrl (Cmd) + Space를 누른 후에는 셀의 컨텍스트 메뉴에 열에 대한 명령이 표시됩니다. Esc는 컨텍스트 메뉴를 닫고 포커스를 셀로 되돌립니다 | +
| Ctrl (Cmd) + G | -선택을 다음 검색 결과로 이동합니다 | +다음 검색 결과를 강조 표시합니다 |
| Ctrl (Cmd) + Shift + G | -선택을 이전 검색 결과로 이동합니다 | +이전 검색 결과를 강조 표시합니다 | +
| Esc | +검색 상자를 닫고 포커스를 활성 셀로 되돌립니다 |
| Ctrl (Cmd) + Shift + 9 | +선택한 범위 내의 숨겨진 행을 표시합니다 | +
| Ctrl (Cmd) + Shift + 0 | +선택한 범위 내의 숨겨진 열을 표시합니다 | +
| Arrow keys | +팔레트의 색상 간 또는 Border 팝업의 컨트롤 간에 포커스를 이동합니다 | +
| Home/End | +포커스를 팔레트의 첫 번째/마지막 색상으로 이동합니다 | +
| Enter | +포커스된 색상 또는 테두리를 적용합니다. 텍스트 색상 또는 배경색을 적용한 후 포커스는 활성 셀로 돌아갑니다 | +
| Esc | +사용자 지정 색상 모드에서 팔레트로 돌아갑니다. Border 팝업 위에 열린 색상 또는 스타일 팝업에서는 해당 팝업을 닫고 포커스를 Border 팝업의 버튼으로 되돌립니다. 그 외에는 팝업을 닫고 포커스를 해당 툴바 컨트롤로 되돌립니다 | +
| Tab/Tab + Shift | +팝업을 닫고 포커스를 해당 툴바 컨트롤로 되돌립니다. Border 팝업과 그 위에 열린 팝업에서는 모두 닫고 포커스를 Border 컨트롤로 되돌립니다. 사용자 지정 색상 모드에서는 색상 선택기의 컨트롤 간에 포커스를 이동합니다 | +
| Up Arrow/Down Arrow Key | +값 목록을 따라 이동합니다 | +
| Enter | +값을 선택하고 편집기를 닫습니다 | +
| Esc | +변경 사항을 저장하지 않고 편집기를 닫습니다 | +
| Tab | +값을 저장하고 선택을 한 셀 오른쪽으로 이동합니다 | +
| Esc | +필터 팝업을 닫고 포커스를 셀로 되돌립니다 | +
| Enter | +열 너비 및 행 높이 대화 상자에서 크기를 적용합니다 | +
| Esc | +변경 없이 열 너비 및 행 높이 대화 상자를 닫습니다 |
Other content
~~~
- HTMLElement로 지정된 컨테이너에 테마 설정
~~~html
-
+
Other content
~~~
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/using_typescript.md b/i18n/ko/docusaurus-plugin-content-docs/current/using_typescript.md
index 7124293b..3c0e4083 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/using_typescript.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/using_typescript.md
@@ -1,7 +1,7 @@
---
sidebar_label: TypeScript 지원
title: TypeScript 지원
-description: DHTMLX JavaScript Spreadsheet 라이브러리와 TypeScript 사용에 대한 문서를 확인하세요. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 사용해보며, DHTMLX Spreadsheet의 30일 무료 평가판을 다운로드하세요.
+description: DHTMLX Spreadsheet에 내장된 TypeScript 정의로 IDE에서 타입 검사, 자동 완성, JSDoc 힌트를 사용합니다.
---
# TypeScript 지원 {#typescript-support}
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/vuejs_integration.md b/i18n/ko/docusaurus-plugin-content-docs/current/vuejs_integration.md
index 72ec8868..baa9e2e7 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/vuejs_integration.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/vuejs_integration.md
@@ -1,7 +1,7 @@
---
sidebar_label: Vue 통합
title: Vue 통합
-description: DHTMLX JavaScript Spreadsheet 라이브러리의 Vue 통합에 대한 내용을 문서에서 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: Vue 애플리케이션에서 DHTMLX Spreadsheet를 사용하는 방법입니다. 프로젝트를 만들고, Spreadsheet를 Vue 컴포넌트로 추가하고, 데이터를 로드하고, 이벤트를 처리합니다.
---
# Vue 통합 {#integration-with-vue}
@@ -260,6 +260,10 @@ export default {
//...
~~~
+:::info
+`destructor()` 메서드는 `spreadsheet.events.on()`으로 연결한 이벤트 핸들러를 제거합니다. 새 Spreadsheet 인스턴스를 생성할 때(예: 컴포넌트가 다시 생성될 때) 새 인스턴스에 핸들러를 다시 연결하세요.
+:::
+
그런 다음 앱을 시작하면 페이지에 데이터가 로드된 Spreadsheet를 볼 수 있습니다.
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/whats_new.md b/i18n/ko/docusaurus-plugin-content-docs/current/whats_new.md
index a67ce1a2..fb8d0bbe 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/whats_new.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/whats_new.md
@@ -1,13 +1,78 @@
---
sidebar_label: 새로운 기능
title: DHTMLX Spreadsheet의 새로운 기능
-description: DHTMLX JavaScript Spreadsheet 라이브러리의 새로운 기능에 대한 내용을 문서에서 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: 버전별 새 기능, 업데이트, 수정 사항, 호환성이 깨지는 변경 사항을 담은 DHTMLX Spreadsheet 릴리스 노트입니다.
---
# 새로운 기능 {#whats-new}
이전 버전에서 Spreadsheet를 업그레이드하는 경우 [최신 버전으로 마이그레이션](migration.md)에서 자세한 내용을 확인하세요.
+## 버전 6.0.4 {#version-604}
+
+2026년 11월 2일 출시
+
+### 새로운 기능 {#new-functionality-604}
+
+- WCAG 2.2 AA, Section 508 및 EN 301 549를 목표로 하는 접근성 지원: Spreadsheet 모든 부분의 키보드 조작, 스크린 리더 지원, 모든 테마에서 눈에 보이는 포커스. [접근성](accessibility.md) 가이드와 [접근성 적합성 보고서](accessibility_conformance_report.md)를 확인하세요
+- 셀 선택을 끄고 켜는 기능:
+ - 새로운 구성 속성: [`selection`](api/spreadsheet_selection_config.md)
+ - selection 모듈의 새로운 메서드: [`enable()`](api/selection_enable_method.md), [`disable()`](api/selection_disable_method.md), [`isDisabled()`](api/selection_isdisabled_method.md)
+- [`announce()`](api/spreadsheet_announce_method.md) 메서드는 스크린 리더에 상태 메시지를 전달합니다
+- [컨텍스트 메뉴](customization.md#context-menu)의 새로운 명령: [*열 너비*, *행 높이*](work_with_rows_cols.md#setting-column-width-and-row-height) 및 [*필터 열기*](filtering_data.md#opening-a-filter-with-the-keyboard)
+
+### 업데이트 {#updates-604}
+
+- 키보드 탐색 ([단축키 목록](hotkeys.md) 확인):
+ - 포커스가 활성 셀에 유지되며, `Tab` 및 `Shift + Tab`은 시트의 마지막 셀과 첫 번째 셀에서 셀 영역을 벗어나고, `Ctrl + F6`은 메뉴, 툴바, 시트, 시트 탭 간에 포커스를 이동합니다
+ - 툴바, 메뉴 바, 시트 탭은 방향키로 탐색하는 단일 탭 정지점입니다
+ - 새로운 단축키가 추가되었습니다. 예를 들어 컨텍스트 메뉴용 `Shift + F10`, 숨겨진 행과 열을 표시하는 `Ctrl (Cmd) + Shift + 9` / `Ctrl (Cmd) + Shift + 0`이 있습니다
+ - 툴바의 색상 및 테두리 팝업은 열릴 때 포커스를 받고 `Esc` 및 `Tab`으로 닫힙니다
+- 방향키는 반대편 가장자리로 이동하지 않고 첫 번째 및 마지막 표시된 행과 열에서 멈추며, 가장자리에서 방향키를 누르면 선택한 범위가 활성 셀로 줄어듭니다
+- 입력기(IME)로 작성한 텍스트가 활성 셀에 표시되고 [`startEdit()`](api/spreadsheet_startedit_method.md) 메서드를 통해 편집이 시작되므로 이 경우 `beforeEditStart` 및 `afterEditStart` 이벤트가 발생합니다
+- [`setFocusedCell()`](api/selection_setfocusedcell_method.md) 메서드는 키보드 포커스를 셀로 이동합니다
+- [셀의 링크](work_with_cells.md#inserting-a-hyperlink-into-a-cell)는 새 탭에서 열리는 실제 링크로 렌더링되며, `Alt (Option) + Enter`는 활성 셀의 링크를 엽니다
+- [읽기 전용 모드](api/spreadsheet_readonly_config.md)는 키보드 탐색, 선택, 복사, 검색을 유지하며, 스크린 리더는 거부된 편집을 안내합니다. 선택을 끄려면 `selection: false` 옵션을 사용하세요
+- [병합된 셀을 통한 행 또는 열 제거](merge_cells.md#removing-rows-and-columns-of-merged-cells)는 병합된 셀의 모든 행 또는 열을 제거합니다
+- [`spreadsheet` 로케일](localization.md#default-locale)의 새로운 인터페이스 및 스크린 리더 문자열과 [기본 제공 위젯의 번역](localization.md#localizing-built-in-widgets)
+- 키보드 포커스용 [`--dhx-spreadsheet-focus-color`](/themes/#spreadsheet-specific-styles) 변수와, 라이트 테마에서 더 높은 대비를 가지는 수식 참조 색상
+
+### 수정 사항 {#fixes-604}
+
+- 병합된 셀 앞의 행 또는 열이 삭제될 때 병합된 셀이 이동하지 않고 삭제되는 문제. 이제 셀이 하나만 남은 병합된 셀은 일반 셀이 되며 값을 유지합니다
+- 병합된 셀을 통해 행 또는 열을 삭제하면 병합의 한 줄만 제거되는 문제
+- 행과 열 제거용 컨텍스트 메뉴 레이블이 제거될 병합된 셀의 모든 행 또는 열을 표시하지 않는 문제
+- 행이 필터링된 전체 범위를 포함할 때 삭제되지 않는 문제
+- 고정된 행 또는 열이 삭제될 때 고정 영역이 줄어들지 않는 문제
+- 드래그한 셀에 일반 숫자가 없을 때 자동 채우기에서 오류가 발생하는 문제
+- 첫 번째 또는 마지막 행이나 열이 숨겨진 상태에서 `Home`, `End`, `Ctrl (Cmd) + Home`, `Ctrl (Cmd) + End` 및 `Ctrl (Cmd) + Arrow` 키를 누르면 페이지가 멈추는 문제
+- 셀을 Excel로 복사하거나 Excel 또는 Spreadsheet 내에서 붙여넣을 때 글꼴 크기가 사라지는 문제
+- 잘못된 값 툴팁이 잘못된 셀에서 떨어진 위치에 나타나거나 표시되지 않는 문제
+- 방향키를 사용한 후 목록 편집기에서 `Esc` 및 `Tab`이 작동하지 않는 문제
+- 검색이 두 번째 일치 항목을 먼저 강조 표시하고 편집이나 시트 전환 후 결과를 새로 고치지 않는 문제
+- WebAssembly가 없는 브라우저에서 가져오기 또는 내보내기 시 스크립트 오류가 발생하는 문제
+- `destructor()` 후에 document 리스너와 내부 위젯이 남아 있는 문제
+- 검색 바가 닫힌 후 키보드 포커스가 사라지는 문제
+- 닫힌 컨텍스트 메뉴가 다시 열리는 문제
+- 키보드 탐색 중 활성 셀이 뷰포트 가장자리보다 한 셀 모자라게 스크롤되는 문제
+- 잘못된 참조가 있는 수식에 단일 `#REF!` 대신 깨지거나 반복된 `#REF!` 오류가 표시되는 문제
+
+### React Spreadsheet {#react-spreadsheet-604}
+
+React Spreadsheet에는 위에 나열된 Spreadsheet의 모든 업데이트와 수정 사항이 포함됩니다. 아래는 React 래퍼에만 해당하는 변경 사항입니다.
+
+#### 업데이트 {#react-updates-604}
+
+- 새로운 [`selection`](react/props.md#runtime-props) prop
+- [`ISelection`](react/types.md#re-exported-upstream-types) 타입 재내보내기
+- [`readonly`](react/props.md#init-only-props)가 초기화 전용 prop으로 변경
+
+#### 수정 사항 {#react-fixes-604}
+
+- init-only prop 변경으로 Spreadsheet가 다시 생성된 후 이벤트 콜백과 `onStateChange`가 발생하지 않는 문제
+- 언마운트 시 래퍼의 이벤트 핸들러가 제거되지 않는 문제
+- `loadUrl`의 데이터가 마운트 시 두 번 로드되고, Spreadsheet가 다시 생성된 후 유지된 데이터 위에 다시 로드되는 문제
+
## 버전 6.0.3 {#version-603}
2026년 8월 24일 출시
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/work_with_cells.md b/i18n/ko/docusaurus-plugin-content-docs/current/work_with_cells.md
index d2d112c4..efdf8163 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/work_with_cells.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/work_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: 셀 편집
title: 셀 편집
-description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 셀 작업에 대한 내용을 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: DHTMLX Spreadsheet에서 셀을 편집합니다. 내용 입력, 하이퍼링크 삽입, 드롭다운 목록 사용, 여러 셀 채우기, Excel과 셀 복사 및 셀 잠금을 다룹니다.
---
# 셀 편집 {#editing-cells}
@@ -145,14 +145,27 @@ description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 셀 작
- 1, 3, 5, 7, 9, ... 시리즈를 만들려면 처음 두 셀에 1과 3을 입력하세요.
- 2, 4, 6, 8, 10, ... 시리즈를 만들려면 처음 두 셀에 2와 4를 입력하세요.
- 숫자 외에도 패턴에 문자를 사용할 수 있습니다. 예를 들어 1, a, 2, b, 3, a, 4, b, ... 같은 시리즈를 만들려면 처음 네 셀에 1, a, 2, b를 입력하세요.
+ - 텍스트 끝의 숫자를 이어가려면 처음 값을 입력하세요. 예를 들어 item1, item2, item3, ... 시리즈를 만들려면 처음 두 셀에 item1과 item2를 입력하세요.
+ - 날짜 시리즈를 만들려면 첫 번째 셀에 날짜를 입력하세요. 이후 각 셀은 다음 날짜로 채워집니다.
+- 텍스트 반복
+
+예를 들어 North, South, North, South, ... 시리즈를 만들려면 처음 두 셀에 North와 South를 입력하세요. *텍스트* 형식의 셀에 있는 숫자도 같은 방식으로 반복됩니다.
3\. **채우기 핸들**을 드래그하세요.
+## Excel과 셀 복사 {#copying-cells-to-and-from-excel}
+
+**Ctrl (Cmd) + C**로 셀을 복사하고 **Ctrl (Cmd) + V**로 붙여넣을 수 있습니다. Spreadsheet 내에서, 그리고 Spreadsheet와 Microsoft Excel 간에 사용할 수 있습니다:
+
+- Spreadsheet 내에서는 셀이 값, 수식, 스타일, 숫자 형식, 링크를 유지합니다. 수식의 셀 참조는 새 위치에 맞게 이동합니다
+- Excel에서는 붙여넣은 셀이 값(수식이 아닌 수식의 결과), 스타일(글꼴 크기 포함), 병합된 셀, 링크를 가집니다. 필터로 숨겨진 행은 건너뜁니다
+- Excel에서 복사한 셀을 Spreadsheet에 붙여넣으면 값, 스타일(글꼴 크기 포함), 숫자 형식, 병합된 셀, 링크가 유지됩니다
+
## 셀 잠금 {#locking-cells}
-셀을 잠가 값이 변경되지 않도록 보호할 수 있습니다. 셀을 잠그면 오른쪽 상단 모서리에 회색 "열쇠" 아이콘이 표시됩니다. 잠긴 셀은 편집 시도에 응답하지 않습니다.
+셀을 잠가 값이 변경되지 않도록 보호할 수 있습니다. 셀을 잠그면 오른쪽 상단 모서리에 회색 "열쇠" 아이콘이 표시됩니다. 잠긴 셀은 편집 시도에 응답하지 않습니다. 스크린 리더는 거부된 편집을 안내합니다. 단일 셀에는 "The cell is locked", 선택한 범위에 잠긴 셀이 포함된 경우에는 "Locked cells were not changed"라고 안내합니다.
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/work_with_rows_cols.md b/i18n/ko/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
index 2539f976..ec0f2010 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
@@ -1,7 +1,7 @@
---
sidebar_label: 행과 열 작업
title: 행과 열 작업
-description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 행과 열 작업에 대한 내용을 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: DHTMLX Spreadsheet에서 행과 열 작업을 수행합니다. 추가 및 제거, 열 너비 자동 맞춤, 열 너비와 행 높이 설정, 고정, 숨기기와 표시를 다룹니다.
---
# 행과 열 작업 {#work-with-rows-and-columns}
@@ -54,6 +54,10 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
여러 행을 한 번에 제거하려면 행들을 선택하고, 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴를 열고 *행 -> 행 제거 [ids]*를 선택하세요.
:::
+:::info
+선택한 셀이 병합된 셀 안에 있으면 병합된 셀의 모든 행이 제거됩니다. 자세한 내용은 [셀 병합](merge_cells.md#removing-rows-and-columns-of-merged-cells) 문서를 확인하세요.
+:::
+
### 열 추가 {#adding-columns}
새 열을 추가하려면 다음 단계를 따르세요:
@@ -98,6 +102,10 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
여러 열을 한 번에 제거하려면 열들을 선택하고, 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴를 열고 *열 -> 열 제거 [ids]*를 선택하세요.
:::
+:::info
+선택한 셀이 병합된 셀 안에 있으면 병합된 셀의 모든 열이 제거됩니다. 자세한 내용은 [셀 병합](merge_cells.md#removing-rows-and-columns-of-merged-cells) 문서를 확인하세요.
+:::
+
## 열 너비 자동 맞춤 {#autofit-column-width}
열 너비를 열의 가장 긴 내용에 자동으로 맞추려면 다음 방법 중 하나를 사용할 수 있습니다:
@@ -116,6 +124,50 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
+## 열 너비와 행 높이 설정 {#setting-column-width-and-row-height}
+
+### 열 너비 설정 {#setting-column-width}
+
+열의 정확한 너비를 설정하려면 다음 단계를 따르세요:
+
+1\. 열 또는 해당 열의 셀을 선택하세요. 여러 열을 변경하려면 해당 열에 걸친 셀 범위를 선택하세요.
+
+2\. 선택 영역을 마우스 오른쪽 버튼으로 클릭하거나 `Shift + F10` 또는 Menu 키를 누른 다음 *열 -> 열 너비*를 선택하세요. 같은 명령을 열의 점 3개 아이콘 메뉴에서도 사용할 수 있습니다.
+
+
+
+3\. *열 너비* 대화상자에서 너비를 픽셀 단위로 입력하고 **적용**을 클릭하거나 `Enter`를 누르세요.
+
+
+
+### 행 높이 설정 {#setting-row-height}
+
+행의 정확한 높이를 설정하려면 다음 단계를 따르세요:
+
+1\. 행 또는 해당 행의 셀을 선택하세요. 여러 행을 변경하려면 해당 행에 걸친 셀 범위를 선택하세요.
+
+2\. 선택 영역을 마우스 오른쪽 버튼으로 클릭하거나 `Shift + F10` 또는 Menu 키를 누른 다음 *행 -> 행 높이*를 선택하세요.
+
+
+
+3\. *행 높이* 대화상자에서 높이를 픽셀 단위로 입력하고 **적용**을 클릭하거나 `Enter`를 누르세요.
+
+
+
+### 새 크기 적용 방식 {#how-the-new-size-is-applied}
+
+대화상자에는 선택한 범위의 첫 번째 열 또는 행의 현재 크기가 표시되며, 새 크기는 해당 범위의 모든 열 또는 행에 적용됩니다. 여러 범위를 선택한 경우 마지막으로 선택한 범위가 사용됩니다.
+
+크기는 정수 픽셀로 반올림됩니다. 열의 최소 너비는 20px, 행의 최소 높이는 10px이며, 이보다 작은 양수 값은 최솟값으로 대체됩니다. 필드가 비어 있거나 값이 양수가 아닌 동안에는 **적용** 버튼이 비활성화됩니다.
+
+**취소** 버튼 또는 `Esc`는 변경 없이 대화상자를 닫습니다. 스크린 리더는 새 크기를 안내합니다. 예: "Column width set to 120 pixels".
+
+### 변경 취소 {#undoing-the-change}
+
+새 크기는 `Ctrl (Cmd) + Z`로 취소할 수 있습니다.
+
+코드에서 변경을 처리하려면 `resizeCol` 및 `resizeRow` [액션](api/overview/actions_overview.md#list-of-actions)을 사용하세요.
+
## 행과 열 고정/해제 {#freezingunfreezing-rows-and-columns}
### 행 고정 {#freezing-rows}
@@ -212,6 +264,10 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
+:::info
+활성 셀이 숨겨지는 행에 있으면 활성 셀은 그 아래의 첫 번째 표시된 행으로 이동하고, 선택 영역은 이 셀로 줄어듭니다. 아래에 표시된 행이 없으면 위쪽의 마지막 표시된 행으로 이동합니다.
+:::
+
### 행 표시 {#showing-rows}
숨겨진 행을 표시하려면 다음 단계 중 하나를 따르세요:
@@ -228,6 +284,8 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
+- 또는 행이나 여러 셀을 선택하여 숨겨진 행이 선택 범위에 포함되도록 한 후 `Ctrl (Cmd) + Shift + 9`를 누르세요. 예를 들어 숨겨진 3행을 표시하려면 2-4행을 선택하세요. 선택 범위에 숨겨진 행이 없으면 스크린 리더가 "No hidden rows in the selection"이라고 안내합니다
+
### 열 숨기기 {#hiding-columns}
열을 숨기려면 다음 단계를 따르세요:
@@ -244,6 +302,10 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
+:::info
+활성 셀이 숨겨지는 열에 있으면 활성 셀은 그 오른쪽의 첫 번째 표시된 열로 이동하고, 선택 영역은 이 셀로 줄어듭니다. 오른쪽에 표시된 열이 없으면 왼쪽의 마지막 표시된 열로 이동합니다.
+:::
+
### 열 표시 {#showing-columns}
숨겨진 열을 표시하려면 다음 단계 중 하나를 따르세요:
@@ -259,3 +321,5 @@ DHTMLX Spreadsheet를 사용하면 툴바 버튼, 메뉴 옵션, 셀 컨텍스
(*아래 이미지에서 C열이 숨겨져 있습니다*)
+
+- 또는 열이나 여러 셀을 선택하여 숨겨진 열이 선택 범위에 포함되도록 한 후 `Ctrl (Cmd) + Shift + 0`을 누르세요. 선택 범위에 숨겨진 열이 없으면 스크린 리더가 "No hidden columns in the selection"이라고 안내합니다
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/work_with_sheets.md b/i18n/ko/docusaurus-plugin-content-docs/current/work_with_sheets.md
index 1638f507..346db91f 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/work_with_sheets.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/work_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: 시트 작업
title: 시트 작업
-description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 시트 작업에 대한 내용을 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: DHTMLX Spreadsheet에서 하단 툴바와 시트 탭으로 시트를 추가, 제거, 이름 변경, 전환하고 수식에서 다른 시트의 셀을 참조합니다.
---
# 시트 작업 {#work-with-sheets}
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/working_with_cells.md b/i18n/ko/docusaurus-plugin-content-docs/current/working_with_cells.md
index 87f16dbb..4392fbe2 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/working_with_cells.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/working_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: 셀 작업
title: 셀 작업
-description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 셀 작업에 대한 내용을 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: API로 DHTMLX Spreadsheet 셀의 값과 스타일을 설정하고 가져오며, 셀 유효성 검사, 링크 삽입, 셀 편집, 잠금, 병합, 선택을 수행합니다.
---
# 셀 작업 {#work-with-cells}
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/working_with_sheets.md b/i18n/ko/docusaurus-plugin-content-docs/current/working_with_sheets.md
index a442b538..2f72868f 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/working_with_sheets.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/working_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: 시트 작업
title: 시트 작업
-description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 시트 작업에 대한 내용을 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: DHTMLX Spreadsheet에 여러 시트를 로드하고 API 메서드로 시트를 추가, 제거, 가져오기, 지우기, 전환합니다.
---
# 시트 작업 {#work-with-sheets}
diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/working_with_ssheet.md b/i18n/ko/docusaurus-plugin-content-docs/current/working_with_ssheet.md
index 29d030e7..1707f27a 100644
--- a/i18n/ko/docusaurus-plugin-content-docs/current/working_with_ssheet.md
+++ b/i18n/ko/docusaurus-plugin-content-docs/current/working_with_ssheet.md
@@ -1,7 +1,7 @@
---
sidebar_label: Spreadsheet 작업
title: Spreadsheet 작업
-description: DHTMLX JavaScript Spreadsheet 라이브러리 문서에서 스프레드시트 작업에 대한 내용을 확인할 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험해 보세요. 또한 DHTMLX Spreadsheet의 무료 30일 평가판을 다운로드할 수 있습니다.
+description: API로 DHTMLX Spreadsheet에서 작업을 실행 취소 및 다시 실행하고, 행과 열을 추가, 제거, 고정, 숨기고, 열 너비를 자동 맞춤하며, 데이터를 필터링, 검색, 정렬하고 스프레드시트를 지웁니다.
---
# Spreadsheet 작업 {#work-with-spreadsheet}
@@ -282,7 +282,7 @@ v4.3부터 [`sortCells()`](api/spreadsheet_sortcells_method.md) 메서드를 사
- `dir` - 정렬 방향: 1 - 오름차순, -1 - 내림차순
~~~jsx {5}
-const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// 구성 파라미터
});
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current.json b/i18n/ru/docusaurus-plugin-content-docs/current.json
index cf6ba12a..a3027ba0 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current.json
+++ b/i18n/ru/docusaurus-plugin-content-docs/current.json
@@ -83,6 +83,10 @@
"message": "Работа с ячейками",
"description": "The generated-index page title for category 'Work with cells' in sidebar 'docs'"
},
+ "sidebar.docs.category.Accessibility": {
+ "message": "Доступность",
+ "description": "The label for category 'Accessibility' in sidebar 'docs'"
+ },
"sidebar.docs.category.Frameworks & integrations": {
"message": "Фреймворки и интеграции",
"description": "The label for category 'Frameworks & integrations' in sidebar 'docs'"
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/.sync b/i18n/ru/docusaurus-plugin-content-docs/current/.sync
index 96f6c508..0532604c 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-2b6d3c2fd433461ffce34526974de3f1ba5161a8
+9ff2cef64e00d4e77947433a670dc5d573fcc7f4
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/accessibility.md b/i18n/ru/docusaurus-plugin-content-docs/current/accessibility.md
new file mode 100644
index 00000000..1c1ed55e
--- /dev/null
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/accessibility.md
@@ -0,0 +1,449 @@
+---
+sidebar_label: Доступность
+title: Доступность
+description: Сделайте DHTMLX Spreadsheet доступным для пользователей клавиатуры и скринридеров. Узнайте о поддержке WAI-ARIA, навигации с клавиатуры, голосовых уведомлениях скринридеров и высококонтрастных темах, соответствующих WCAG 2.2 AA.
+---
+
+# Доступность в DHTMLX Spreadsheet
+
+Это руководство предназначено для разработчиков, которые встраивают DHTMLX Spreadsheet в приложение с требованиями к доступности. Используйте его, чтобы сверить компонент со своим чек-листом и настроить его для пользователей клавиатуры, скринридеров и высококонтрастных тем.
+
+Spreadsheet выводит в разметке роли и состояния WAI-ARIA. Фокус клавиатуры остается на активной ячейке, а панель инструментов, строка меню и вкладки листов представляют собой по одной точке табуляции. Изменения, у которых нет собственного элемента, например отклоненное редактирование или результат поиска, попадают в live-область, которую скринридеры зачитывают вслух.
+
+:::info Целевое соответствие
+DHTMLX Spreadsheet разработан в соответствии с **WCAG 2.2 Level AA**, **Section 508** закона США Rehabilitation Act и **EN 301 549** (техническая основа European Accessibility Act).
+
+Соответствие отражено по каждому критерию для DHTMLX Spreadsheet 6.0.4. Доступен подробный **Отчет о соответствии требованиям доступности (VPAT® 2.5)**: [Accessibility Conformance Report](accessibility_conformance_report.md).
+:::
+
+## Возможности {#capabilities}
+
+| Область | Поддержка |
+| ---- | ------- |
+| Работа с клавиатуры | У каждой команды для ячеек есть клавиша. Панель инструментов, строка меню и вкладки листов представляют собой единые точки табуляции, навигация по ним выполняется стрелками. Для ширины столбца, высоты строки и фильтра столбца есть команды контекстного меню, поэтому перетаскивание или щелчок по иконке не требуются |
+| Семантика WAI-ARIA | Ячейки образуют `grid` с элементами `columnheader`, `rowheader` и `gridcell`. Роли выводятся всегда |
+| Модель фокуса | Фокус клавиатуры находится на активной ячейке. Tab входит в лист на активную ячейку и покидает его с последней и первой ячейки. Ctrl + F6 перемещает фокус между меню, панелью инструментов, листом и вкладками листов |
+| Модель выделения | Активная ячейка, диапазон и несколько диапазонов передаются через `aria-selected`, а размер диапазона озвучивается. Выделение можно отключить с помощью опции [`selection`](api/spreadsheet_selection_config.md) |
+| Режим только для чтения | По листу можно перемещаться, выделять, копировать и искать; редактирование отклоняется и озвучивается, контекстное меню недоступно |
+| Скринридеры | Протестировано с NVDA, JAWS и VoiceOver |
+| Визуальная доступность | Темы `contrast-light` и `contrast-dark`, видимый индикатор фокуса в каждой теме и признаки, не зависящие от цвета |
+| Масштабирование текста и страницы | Интерфейс остается работоспособным при масштабе 200% и 400% и при переопределении межстрочных и межбуквенных интервалов |
+| Настройка | Публичный метод [`announce()`](api/spreadsheet_announce_method.md) для собственных сообщений и переводимые строки локали `aria_*` для каждого встроенного имени и уведомления |
+| Стандарты | WCAG 2.2 AA, Section 508, EN 301 549 |
+
+## Охватываемые области {#covered-areas}
+
+Это руководство охватывает виджет Spreadsheet:
+
+- ячейки, заголовки столбцов и строк, объединенные ячейки и закрепленные строки и столбцы
+- выделение: активная ячейка, диапазоны и несколько диапазонов
+- строка формул и редакторы ячеек, включая редактор ячейки со списком значений
+- панель инструментов с popup-окнами выбора цвета и границ, строка меню и контекстные меню
+- вкладки листов
+- сортировка, фильтрация, поиск, валидация данных, ссылки в ячейках, импорт и экспорт
+- темы и индикатор фокуса
+
+Доступность итоговой страницы также зависит от приложения-хоста. См. [Ответственность страницы-хоста](#host-page-responsibilities).
+
+## Поддержка WAI-ARIA {#wai-aria-support}
+
+Spreadsheet автоматически добавляет в разметку роли и атрибуты WAI-ARIA, отключить их нельзя. У каждой части виджета есть своя роль и имя, а имена берутся из [локали](#localization).
+
+### Контейнер Spreadsheet {#spreadsheet-container}
+
+Части Spreadsheet представляют собой отдельные именованные элементы управления:
+
+| Часть | Роль / атрибут | Доступное имя |
+| ---- | ---------------- | --------------- |
+| Строка меню | `role="menubar"` + `aria-label` | "Main" |
+| Панель инструментов | `role="toolbar"` + `aria-label` | "Formatting" |
+| Строка формул | `aria-label` на поле ввода | "Formula bar, B7", с адресом активной ячейки |
+| Ячейки | `role="grid"` + `aria-label` | "Spreadsheet" |
+| Вкладки листов | `role="toolbar"` + `aria-label` | "Sheets" |
+| Live-область | `role="status"`, `aria-live="polite"`, `aria-atomic="true"` | визуально скрыта, расположена рядом с гридом вне `role="grid"` |
+
+У корневого элемента Spreadsheet нет роли ориентира (landmark), поэтому вы можете поместить его в подходящий для вашей страницы ориентир.
+
+### Поверхность ячеек {#cell-surface}
+
+Следующие атрибуты описывают ячейки в целом. Их содержит элемент `.dhx_grid-content`:
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| `.dhx_grid-content` | `role="grid"` | Интерактивный грид ячеек |
+| `.dhx_grid-content` | `aria-label` | "Spreadsheet", из ключа локали `aria_grid` |
+| `.dhx_grid-content` | `aria-rowcount` | Количество строк листа плюс строка заголовка |
+| `.dhx_grid-content` | `aria-colcount` | Количество видимых столбцов плюс столбец с номерами строк |
+| `.dhx_grid-content` | `aria-readonly` | `"true"` в [режиме только для чтения](api/spreadsheet_readonly_config.md) и пока [выделение](api/spreadsheet_selection_config.md) отключено |
+| `.dhx_grid-content` | `aria-multiselectable` | `"true"`; `"false"`, пока выделение отключено |
+
+### Строки и ячейки {#rows-and-cells}
+
+В следующей таблице перечислены роли, а также атрибуты позиции и состояния строк и ячеек:
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| Строка | `role="row"` + `aria-rowindex` | Строка листа. У строки 1 листа `aria-rowindex="2"`, так как заголовок столбцов является первой строкой |
+| Ячейка | `role="gridcell"` + `aria-colindex` | Ячейка. У столбца A `aria-colindex="2"`, так как номера строк являются первым столбцом |
+| Номер строки | `role="rowheader"` | Заголовок строки |
+| Ячейка | `aria-selected` | `"true"` на активной ячейке и на каждой ячейке выделенных диапазонов |
+| Ячейка | `aria-readonly` | `"true"` в режиме только для чтения, пока [выделение](api/spreadsheet_selection_config.md) отключено, и на [заблокированных ячейках](work_with_cells.md#locking-cells) |
+| Ячейка | `tabindex` | `"0"` на активной ячейке и `"-1"` на остальных, поэтому ячейки представляют собой одну точку табуляции |
+| Активная ячейка | DOM-фокус | Фокус клавиатуры находится на самой активной ячейке, а не на отдельном поле ввода. Пока ячейка редактируется, фокус находится на редакторе ячейки |
+| Объединенная ячейка | `aria-colspan` / `aria-rowspan` | Количество столбцов или строк, которые занимает объединенная ячейка. Покрытые ею ячейки скрыты с помощью `aria-hidden="true"` |
+| Ссылка в ячейке | `` с `target="_blank"` и `rel="noopener noreferrer"` | Ссылка со схемой `http`, `https`, `mailto`, `ftp` или `tel` |
+
+Ячейка также содержит визуально скрытый текст, который скринридеры зачитывают вместе со значением:
+
+| Скрытый текст | Когда |
+| ----------- | ---- |
+| Адрес ячейки, например "B7" | На активной ячейке и на каждой ячейке выделенного диапазона. Скринридеры зачитывают адрес перед значением |
+| "link" | На выделенной ячейке со ссылкой. Alt + Enter открывает ссылку |
+| "locked" | На выделенной заблокированной ячейке |
+| Описание ошибки формулы, например "Reference error. Check the cell references" | На ячейке с ошибкой формулы |
+| "Invalid value. Choose a value from the list" | На ячейке, значения которой нет в ее [списке значений](work_with_cells.md#using-drop-down-lists-in-cells) |
+| "Filter" / "Filter applied" | На ячейке с иконкой фильтра |
+
+### Заголовки столбцов и строк {#column-and-row-headers}
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| Буква столбца | `role="columnheader"` + `aria-colindex` | Заголовок столбца |
+| Угол выделения всего листа | `role="columnheader"` | Имя "Select all" |
+| Номер строки | `role="rowheader"` | Заголовок строки |
+| Иконка меню столбца, иконки скрытых строк и столбцов | `aria-hidden="true"` | Декоративные. Команды находятся в контекстном меню |
+
+Заголовки не являются точками табуляции. Щелчок по букве столбца, номеру строки или углу выделяет строки или столбцы и возвращает фокус на активную ячейку.
+
+### Строка формул и редакторы {#formula-bar-and-editors}
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| Поле ввода строки формул | `aria-label` | "Formula bar, B7", с адресом активной ячейки. На заблокированной ячейке поле ввода имеет атрибут `readonly`, поэтому его значение по-прежнему можно прочитать. Пока выделение отключено, строка формул пуста и заблокирована |
+| Поле ввода редактора ячейки | `aria-label` | "Cell editor, B7" |
+| Редактор ячейки со списком значений | `role="combobox"`, `aria-controls`, `aria-expanded`, `aria-activedescendant` | Список значений представляет собой `listbox` из элементов `option`, а у выделенной опции есть `aria-selected` |
+| Редактор с недопустимым значением | `aria-invalid="true"` | Сохраненного значения ячейки нет в ее списке значений. Атрибут обновляется после сохранения значения, а не во время ввода |
+| Иконка закрытия справки по формуле | `role="button"` + `aria-label` | "Close formula help" |
+
+### Панель инструментов и меню {#toolbar-and-menus}
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| Панель инструментов | `role="toolbar"` + `aria-label` | "Formatting"; панели инструментов popup-окна границ, строки поиска и popup-окна ссылки называются "Borders", "Search" и "Link" |
+| Кнопка панели инструментов | `aria-label` | Значение кнопки. Кнопка с иконкой получает имя из подсказки, например "Bold (ctrl+b)". Иконки скрыты с помощью `aria-hidden="true"` |
+| Bold, Italic, Underline, Strikethrough, Lock, Filter | `aria-pressed` | Включено ли форматирование или фильтр |
+| Кнопка, открывающая выпадающий список | `aria-haspopup="menu"`, `aria-expanded` | Выпадающий список представляет собой `menu`, названное по своей кнопке |
+| Выравнивание, перенос текста, числовые форматы | `role="menuitemradio"` + `aria-checked` | Один вариант из взаимоисключающего набора |
+| Text color, Background color, Border color | `aria-label` | Название элемента управления и текущего цвета, например "Text color: dark gray" |
+| Цветовая палитра | `role="grid"` из элементов `gridcell` | Грид называется "Color palette". Каждая цветовая ячейка названа по своему цвету, а у выбранной есть `aria-selected="true"` |
+| Список стилей границ | `role="listbox"` из элементов `option` | Опции называются "Thin line", "Medium line", "Thick line", "Dashed line", "Dotted line", "Double line" |
+| Строка меню | `role="menubar"` + `aria-label` | "Main". Ее пункты открывают popup-окна с `role="menu"`. В popup-окнах у пунктов форматирования `role="menuitemcheckbox"`, а у пунктов выравнивания, переноса текста и числовых форматов `role="menuitemradio"`. Оба вида сообщают свое состояние через `aria-checked` |
+| Контекстные меню | `role="menu"` + `aria-label` | "Cell" для ячеек и "Sheet" для вкладок листов |
+
+### Вкладки листов {#sheet-tabs}
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| Панель вкладок листов | `role="toolbar"` + `aria-label` | "Sheets" |
+| Вкладка листа | `button` + `aria-pressed` | Вкладка названа по своему листу. У вкладки активного листа `aria-pressed="true"` |
+| Кнопка добавления листа | `aria-label` | "Add sheet" |
+
+### Диалоги {#dialogs}
+
+| Селектор | Роль / атрибут | Назначение |
+| -------- | ---------------- | ------- |
+| Диалоги Column width и Row height | `role="dialog"`, `aria-modal="true"`, `aria-label` | Названы по заголовку диалога. Поле ввода имеет метку "Width in pixels" / "Height in pixels" |
+| Строка поиска | `role="dialog"` + `aria-label` | Называется "Search". Поле поиска имеет метку "Search", а кнопки называются "Previous match", "Next match" и "Close search" |
+| Insert link, Data validation | `role="dialog"` + `aria-label` | Названы по заголовку диалога |
+| Предупреждения | `role="alertdialog"`, `aria-modal="true"`, `aria-labelledby`, `aria-describedby` | Названы по заголовку предупреждения и описаны его текстом |
+
+### Скрытые и декоративные элементы {#hidden-and-decorative-elements}
+
+Spreadsheet скрывает декоративные части от вспомогательных технологий с помощью `aria-hidden="true"`. Это иконки блокировки, фильтра и меню столбца, иконки скрытых строк и столбцов и иконка выделения всего листа. Слой, который рисует выделение, подсветку копирования и поиска и маркер заполнения, также скрыт. Скрыты и цветная копия формулы в строке формул, и ячейки, покрытые объединенной ячейкой. У оберток разметки есть `role="presentation"`. Фокусные ограничители до и после грида лишь передают фокус активной ячейке.
+
+## Модель выделения и редактирования {#selection-and-editing-model}
+
+DOM-фокус находится на самой активной ячейке, поэтому скринридер зачитывает ячейку, а не отдельное поле ввода. Когда активная ячейка перемещается, скринридер сначала зачитывает адрес новой ячейки, затем ее значение и скрытые описания. Когда пользователь выделяет диапазон с клавиатуры или мышью, скринридер озвучивает размер диапазона, после того как выделение перестает меняться. Ячейка, принадлежащая нескольким диапазонам, считается один раз, ячейки скрытых строк и столбцов учитываются. Пока ячейка редактируется, ничего не озвучивается. Когда диапазон сокращается до активной ячейки, озвучивается адрес ячейки.
+
+| Ситуация | Что получает скринридер |
+| --------- | --------------------------- |
+| Активная ячейка перемещается | Ячейка с ее адресом, значением и описаниями, например "B7, 120, locked" |
+| Выделяется диапазон | "B2 to D7, 18 cells" |
+| С помощью Ctrl выделяется несколько диапазонов | "B2 to B4, D2 to D4, 6 cells" |
+| Редактор открывается клавишей Enter, F2 или вводом текста | Поле ввода редактора с именем "Cell editor, B7" |
+| Открывается редактор ячейки со списком значений | Развернутый combobox. После ↑ или ↓ зачитывается выделенная опция списка |
+| Редактирование сохраняется | Озвучиваются новые ошибки формул в отредактированных ячейках и в зависящих от них ячейках, а также недопустимые значения в отредактированных ячейках |
+| Редактирование заблокированной ячейки отклонено | "The cell is locked" |
+| В режиме только для чтения нажата клавиша редактирования | "The sheet is read-only" |
+
+Enter, F2 или ввод текста открывает редактор. Enter сохраняет значение и переходит вниз, Tab сохраняет его и переходит вправо, а Esc отменяет редактирование.
+
+## Навигация с клавиатуры {#keyboard-navigation}
+
+Клавиатура работает сразу после появления Spreadsheet на странице, настройка не требуется. В таблицах ниже кратко описана модель работы с клавиатурой. Полный набор сочетаний клавиш см. в [списке горячих клавиш](hotkeys.md).
+
+
+
+### Ячейки {#cells}
+
+| Клавиши | Действие |
+| ---- | ------ |
+| Стрелки | Перемещают активную ячейку. Активная ячейка останавливается на первой и последней видимой строке и столбце |
+| Shift + стрелки | Расширяют выделенный диапазон |
+| Home / End | Переход к первой или последней видимой ячейке строки |
+| Ctrl + стрелки, Ctrl + Home / End | Переход к краю листа |
+| Tab / Shift + Tab | Переход вправо или влево внутри строки. С последней или первой ячейки листа фокус выходит из ячеек к следующей или предыдущей части страницы, например к вкладкам листов или строке формул |
+| Enter, F2 | Открыть редактор |
+| Esc | Закрыть редактор без сохранения |
+| Ctrl + Space / Shift + Space | Выделить столбец или строку |
+| Ctrl + Shift + 9 / 0 | Показать скрытые строки или столбцы внутри выделенного диапазона |
+| Alt + Enter | Открыть ссылку активной ячейки |
+| Shift + F10 или клавиша Menu | Открыть контекстное меню с командами для ячейки или для столбца после Ctrl + Space |
+| Alt + ↑ / ↓, Ctrl + Alt + Page Down / Page Up | Переключиться на следующий или предыдущий лист |
+
+### Переход между частями {#moving-between-the-parts}
+
+| Клавиши | Действие |
+| ---- | ------ |
+| Ctrl + F6 / Ctrl + Shift + F6 | Переместить фокус на следующую или предыдущую часть: меню, панель инструментов, лист, вкладки листов. Строка формул и скрытые части пропускаются. Открытое редактирование предварительно сохраняется |
+| Tab / Shift + Tab | Переместить фокус на следующую или предыдущую часть в порядке табуляции страницы. Каждая панель представляет собой одну точку табуляции, а фокус попадает на элемент управления, использованный последним |
+
+### Панель инструментов, строка меню и вкладки листов {#toolbar-menu-bar-and-sheet-tabs}
+
+| Клавиши | Действие |
+| ---- | ------ |
+| ← / →, Home / End | Переход между элементами управления панели |
+| Enter / Space | Нажать элемент управления: выполнить команду, открыть выпадающий список или переключиться на лист |
+| ↓ | Открыть выпадающий список и переместить фокус на его первый пункт |
+| ↑ / ↓ | Переход между пунктами открытого выпадающего списка или меню |
+| → / ← | Открыть или закрыть подменю |
+| Esc | Закрыть выпадающий список или меню и вернуть фокус на его элемент управления |
+
+### Popup-окна и диалоги {#popups-and-dialogs}
+
+| Клавиши | Действие |
+| ---- | ------ |
+| Стрелки, Home / End | Переход между цветами цветовой палитры |
+| Enter | Применить цвет, границу или размер в диалогах Column width и Row height |
+| Esc | Закрыть popup-окно, диалог или строку поиска и вернуть фокус на элемент управления или ячейку, которые их открыли. В режиме пользовательского цвета вернуться к палитре. В popup-окне цвета или стиля, открытом из popup-окна границ, закрыть его и вернуть фокус на его кнопку в popup-окне границ |
+| Tab / Shift + Tab | Переход между элементами управления диалога или режима пользовательского цвета. В popup-окне цвета или popup-окне границ закрыть его и вернуть фокус на его кнопку панели инструментов |
+| ↑ / ↓, Enter | Перемещение по списку значений ячейки и выбор значения |
+
+:::note
+У действий, рассчитанных только на указатель, есть клавиатурные альтернативы. Команды *Column width* и *Row height* контекстного меню задают точный размер без перетаскивания, а команда *Open filter* открывает фильтр без щелчка по его иконке.
+:::
+
+## Вспомогательные технологии {#assistive-technology}
+
+Команда DHTMLX тестирует Spreadsheet со следующими скринридерами:
+
+| Скринридер | Браузер | Платформа |
+| ------------- | ------- | -------- |
+| NVDA | Firefox | Windows |
+| JAWS | Chrome | Windows |
+| VoiceOver | Safari | macOS |
+
+Скринридеры получают каждое состояние от элемента, к которому оно относится:
+
+| Состояние | Передается через | Зачитывается на |
+| ----- | --------------- | ------- |
+| Позиция | `aria-rowindex`, `aria-colindex` и адрес ячейки в тексте ячейки | Каждой ячейке. Адрес находится в тексте активной ячейки и ячеек выделенных диапазонов |
+| Выделение | `aria-selected` | Активной ячейке и ячейках выделенных диапазонов |
+| Возможность редактирования | `aria-readonly` | Гриде и ячейках в режиме только для чтения и пока выделение отключено, а также заблокированных ячейках |
+| Объединенные ячейки | `aria-colspan`, `aria-rowspan` | Объединенной ячейке |
+| Заголовки строк | `role="rowheader"` | Номерах строк |
+| Состояние переключателя | `aria-pressed` | Кнопках Bold, Italic, Underline, Strikethrough, Lock и Filter и вкладках листов |
+| Состояние отметки | `aria-checked` | Пунктах форматирования строки меню, а также пунктах выравнивания, переноса текста и числовых форматов |
+| Ошибки и недопустимые значения | Скрытый текст в ячейке, `aria-invalid` | Ячейке и ее редакторе |
+| Ссылки | `` и скрытый текст "link" | Ячейке со ссылкой |
+
+## Высокий контраст и фокус {#high-contrast-and-focus}
+
+### Темы {#themes}
+
+В Spreadsheet есть четыре встроенные темы: `light` (по умолчанию), `dark`, `contrast-light` и `contrast-dark`. Темы `contrast-light` и `contrast-dark` соответствуют требованиям WCAG AA к контрасту текста. Переключайте тему методом `dhx.setTheme()` или атрибутом `data-dhx-theme`:
+
+~~~jsx
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+Подробности см. в статье [Встроенные темы](/themes/).
+
+В светлых темах цвета, которыми выделяются ссылки на ячейки в формуле, имеют контраст не менее 4.5:1.
+
+Тема `contrast-light` рисует темный текст и границы на белом фоне. В показанном ниже Spreadsheet с клавиатуры открыто контекстное меню ячейки с иконкой фильтра. Его команда в фокусе, [*Open filter*](filtering_data.md#opening-a-filter-with-the-keyboard), отмечена штриховой рамкой, а активная ячейка отмечена сплошной границей основного цвета темы:
+
+
+
+Тема `contrast-dark` рисует светлый текст и границы на темном фоне. Когда фокус находится на элементе управления панели инструментов, он отмечается кольцом фокуса цвета `--dhx-spreadsheet-focus-color`, который в темных темах светлее основного цвета границы активной ячейки:
+
+
+
+### Индикатор фокуса {#focus-indicator}
+
+Фокус клавиатуры отображается в каждой теме:
+
+- у активной ячейки сплошная граница 2px основного цвета темы
+- ячейка и редактор ячейки, находящиеся в фокусе клавиатуры, получают рамку 2px основного цвета темы
+- строка формул и элементы управления панели инструментов, строки меню, вкладок листов, popup-окна границ, popup-окна ссылки и строки поиска получают рамку 2px цвета переменной `--dhx-spreadsheet-focus-color`
+- в цветовой палитре, списке стилей границ, выпадающих списках панели инструментов и строки меню и контекстных меню пункт в фокусе получает штриховую рамку 1px цвета `--dhx-color-focused`
+- в редакторе ячейки со списком фокус остается в редакторе, а текущий пункт списка подсвечивается цветом фона
+
+Переменная `--dhx-spreadsheet-focus-color` в темных темах светлее основного цвета и может быть переопределена в [пользовательской теме](themes/custom_theme.md). Контраст каждого индикатора в каждой теме приведен в [Accessibility Conformance Report](accessibility_conformance_report.md).
+
+### Цвет и масштаб {#color-and-zoom}
+
+- **Цвет не является единственным сигналом.** У активной ячейки и выделения есть граница и заливка, у недопустимого значения есть маркер и скрытое описание, а кнопки форматирования сообщают свое состояние через `aria-pressed`. В доступное имя цветовых кнопок входит название цвета.
+- **Масштаб и перестроение.** Spreadsheet остается работоспособным при масштабе 200% и 400%. Ячейки прокручиваются в двух направлениях, а панель инструментов, строка меню и вкладки листов умещаются в ширину 320 CSS px.
+- **Интервалы текста.** При переопределении интервалов текста по WCAG подписи элементов управления не обрезаются, а панель вкладок листов прокручивается, когда вкладки разрастаются.
+- **Прокрутка в область видимости.** Активная ячейка прокручивается в область видимости рядом с закрепленными строками и столбцами.
+
+## Уведомления о состоянии {#status-announcements}
+
+Spreadsheet озвучивает изменения, у которых нет собственного элемента, через вежливую (polite) live-область, поэтому скринридер сначала дочитывает текущее предложение:
+
+| Событие | Озвучиваемый текст | Ключ локали |
+| ----- | -------------- | ---------- |
+| Выделен диапазон | "B2 to D7, 18 cells" | `aria_selectedRange`, `aria_rangeExtent`, `aria_rangeSeparator` |
+| Редактирование вызывает ошибку формулы или недопустимое значение | "B7: Reference error. Check the cell references" | `aria_cellMessage` |
+| Редактирование вызывает несколько ошибок / недопустимых значений | "3 new errors. B7: ..." / "3 invalid values. B7: ..." | `aria_newErrors`, `aria_invalidValues` |
+| Редактирование заблокированной ячейки / диапазона отклонено | "The cell is locked" / "Locked cells were not changed" | `aria_lockedCell`, `aria_lockedCells` |
+| В режиме только для чтения нажата клавиша редактирования | "The sheet is read-only" | `aria_readonlySheet` |
+| Введен текст поиска | "Results: 5. 1 of 5, B2" или "No results" | `aria_searchResults`, `aria_searchMatch`, `aria_searchNoResults` |
+| Показано следующее или предыдущее совпадение | "2 of 5, B7" | `aria_searchMatch` |
+| Выполнен экспорт Excel-файла | "Exporting the file", "The file is exported" | `aria_exportStarted`, `aria_exportDone` |
+| Импортирован файл, выбранный в диалоге выбора файла | "Importing the file", "The file is imported" | `aria_importStarted`, `aria_importDone` |
+| Применена команда Column width / Row height | "Column width set to 120 pixels" | `aria_columnWidthSet`, `aria_rowHeightSet` |
+| Ctrl + Shift + 9 / 0 не находит, что показать | "No hidden rows in the selection" | `aria_noHiddenRows`, `aria_noHiddenCols` |
+
+Чтобы озвучить результат собственной команды, вызовите метод [`announce()`](api/spreadsheet_announce_method.md):
+
+~~~jsx
+spreadsheet.announce("The report is saved");
+~~~
+
+## Локализация {#localization}
+
+Доступные имена, описания ячеек и уведомления хранятся в локали `spreadsheet` в виде ключей с префиксом `aria_`, рядом с подписями интерфейса. Переведите их методом `dhx.i18n.setLocale()` до инициализации Spreadsheet:
+
+~~~jsx
+dhx.i18n.setLocale("spreadsheet", {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_cellEditor: "Zelleneditor, {cell}",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt",
+ aria_selectedRange: "{range}, {count} Zellen",
+ aria_rangeExtent: "{start} bis {end}"
+});
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+Части в фигурных скобках, например `{cell}` или `{count}`, заменяются значениями и должны сохраняться в переведенных строках. Названия цветов и кнопок предупреждений берутся из локалей `colorpicker` и `message`. Полный список ключей см. в статье [Локализация](localization.md#default-locale), а остальные локали описаны в разделе [Локализация встроенных виджетов](localization.md#localizing-built-in-widgets).
+
+## Примеры конфигурации {#configuration-recipes}
+
+### Доступная настройка по умолчанию {#accessible-default-setup}
+
+Для работы с клавиатуры и вывода WAI-ARIA Spreadsheet не требует настройки. Чтобы соответствовать требованиям WCAG AA к контрасту текста, выберите контрастную тему. Другие способы задать тему см. в статье [Встроенные темы](/themes/):
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ // the keyboard navigation and the WAI-ARIA output need no configuration
+});
+spreadsheet.parse(data);
+
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+### Настройка режима только для чтения {#read-only-setup}
+
+Используйте опцию [`readonly`](api/spreadsheet_readonly_config.md), чтобы показать данные, которые пользователи могут читать и копировать, но не изменять. Пользователи клавиатуры и скринридеров по-прежнему могут перемещаться по ячейкам:
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ readonly: true
+});
+spreadsheet.parse(data);
+~~~
+
+Чтобы показать данные без активной ячейки и без выделения, добавьте [`selection: false`](api/spreadsheet_selection_config.md). Тогда грид станет одной точкой табуляции, которую клавиатура проходит насквозь.
+
+### Переведенные строки доступности {#translated-accessibility-strings}
+
+Скринридеры читают строки доступности из четырех локалей: `spreadsheet` содержит имена, описания ячеек и уведомления, `colorpicker` содержит названия цветов, `message` содержит названия кнопок предупреждений, а `grid` содержит уведомление о количестве загруженных строк. Задайте все четыре до создания Spreadsheet. Ключи см. в разделе [Локализация встроенных виджетов](localization.md#localizing-built-in-widgets):
+
+~~~jsx
+const deSpreadsheet = {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt"
+};
+const deColorpicker = {
+ aria_palette: "Farbpalette",
+ aria_colorRed: "rot"
+};
+const deMessage = {
+ aria_confirm: "Bestätigen"
+};
+const deGrid = {
+ aria_rowsLoaded: "{count} Zeilen geladen"
+};
+
+dhx.i18n.setLocale("spreadsheet", deSpreadsheet);
+dhx.i18n.setLocale("colorpicker", deColorpicker);
+dhx.i18n.setLocale("message", deMessage);
+dhx.i18n.setLocale("grid", deGrid);
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+### Озвучивание пользовательской команды {#announcing-a-custom-command}
+
+Когда ваша собственная команда меняет данные, сообщите пользователям скринридеров о результате с помощью метода [`announce()`](api/spreadsheet_announce_method.md). В примере в [меню](customization.md#menu) добавляется команда, очищающая активный лист:
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+
+spreadsheet.menu.data.add({ id: "clear-sheet", value: "Clear sheet" });
+
+spreadsheet.menu.events.on("click", function (id) {
+ if (id === "clear-sheet") {
+ spreadsheet.sheets.clear();
+ spreadsheet.announce("The sheet is cleared");
+ }
+});
+~~~
+
+## Ответственность страницы-хоста {#host-page-responsibilities}
+
+Ряд требований относится к уровню страницы, а не компонента. Убедитесь, что страница-хост:
+
+- задает язык документа, например ``, и заголовок страницы
+- помещает заголовок над Spreadsheet и размещает его внутри ориентира, например `| Esc | закрывает редактор ячейки без сохранения изменений | +
| Alt (Option) + Enter | +открывает ссылку активной ячейки в новой вкладке | +
| Ctrl + F6 | +перемещает фокус на следующую часть Spreadsheet в порядке: меню, панель инструментов, лист (активная ячейка), вкладки листов, затем снова меню. Строка формул и скрытые части пропускаются. Сначала сохраняет значение редактируемой ячейки | +
| Ctrl + Shift + F6 | +перемещает фокус на предыдущую часть Spreadsheet | +
| Стрелка влево/стрелка вправо | +перемещает фокус на предыдущий/следующий элемент управления панели инструментов, строки меню или вкладок листов | +
| Home/End | +перемещает фокус на первый/последний элемент управления панели | +
| Enter/Space | +нажимает элемент управления в фокусе: выполняет команду, открывает выпадающий список или переключает на лист выбранной вкладки | +
| Стрелка вниз | +открывает выпадающий список элемента управления в фокусе и перемещает фокус на его первый пункт | +
| Стрелка вверх/стрелка вниз | +перемещает фокус между пунктами открытого выпадающего списка или меню | +
| Стрелка вправо | +открывает подменю пункта меню в фокусе | +
| Стрелка влево | +закрывает подменю. На первом уровне выпадающего списка закрывает список и возвращает фокус его элементу управления | +
| Esc | +закрывает выпадающий список или меню и возвращает фокус элементу управления, который его открыл. Закрывает подсказку элемента управления панели инструментов. Без Esc подсказка остаётся открытой, пока на ней находится указатель | +
| Shift + F10 или клавиша Menu | +открывает контекстное меню активной ячейки или вкладки листа в фокусе и перемещает фокус в него. После Ctrl (Cmd) + Space контекстное меню ячейки показывает команды для столбца. Esc закрывает контекстное меню и возвращает фокус на ячейку | +
| Ctrl (Cmd) + G | -перемещает выделение к следующему найденному совпадению | +выделяет следующее найденное совпадение |
| Ctrl (Cmd) + Shift + G | -перемещает выделение к предыдущему найденному совпадению | +выделяет предыдущее найденное совпадение | +
| Esc | +закрывает строку поиска и возвращает фокус на активную ячейку |
| Ctrl (Cmd) + Shift + 9 | +показывает скрытые строки внутри выбранного диапазона | +
| Ctrl (Cmd) + Shift + 0 | +показывает скрытые столбцы внутри выбранного диапазона | +
| Клавиши со стрелками | +перемещают фокус между цветами палитры или между элементами управления всплывающего окна Border | +
| Home/End | +перемещает фокус на первый/последний цвет палитры | +
| Enter | +применяет цвет или границу в фокусе. После применения цвета текста или фона фокус возвращается на активную ячейку | +
| Esc | +возвращает из режима пользовательского цвета к палитре. Во всплывающем окне цвета или стиля, открытом поверх окна Border, закрывает его и возвращает фокус на его кнопку в окне Border. В остальных случаях закрывает всплывающее окно и возвращает фокус его элементу управления на панели инструментов | +
| Tab/Tab + Shift | +закрывает всплывающее окно и возвращает фокус его элементу управления на панели инструментов. В окне Border и окнах, открытых поверх него, закрывает их все и возвращает фокус элементу управления Border. В режиме пользовательского цвета перемещает фокус между элементами управления выбора цвета | +
| Стрелка вверх/стрелка вниз | +перемещают по списку значений | +
| Enter | +выбирает значение и закрывает редактор | +
| Esc | +закрывает редактор без сохранения изменений | +
| Tab | +сохраняет значение и перемещает выделение на одну ячейку вправо | +
| Esc | +закрывает всплывающее окно фильтра и возвращает фокус на ячейку | +
| Enter | +применяет размер в диалоговых окнах Column width и Row height | +
| Esc | +закрывает диалоговые окна Column width и Row height без изменений |
Other content
~~~
- установка темы для контейнера, указанного через HTMLElement
~~~html
-
+
Other content
~~~
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/using_typescript.md b/i18n/ru/docusaurus-plugin-content-docs/current/using_typescript.md
index 10620877..1850af32 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/using_typescript.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/using_typescript.md
@@ -1,7 +1,7 @@
---
sidebar_label: Поддержка TypeScript
title: Поддержка TypeScript
-description: Вы можете узнать об использовании TypeScript с библиотекой DHTMLX JavaScript Spreadsheet в документации. Изучите руководства разработчика и справочник API, ознакомьтесь с примерами кода и живыми демо, а также скачайте бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Используйте встроенные определения TypeScript в DHTMLX Spreadsheet для проверки типов, автодополнения и подсказок JSDoc в IDE.
---
# Поддержка TypeScript {#typescript-support}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/vuejs_integration.md b/i18n/ru/docusaurus-plugin-content-docs/current/vuejs_integration.md
index df41a633..4639cfe5 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/vuejs_integration.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/vuejs_integration.md
@@ -1,7 +1,7 @@
---
sidebar_label: Интеграция с Vue
title: Интеграция с Vue
-description: В документации вы можете узнать об интеграции библиотеки DHTMLX JavaScript Spreadsheet с Vue. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Используйте DHTMLX Spreadsheet в приложении Vue. Создайте проект, добавьте Spreadsheet как компонент Vue, загрузите данные и обработайте события.
---
# Интеграция с Vue {#integration-with-vue}
@@ -260,6 +260,10 @@ export default {
//...
~~~
+:::info
+Метод `destructor()` удаляет обработчики событий, добавленные через `spreadsheet.events.on()`. При создании нового экземпляра Spreadsheet, например при повторном создании компонента, подключите обработчики к новому экземпляру.
+:::
+
После этого можно запустить приложение и увидеть Spreadsheet с данными на странице.
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/whats_new.md b/i18n/ru/docusaurus-plugin-content-docs/current/whats_new.md
index b3fba1a0..2ff28cae 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/whats_new.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/whats_new.md
@@ -1,13 +1,78 @@
---
sidebar_label: Что нового
title: Что нового в DHTMLX Spreadsheet
-description: В документации вы можете узнать, что нового в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Список изменений DHTMLX Spreadsheet с новыми возможностями, обновлениями, исправлениями и критическими изменениями каждой версии.
---
# Что нового {#whats-new}
Если вы обновляете Spreadsheet с более ранней версии, ознакомьтесь с [Миграцией на новую версию](migration.md).
+## Версия 6.0.4 {#version-604}
+
+Выпущена 2 ноября 2026 года
+
+### Новый функционал {#new-functionality-604}
+
+- Поддержка доступности, ориентированная на WCAG 2.2 AA, Section 508 и EN 301 549: управление всеми частями Spreadsheet с клавиатуры, поддержка программ чтения с экрана и видимый фокус во всех темах. См. руководство [Доступность](accessibility.md) и [Отчёт о соответствии требованиям доступности](accessibility_conformance_report.md)
+- Возможность отключать и включать выделение ячеек:
+ - новое свойство конфигурации: [`selection`](api/spreadsheet_selection_config.md)
+ - новые методы модуля selection: [`enable()`](api/selection_enable_method.md), [`disable()`](api/selection_disable_method.md), [`isDisabled()`](api/selection_isdisabled_method.md)
+- Метод [`announce()`](api/spreadsheet_announce_method.md) отправляет статусное сообщение программам чтения с экрана
+- Новые команды [контекстного меню](customization.md#context-menu): [*Ширина столбца*, *Высота строки*](work_with_rows_cols.md#setting-column-width-and-row-height) и [*Открыть фильтр*](filtering_data.md#opening-a-filter-with-the-keyboard)
+
+### Обновления {#updates-604}
+
+- Навигация с клавиатуры (см. [Список горячих клавиш](hotkeys.md)):
+ - фокус остаётся на активной ячейке, `Tab` и `Shift + Tab` выводят фокус из последней и первой ячейки листа, а `Ctrl + F6` перемещает фокус между меню, панелью инструментов, листом и вкладками листов
+ - панель инструментов, строка меню и вкладки листов являются единой точкой табуляции, а навигация по ним выполняется стрелками
+ - добавлены новые сочетания клавиш, например, `Shift + F10` для контекстного меню и `Ctrl (Cmd) + Shift + 9` / `Ctrl (Cmd) + Shift + 0` для отображения скрытых строк и столбцов
+ - всплывающие окна выбора цвета и границ на панели инструментов получают фокус при открытии и закрываются по `Esc` и `Tab`
+- Стрелки останавливаются на первой и последней видимой строке и столбце, а не переходят к противоположному краю, а нажатие стрелки на краю сокращает выделенный диапазон до активной ячейки
+- Текст, введённый через редактор метода ввода (IME), отображается в активной ячейке и запускает редактирование через метод [`startEdit()`](api/spreadsheet_startedit_method.md), поэтому для него срабатывают события `beforeEditStart` и `afterEditStart`
+- Метод [`setFocusedCell()`](api/selection_setfocusedcell_method.md) перемещает фокус клавиатуры на ячейку
+- [Ссылка в ячейке](work_with_cells.md#inserting-a-hyperlink-into-a-cell) отображается как настоящая ссылка, которая открывается в новой вкладке, а `Alt (Option) + Enter` открывает ссылку активной ячейки
+- [Режим только для чтения](api/spreadsheet_readonly_config.md) сохраняет навигацию с клавиатуры, выделение, копирование и поиск, а программы чтения с экрана озвучивают отклонённые изменения. Чтобы отключить выделение, используйте опцию `selection: false`
+- [Удаление строки или столбца через объединённую ячейку](merge_cells.md#removing-rows-and-columns-of-merged-cells) удаляет все строки или столбцы объединённой ячейки
+- Новые строки интерфейса и программ чтения с экрана в [локали `spreadsheet`](localization.md#default-locale), а также [перевод встроенных виджетов](localization.md#localizing-built-in-widgets)
+- Переменная [`--dhx-spreadsheet-focus-color`](/themes/#spreadsheet-specific-styles) для фокуса клавиатуры и цвета ссылок на ячейки в формулах с более высокой контрастностью в светлых темах
+
+### Исправления {#fixes-604}
+
+- Объединённая ячейка удалялась вместо смещения, когда удалялась строка или столбец перед ней. Теперь объединённая ячейка, в которой осталась одна ячейка, становится обычной ячейкой и сохраняет своё значение
+- Удаление строки или столбца через объединённую ячейку удаляло только одну линию объединения
+- Подписи контекстного меню для удаления строк и столбцов не показывали все строки или столбцы объединённой ячейки, которые будут удалены
+- Строки не удалялись, если они охватывали весь отфильтрованный диапазон
+- Закреплённая область не уменьшалась при удалении закреплённых строк или столбцов
+- Автозаполнение выбрасывало ошибку, если в перетаскиваемых ячейках не было простого числа
+- Страница зависала при нажатии `Home`, `End`, `Ctrl (Cmd) + Home`, `Ctrl (Cmd) + End` и `Ctrl (Cmd) + Стрелка`, когда первая или последняя строка или столбец были скрыты
+- Размер шрифта терялся при копировании ячеек в Excel, вставке из Excel или внутри Spreadsheet
+- Всплывающая подсказка о недопустимом значении появлялась вдали от недопустимой ячейки или не показывалась
+- `Esc` и `Tab` не работали в редакторе списка после использования стрелок
+- Поиск сначала подсвечивал второе совпадение и не обновлял результаты после редактирования или переключения листа
+- Ошибка скрипта при импорте или экспорте в браузере без WebAssembly
+- Слушатели документа и внутренние виджеты оставались после вызова `destructor()`
+- Фокус клавиатуры терялся после закрытия строки поиска
+- Закрытое контекстное меню открывалось снова
+- Активная ячейка прокручивалась на одну ячейку короче до края области просмотра при навигации с клавиатуры
+- Формула с недопустимой ссылкой показывала искажённую или повторяющуюся ошибку `#REF!` вместо одной `#REF!`
+
+### React Spreadsheet {#react-spreadsheet-604}
+
+React Spreadsheet включает все обновления и исправления Spreadsheet, перечисленные выше. Ниже приведены изменения, относящиеся только к обёртке React.
+
+#### Обновления {#react-updates-604}
+
+- Новое свойство [`selection`](react/props.md#runtime-props)
+- Тип [`ISelection`](react/types.md#re-exported-upstream-types) реэкспортируется
+- [`readonly`](react/props.md#init-only-props) стало свойством, задаваемым только при инициализации
+
+#### Исправления {#react-fixes-604}
+
+- Обратные вызовы событий и `onStateChange` не срабатывали после пересоздания Spreadsheet из-за изменения свойства, задаваемого только при инициализации
+- Обработчики событий обёртки не удалялись при размонтировании
+- Данные из `loadUrl` загружались дважды при монтировании и повторно поверх сохранённых данных после пересоздания Spreadsheet
+
## Версия 6.0.3 {#version-603}
Выпущена 24 августа 2026 года
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/work_with_cells.md b/i18n/ru/docusaurus-plugin-content-docs/current/work_with_cells.md
index 9699a8b7..89ff1473 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/work_with_cells.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/work_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: Редактирование ячеек
title: Редактирование ячеек
-description: В документации вы можете узнать о работе с ячейками в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Редактирование ячеек в DHTMLX Spreadsheet. Ввод содержимого, вставка гиперссылок, использование выпадающих списков, заполнение нескольких ячеек, копирование ячеек в Excel и из Excel, блокировка ячеек.
---
# Редактирование ячеек {#editing-cells}
@@ -138,21 +138,34 @@ description: В документации вы можете узнать о ра
- копирование значения
-Например, чтобы создать ряд 4,4,4,4..., введите 4 только в первой ячейке.
+Например, чтобы создать ряд 4,4,4,4..., введите 4 только в первой ячейке.
- следование шаблону
- чтобы создать ряд 1, 2, 3, 4, 5, ..., введите 1 и 2 в первые две ячейки.
- чтобы создать ряд 1, 3, 5, 7, 9, ..., введите 1 и 3 в первые две ячейки.
- чтобы создать ряд 2, 4, 6, 8, 10, ..., введите 2 и 4 в первые две ячейки.
- помимо чисел, в шаблоне можно использовать буквы, например, чтобы создать ряд 1, a, 2, b, 3, a, 4, b, ..., введите 1, a, 2, b в первые четыре ячейки.
+ - чтобы продолжить число в конце текста, введите первые значения, например, чтобы создать ряд item1, item2, item3, ..., введите item1 и item2 в первые две ячейки.
+ - чтобы создать ряд дат, введите дату в первую ячейку: каждая следующая ячейка получит следующий день.
+- повторение текста
+
+Например, чтобы создать ряд North, South, North, South, ..., введите North и South в первые две ячейки. Числа в ячейках с форматом *Text* повторяются так же.
3\. Перетащите **маркер заполнения**
+## Копирование ячеек в Excel и из Excel {#copying-cells-to-and-from-excel}
+
+Вы можете копировать ячейки с помощью **Ctrl (Cmd) + C** и вставлять их с помощью **Ctrl (Cmd) + V** внутри Spreadsheet, а также между Spreadsheet и Microsoft Excel:
+
+- внутри Spreadsheet ячейки сохраняют значения, формулы, стили, числовые форматы и ссылки. Ссылки на ячейки в формулах смещаются на новую позицию
+- в Excel вставленные ячейки получают значения (результаты формул, а не сами формулы), стили (включая размер шрифта), объединённые ячейки и ссылки. Строки, скрытые фильтром, пропускаются
+- ячейки, скопированные из Excel, при вставке в Spreadsheet сохраняют значения, стили (включая размер шрифта), числовые форматы, объединённые ячейки и ссылки
+
## Блокировка ячеек {#locking-cells}
-Вы можете блокировать ячейки, чтобы защитить их значения от изменений. При блокировке ячейки в её правом верхнем углу появляется серый значок «замка». Заблокированные ячейки не реагируют на попытки их редактирования.
+Вы можете блокировать ячейки, чтобы защитить их значения от изменений. При блокировке ячейки в её правом верхнем углу появляется серый значок «замка». Заблокированные ячейки не реагируют на попытки их редактирования. Программы чтения с экрана озвучивают отклонённое редактирование: «The cell is locked» для одной ячейки или «Locked cells were not changed», если в выделенном диапазоне есть заблокированные ячейки.
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/work_with_rows_cols.md b/i18n/ru/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
index f5b28291..e3312e96 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
@@ -1,7 +1,7 @@
---
sidebar_label: Работа со строками и столбцами
title: Работа со строками и столбцами
-description: В документации вы можете узнать о работе со строками и столбцами в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Работа со строками и столбцами в DHTMLX Spreadsheet. Добавление и удаление, автоподбор и установка ширины столбцов и высоты строк, закрепление, скрытие и отображение.
---
# Работа со строками и столбцами {#work-with-rows-and-columns}
@@ -54,6 +54,10 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
Чтобы удалить несколько строк одновременно: выделите строки, нажмите правой кнопкой мыши для вызова контекстного меню и выберите *Строки -> Удалить строки [ids]*.
:::
+:::info
+Если выбранная ячейка находится внутри объединённой ячейки, удаляются все строки этой объединённой ячейки. Подробности см. в статье [Объединение ячеек](merge_cells.md#removing-rows-and-columns-of-merged-cells).
+:::
+
### Добавление столбцов {#adding-columns}
Чтобы добавить новый столбец, выполните следующие шаги:
@@ -98,6 +102,10 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
Чтобы удалить несколько столбцов одновременно: выделите столбцы, нажмите правой кнопкой мыши для вызова контекстного меню и выберите *Столбцы -> Удалить столбцы [ids]*.
:::
+:::info
+Если выбранная ячейка находится внутри объединённой ячейки, удаляются все столбцы этой объединённой ячейки. Подробности см. в статье [Объединение ячеек](merge_cells.md#removing-rows-and-columns-of-merged-cells).
+:::
+
## Автоподбор ширины столбца {#autofit-column-width}
Чтобы изменить ширину столбца так, чтобы она автоматически соответствовала самому длинному содержимому в столбце, вы можете:
@@ -116,6 +124,50 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
+## Установка ширины столбцов и высоты строк {#setting-column-width-and-row-height}
+
+### Установка ширины столбцов {#setting-column-width}
+
+Чтобы задать точную ширину столбцов, выполните следующие шаги:
+
+1\. Выделите столбец или ячейку в столбце. Чтобы изменить несколько столбцов, выделите диапазон ячеек, охватывающий их.
+
+2\. Нажмите правой кнопкой мыши на выделение либо нажмите `Shift + F10` или клавишу Menu и выберите *Столбцы -> Ширина столбца*. Та же команда доступна в меню значка с 3 точками столбца.
+
+
+
+3\. В диалоге *Ширина столбца* введите ширину в пикселях и нажмите **Применить** или клавишу `Enter`.
+
+
+
+### Установка высоты строк {#setting-row-height}
+
+Чтобы задать точную высоту строк, выполните следующие шаги:
+
+1\. Выделите строку или ячейку в строке. Чтобы изменить несколько строк, выделите диапазон ячеек, охватывающий их.
+
+2\. Нажмите правой кнопкой мыши на выделение либо нажмите `Shift + F10` или клавишу Menu и выберите *Строки -> Высота строки*.
+
+
+
+3\. В диалоге *Высота строки* введите высоту в пикселях и нажмите **Применить** или клавишу `Enter`.
+
+
+
+### Как применяется новый размер {#how-the-new-size-is-applied}
+
+Диалог показывает текущий размер первого столбца или строки выделенного диапазона и применяет новый размер ко всем столбцам или строкам этого диапазона. Если выделено несколько диапазонов, используется последний выделенный диапазон.
+
+Размер округляется до целых пикселей. Минимальная ширина столбца составляет 20 px, а минимальная высота строки - 10 px: меньшее положительное значение заменяется минимальным. Пока поле пусто или значение не является положительным числом, кнопка **Применить** неактивна.
+
+Кнопка **Отмена** или клавиша `Esc` закрывает диалог без изменений. Программы чтения с экрана озвучивают новый размер, например, «Column width set to 120 pixels».
+
+### Отмена изменения {#undoing-the-change}
+
+Новый размер можно отменить с помощью `Ctrl (Cmd) + Z`.
+
+Чтобы обработать изменение в коде, используйте [действия](api/overview/actions_overview.md#list-of-actions) `resizeCol` и `resizeRow`.
+
## Закрепление/открепление строк и столбцов {#freezingunfreezing-rows-and-columns}
### Закрепление строк {#freezing-rows}
@@ -212,6 +264,10 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
+:::info
+Если активная ячейка находится в строке, которая становится скрытой, активная ячейка перемещается в первую видимую строку ниже, а выделение сокращается до этой ячейки. Если ниже нет видимых строк, она перемещается в последнюю видимую строку выше.
+:::
+
### Отображение строк {#showing-rows}
Чтобы показать скрытые строки, выполните одно из следующих действий:
@@ -223,6 +279,7 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
- или выделите строки или несколько ячеек так, чтобы скрытые строки попали в выделение, нажмите правой кнопкой мыши для вызова контекстного меню и выберите *Строки -> Показать строки*
+- или выделите строки или несколько ячеек так, чтобы скрытые строки попали в выделение, и нажмите `Ctrl (Cmd) + Shift + 9`. Например, выделите строки 2-4, чтобы показать скрытую строку 3. Если в выделении нет скрытых строк, программы чтения с экрана озвучивают «No hidden rows in the selection»
(*На изображении ниже строка 8 скрыта*)
@@ -244,6 +301,10 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
+:::info
+Если активная ячейка находится в столбце, который становится скрытым, активная ячейка перемещается в первый видимый столбец правее, а выделение сокращается до этой ячейки. Если правее нет видимых столбцов, она перемещается в последний видимый столбец левее.
+:::
+
### Отображение столбцов {#showing-columns}
Чтобы показать скрытые столбцы, выполните одно из следующих действий:
@@ -259,3 +320,4 @@ DHTMLX Spreadsheet позволяет добавлять и удалять ст
(*На изображении ниже столбец C скрыт*)
+- или выделите столбцы или несколько ячеек так, чтобы скрытые столбцы попали в выделение, и нажмите `Ctrl (Cmd) + Shift + 0`. Если в выделении нет скрытых столбцов, программы чтения с экрана озвучивают «No hidden columns in the selection»
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/work_with_sheets.md b/i18n/ru/docusaurus-plugin-content-docs/current/work_with_sheets.md
index 185efe8b..c29c966a 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/work_with_sheets.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/work_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: Работа с листами
title: Работа с листами
-description: В документации вы можете узнать о работе с листами в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Добавляйте, удаляйте, переименовывайте и переключайте листы в DHTMLX Spreadsheet с помощью нижней панели инструментов и вкладок листов, а также ссылайтесь в формулах на ячейки других листов.
---
# Работа с листами {#work-with-sheets}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/working_with_cells.md b/i18n/ru/docusaurus-plugin-content-docs/current/working_with_cells.md
index 9db67c52..4b5981ca 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/working_with_cells.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/working_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: Работа с ячейками
title: Работа с ячейками
-description: В документации вы можете узнать о работе с ячейками в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Задавайте и получайте значения и стили ячеек, добавляйте проверку данных и ссылки, редактируйте, блокируйте, объединяйте и выделяйте ячейки в DHTMLX Spreadsheet через API.
---
# Работа с ячейками {#work-with-cells}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/working_with_sheets.md b/i18n/ru/docusaurus-plugin-content-docs/current/working_with_sheets.md
index 2d0c93a8..59df2b74 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/working_with_sheets.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/working_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: Работа с листами
title: Работа с листами
-description: В документации вы можете узнать о работе с листами в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Загружайте несколько листов в DHTMLX Spreadsheet, добавляйте, удаляйте, получайте, очищайте и переключайте листы с помощью методов API.
---
# Работа с листами {#work-with-sheets}
diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/working_with_ssheet.md b/i18n/ru/docusaurus-plugin-content-docs/current/working_with_ssheet.md
index 4e26147f..d70e4f80 100644
--- a/i18n/ru/docusaurus-plugin-content-docs/current/working_with_ssheet.md
+++ b/i18n/ru/docusaurus-plugin-content-docs/current/working_with_ssheet.md
@@ -1,7 +1,7 @@
---
sidebar_label: Работа с таблицей
title: Работа с таблицей
-description: В документации вы можете узнать о работе с таблицей в библиотеке DHTMLX JavaScript Spreadsheet. Изучите руководства для разработчиков и справочник API, попробуйте примеры кода и живые демо, а также загрузите бесплатную 30-дневную ознакомительную версию DHTMLX Spreadsheet.
+description: Отменяйте и повторяйте действия, добавляйте, удаляйте, закрепляйте и скрывайте строки и столбцы, подгоняйте ширину столбцов, фильтруйте, ищите и сортируйте данные и очищайте DHTMLX Spreadsheet через API.
---
# Работа с таблицей {#work-with-spreadsheet}
@@ -282,7 +282,7 @@ spreadsheet.hideSearch();
- `dir` - направление сортировки: 1 - по возрастанию, -1 - по убыванию
~~~jsx {5}
-const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// параметры конфигурации
});
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current.json b/i18n/zh/docusaurus-plugin-content-docs/current.json
index 9635a464..eefd588e 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current.json
+++ b/i18n/zh/docusaurus-plugin-content-docs/current.json
@@ -83,6 +83,10 @@
"message": "使用单元格",
"description": "The generated-index page title for category 'Work with cells' in sidebar 'docs'"
},
+ "sidebar.docs.category.Accessibility": {
+ "message": "无障碍",
+ "description": "The label for category 'Accessibility' in sidebar 'docs'"
+ },
"sidebar.docs.category.Frameworks & integrations": {
"message": "框架与集成",
"description": "The label for category 'Frameworks & integrations' in sidebar 'docs'"
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/.sync b/i18n/zh/docusaurus-plugin-content-docs/current/.sync
index 96f6c508..0532604c 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/.sync
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/.sync
@@ -1 +1 @@
-2b6d3c2fd433461ffce34526974de3f1ba5161a8
+9ff2cef64e00d4e77947433a670dc5d573fcc7f4
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/accessibility.md b/i18n/zh/docusaurus-plugin-content-docs/current/accessibility.md
new file mode 100644
index 00000000..cfba9b56
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/accessibility.md
@@ -0,0 +1,449 @@
+---
+sidebar_label: 无障碍
+title: 无障碍
+description: 让键盘用户和屏幕阅读器用户都能使用 DHTMLX Spreadsheet。了解以 WCAG 2.2 AA 为目标的 WAI-ARIA 支持、键盘导航、屏幕阅读器播报和高对比度主题。
+---
+
+# DHTMLX Spreadsheet 的无障碍支持
+
+本指南面向在需要满足无障碍要求的应用中嵌入 DHTMLX Spreadsheet 的开发者。您可以据此对照自己的检查清单评估该组件，并为键盘、屏幕阅读器和高对比度用户进行配置。
+
+Spreadsheet 会在其标记中渲染 WAI-ARIA 角色和状态。键盘焦点始终停留在活动单元格上，工具栏、菜单栏和工作表标签各自只占一个 Tab 停靠点。对于没有独立元素的变化，例如被拒绝的编辑或搜索结果，会发送到实时区域，由屏幕阅读器朗读。
+
+:::info 目标合规标准
+DHTMLX Spreadsheet 旨在满足 **WCAG 2.2 AA 级**、美国《康复法》**第 508 条**以及 **EN 301 549**（欧洲无障碍法案的技术基准）。
+
+合规情况按准则逐条针对 DHTMLX Spreadsheet 6.0.4 进行说明。详细的**无障碍合规报告（VPAT® 2.5）**见：[无障碍合规报告](accessibility_conformance_report.md)。
+:::
+
+## 功能 {#capabilities}
+
+| 领域 | 支持情况 |
+| ---- | ------- |
+| 键盘操作 | 单元格上的每个命令都有对应按键。工具栏、菜单栏和工作表标签是单一的 Tab 停靠点，使用方向键在其中导航。列宽、行高和列筛选都有上下文菜单命令，因此无需拖动或点击图标 |
+| WAI-ARIA 语义 | 单元格是包含 `columnheader`、`rowheader` 和 `gridcell` 元素的 `grid`。这些角色始终会被渲染 |
+| 焦点模型 | 键盘焦点位于活动单元格上。Tab 进入工作表时停在活动单元格上，并从最后一个或第一个单元格离开。Ctrl + F6 在菜单、工具栏、工作表和工作表标签之间移动焦点 |
+| 选择模型 | 活动单元格、单个范围和多个范围通过 `aria-selected` 暴露，并会播报范围的大小。可以使用 [`selection`](api/spreadsheet_selection_config.md) 选项关闭选择功能 |
+| 只读模式 | 可以浏览、选择、复制和搜索工作表；编辑会被拒绝并播报，且上下文菜单不可用 |
+| 屏幕阅读器 | 已使用 NVDA、JAWS 和 VoiceOver 测试 |
+| 视觉无障碍 | 提供 `contrast-light` 和 `contrast-dark` 主题，在每个主题中都有可见的焦点指示器，并且提示不依赖颜色 |
+| 文本缩放和页面缩放 | 在 200% 和 400% 缩放以及覆盖文本间距的情况下，布局仍可正常操作 |
+| 自定义 | 提供用于发送自定义消息的公共 [`announce()`](api/spreadsheet_announce_method.md) 方法，以及适用于每个内置名称和播报内容的可翻译 `aria_*` 语言环境字符串 |
+| 标准 | WCAG 2.2 AA、Section 508、EN 301 549 |
+
+## 涵盖范围 {#covered-areas}
+
+本指南涵盖 Spreadsheet 组件：
+
+- 单元格、列头和行头、合并单元格以及冻结的行和列
+- 选择：活动单元格、范围和多个范围
+- 公式栏和单元格编辑器，包括带值列表的单元格的编辑器
+- 带有颜色和边框弹出框的工具栏、菜单栏和上下文菜单
+- 工作表标签
+- 排序、筛选、搜索、数据验证、单元格中的链接、导入和导出
+- 主题和焦点指示器
+
+最终页面的无障碍程度还取决于宿主应用。请参阅[宿主页面的职责](#host-page-responsibilities)。
+
+## WAI-ARIA 支持 {#wai-aria-support}
+
+Spreadsheet 会自动为其标记添加 WAI-ARIA 角色和属性，且无法关闭。组件的每个部分都有各自的角色和名称，名称来自[语言环境](#localization)。
+
+### Spreadsheet 容器 {#spreadsheet-container}
+
+Spreadsheet 的各个部分都是独立的具名控件：
+
+| 部分 | 角色 / 属性 | 无障碍名称 |
+| ---- | ---------------- | --------------- |
+| 菜单栏 | `role="menubar"` + `aria-label` | "Main" |
+| 工具栏 | `role="toolbar"` + `aria-label` | "Formatting" |
+| 公式栏 | 输入框上的 `aria-label` | "Formula bar, B7"，其中包含活动单元格的地址 |
+| 单元格 | `role="grid"` + `aria-label` | "Spreadsheet" |
+| 工作表标签 | `role="toolbar"` + `aria-label` | "Sheets" |
+| 实时区域 | `role="status"`、`aria-live="polite"`、`aria-atomic="true"` | 视觉上隐藏，位于网格旁边，在 `role="grid"` 之外 |
+
+Spreadsheet 的根元素没有地标角色，因此您可以将其放在适合您页面的地标内。
+
+### 单元格表面 {#cell-surface}
+
+以下属性描述单元格的整体情况，由 `.dhx_grid-content` 元素承载：
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| `.dhx_grid-content` | `role="grid"` | 可交互的单元格网格 |
+| `.dhx_grid-content` | `aria-label` | "Spreadsheet"，来自 `aria_grid` 语言环境键 |
+| `.dhx_grid-content` | `aria-rowcount` | 工作表的行数加上标题行 |
+| `.dhx_grid-content` | `aria-colcount` | 可见列数加上行号列 |
+| `.dhx_grid-content` | `aria-readonly` | 在[只读模式](api/spreadsheet_readonly_config.md)下以及[选择](api/spreadsheet_selection_config.md)功能关闭时为 `"true"` |
+| `.dhx_grid-content` | `aria-multiselectable` | `"true"`；选择功能关闭时为 `"false"` |
+
+### 行和单元格 {#rows-and-cells}
+
+下表列出了行和单元格的角色，以及位置和状态属性：
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| 行 | `role="row"` + `aria-rowindex` | 工作表的一行。由于列头是第一行，工作表的第 1 行具有 `aria-rowindex="2"` |
+| 单元格 | `role="gridcell"` + `aria-colindex` | 一个单元格。由于行号是第一列，A 列具有 `aria-colindex="2"` |
+| 行号 | `role="rowheader"` | 行的标题 |
+| 单元格 | `aria-selected` | 在活动单元格和所选范围的每个单元格上为 `"true"` |
+| 单元格 | `aria-readonly` | 在只读模式下、[选择](api/spreadsheet_selection_config.md)功能关闭时以及[锁定的单元格](work_with_cells.md#locking-cells)上为 `"true"` |
+| 单元格 | `tabindex` | 活动单元格上为 `"0"`，其他单元格上为 `"-1"`，因此这些单元格只占一个 Tab 停靠点 |
+| 活动单元格 | DOM 焦点 | 键盘焦点位于活动单元格本身，而不是单独的输入框上。编辑单元格时，焦点位于单元格编辑器上 |
+| 合并单元格 | `aria-colspan` / `aria-rowspan` | 合并单元格跨越的列数或行数。被其覆盖的单元格使用 `aria-hidden="true"` 隐藏 |
+| 单元格中的链接 | 带有 `target="_blank"` 和 `rel="noopener noreferrer"` 的 `` | 使用 `http`、`https`、`mailto`、`ftp` 或 `tel` 协议的链接 |
+
+单元格还包含视觉上隐藏的文本，屏幕阅读器会将其与值一起朗读：
+
+| 隐藏文本 | 出现时机 |
+| ----------- | ---- |
+| 单元格地址，例如 "B7" | 在活动单元格和所选范围的每个单元格上。屏幕阅读器会在值之前朗读地址 |
+| "link" | 在带链接的已选单元格上。Alt + Enter 打开链接 |
+| "locked" | 在已锁定的已选单元格上 |
+| 公式错误的描述，例如 "Reference error. Check the cell references" | 在带公式错误的单元格上 |
+| "Invalid value. Choose a value from the list" | 在其值不在[值列表](work_with_cells.md#using-drop-down-lists-in-cells)中的单元格上 |
+| "Filter" / "Filter applied" | 在带筛选图标的单元格上 |
+
+### 列头和行头 {#column-and-row-headers}
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| 列字母 | `role="columnheader"` + `aria-colindex` | 列的标题 |
+| 全选角落 | `role="columnheader"` | 名称为 "Select all" |
+| 行号 | `role="rowheader"` | 行的标题 |
+| 列菜单图标、隐藏行和隐藏列的图标 | `aria-hidden="true"` | 装饰性元素。相关命令位于上下文菜单中 |
+
+标题不是 Tab 停靠点。点击列字母、行号或角落会选中相应的行或列，并将焦点返回到活动单元格。
+
+### 公式栏和编辑器 {#formula-bar-and-editors}
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| 公式栏输入框 | `aria-label` | "Formula bar, B7"，其中包含活动单元格的地址。在已锁定的单元格上，输入框为 `readonly`，因此仍可读取其值。选择功能关闭时，公式栏为空且被锁定 |
+| 单元格编辑器输入框 | `aria-label` | "Cell editor, B7" |
+| 带值列表的单元格的编辑器 | `role="combobox"`、`aria-controls`、`aria-expanded`、`aria-activedescendant` | 值列表是由 `option` 元素组成的 `listbox`，高亮的选项带有 `aria-selected` |
+| 值无效的编辑器 | `aria-invalid="true"` | 单元格已保存的值不在其值列表中。该属性在值保存后更新，而不是在用户输入时更新 |
+| 公式帮助的关闭图标 | `role="button"` + `aria-label` | "Close formula help" |
+
+### 工具栏和菜单 {#toolbar-and-menus}
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| 工具栏 | `role="toolbar"` + `aria-label` | "Formatting"；边框弹出框、搜索栏和链接弹出框的工具栏分别命名为 "Borders"、"Search" 和 "Link" |
+| 工具栏按钮 | `aria-label` | 按钮的值。图标按钮以其工具提示命名，例如 "Bold (ctrl+b)"。图标使用 `aria-hidden="true"` 隐藏 |
+| 加粗、斜体、下划线、删除线、锁定、筛选 | `aria-pressed` | 格式或筛选是否开启 |
+| 打开下拉菜单的按钮 | `aria-haspopup="menu"`、`aria-expanded` | 下拉菜单是以其按钮命名的 `menu` |
+| 对齐、文本换行、数字格式 | `role="menuitemradio"` + `aria-checked` | 互斥选项组中的一个选项 |
+| 文本颜色、背景颜色、边框颜色 | `aria-label` | 控件名称及当前颜色，例如 "Text color: dark gray" |
+| 调色板 | 由 `gridcell` 元素组成的 `role="grid"` | 该网格名称为 "Color palette"。每个颜色单元格以其颜色命名，已选中的颜色带有 `aria-selected="true"` |
+| 边框样式列表 | 由 `option` 元素组成的 `role="listbox"` | 选项名称为 "Thin line"、"Medium line"、"Thick line"、"Dashed line"、"Dotted line"、"Double line" |
+| 菜单栏 | `role="menubar"` + `aria-label` | "Main"。其菜单项会打开带有 `role="menu"` 的弹出框。在弹出框中，格式菜单项具有 `role="menuitemcheckbox"`，对齐、文本换行和数字格式菜单项具有 `role="menuitemradio"`。两者都通过 `aria-checked` 报告其状态 |
+| 上下文菜单 | `role="menu"` + `aria-label` | 单元格的菜单为 "Cell"，工作表标签的菜单为 "Sheet" |
+
+### 工作表标签 {#sheet-tabs}
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| 工作表标签栏 | `role="toolbar"` + `aria-label` | "Sheets" |
+| 工作表标签 | `button` + `aria-pressed` | 标签以其工作表命名。活动工作表的标签具有 `aria-pressed="true"` |
+| 添加工作表按钮 | `aria-label` | "Add sheet" |
+
+### 对话框 {#dialogs}
+
+| 选择器 | 角色 / 属性 | 用途 |
+| -------- | ---------------- | ------- |
+| 列宽和行高对话框 | `role="dialog"`、`aria-modal="true"`、`aria-label` | 以对话框标题命名。输入框的标签为 "Width in pixels" / "Height in pixels" |
+| 搜索栏 | `role="dialog"` + `aria-label` | 名称为 "Search"。搜索输入框的标签为 "Search"，按钮名称为 "Previous match"、"Next match" 和 "Close search" |
+| 插入链接、数据验证 | `role="dialog"` + `aria-label` | 以对话框标题命名 |
+| 警告框 | `role="alertdialog"`、`aria-modal="true"`、`aria-labelledby`、`aria-describedby` | 以警告框标题命名，并由其文本描述 |
+
+### 隐藏元素和装饰性元素 {#hidden-and-decorative-elements}
+
+Spreadsheet 使用 `aria-hidden="true"` 对辅助技术隐藏装饰性部分，包括锁定图标、筛选图标和列菜单图标、隐藏行和隐藏列的图标，以及全选图标。绘制选择区域、复制和搜索高亮以及填充柄的图层也会被隐藏。公式栏中公式的彩色副本，以及被合并单元格覆盖的单元格同样如此。布局包装元素具有 `role="presentation"`。网格前后的焦点哨兵元素仅用于将焦点传递给活动单元格。
+
+## 选择和编辑模型 {#selection-and-editing-model}
+
+DOM 焦点位于活动单元格本身，因此屏幕阅读器朗读的是单元格，而不是单独的输入框。活动单元格移动时，屏幕阅读器首先朗读新单元格的地址，然后是其值和隐藏描述。当用户使用键盘或鼠标选择范围时，屏幕阅读器会在选择不再变化后播报该范围的大小。被多个范围共有的单元格只计一次，隐藏行和隐藏列中的单元格也会被计入。编辑单元格时不会有任何播报。当范围缩减为活动单元格时，会播报该单元格的地址。
+
+| 情形 | 屏幕阅读器获得的内容 |
+| --------- | --------------------------- |
+| 活动单元格移动 | 带有地址、值和描述的单元格，例如 "B7, 120, locked" |
+| 选择一个范围 | "B2 to D7, 18 cells" |
+| 使用 Ctrl 选择多个范围 | "B2 to B4, D2 to D4, 6 cells" |
+| 通过 Enter、F2 或输入打开编辑器 | 名称为 "Cell editor, B7" 的编辑器输入框 |
+| 打开带值列表的单元格的编辑器 | 已展开的组合框。按下 ↑ 或 ↓ 后，会朗读列表中高亮的选项 |
+| 编辑已保存 | 会播报已编辑单元格及依赖它们的单元格中新出现的公式错误，以及已编辑单元格中的无效值 |
+| 对锁定单元格的编辑被拒绝 | "The cell is locked" |
+| 在只读模式下按下编辑键 | "The sheet is read-only" |
+
+Enter、F2 或输入会打开编辑器。Enter 保存值并向下移动，Tab 保存值并向右移动，Esc 取消编辑。
+
+## 键盘导航 {#keyboard-navigation}
+
+Spreadsheet 在页面上出现后键盘即可使用，无需任何配置。下表概述了键盘模型。完整的快捷键集合请参阅[快捷键列表](hotkeys.md)。
+
+
+
+### 单元格 {#cells}
+
+| 按键 | 操作 |
+| ---- | ------ |
+| 方向键 | 移动活动单元格。活动单元格会停在第一个和最后一个可见的行和列 |
+| Shift + 方向键 | 扩展所选范围 |
+| Home / End | 移至该行的第一个或最后一个可见单元格 |
+| Ctrl + 方向键、Ctrl + Home / End | 移至工作表的边缘 |
+| Tab / Shift + Tab | 在行内向右或向左移动。从工作表的最后一个或第一个单元格出发，将焦点移出单元格，移至页面的下一个或上一个部分，例如工作表标签或公式栏 |
+| Enter、F2 | 打开编辑器 |
+| Esc | 关闭编辑器且不保存 |
+| Ctrl + Space / Shift + Space | 选择列或行 |
+| Ctrl + Shift + 9 / 0 | 显示所选范围内的隐藏行或列 |
+| Alt + Enter | 打开活动单元格的链接 |
+| Shift + F10 或 Menu 键 | 打开上下文菜单，其中包含针对单元格的命令；在 Ctrl + Space 之后则为针对列的命令 |
+| Alt + ↑ / ↓、Ctrl + Alt + Page Down / Page Up | 切换到下一个或上一个工作表 |
+
+### 在各部分之间移动 {#moving-between-the-parts}
+
+| 按键 | 操作 |
+| ---- | ------ |
+| Ctrl + F6 / Ctrl + Shift + F6 | 将焦点移至下一个或上一个部分：菜单、工具栏、工作表、工作表标签。公式栏和隐藏的部分会被跳过。进行中的编辑会先被保存 |
+| Tab / Shift + Tab | 按页面的 Tab 顺序将焦点移至下一个或上一个部分。每个栏只占一个 Tab 停靠点，焦点会落在最近使用的控件上 |
+
+### 工具栏、菜单栏和工作表标签 {#toolbar-menu-bar-and-sheet-tabs}
+
+| 按键 | 操作 |
+| ---- | ------ |
+| ← / →、Home / End | 在栏的控件之间移动 |
+| Enter / Space | 按下控件：执行命令、打开下拉菜单或切换到工作表 |
+| ↓ | 打开下拉菜单并将焦点移至其第一项 |
+| ↑ / ↓ | 在已打开的下拉菜单或菜单的各项之间移动 |
+| → / ← | 打开或关闭子菜单 |
+| Esc | 关闭下拉菜单或菜单，并将焦点返回到其控件 |
+
+### 弹出框和对话框 {#popups-and-dialogs}
+
+| 按键 | 操作 |
+| ---- | ------ |
+| 方向键、Home / End | 在调色板的颜色之间移动 |
+| Enter | 应用颜色、边框，或列宽和行高对话框中的尺寸 |
+| Esc | 关闭弹出框、对话框或搜索栏，并将焦点返回到打开它的控件或单元格。在自定义颜色模式下，返回调色板。在从边框弹出框打开的颜色或样式弹出框中，关闭该弹出框并将焦点返回到边框弹出框中的对应按钮 |
+| Tab / Shift + Tab | 在对话框或自定义颜色模式的控件之间移动。在颜色弹出框或边框弹出框中，关闭该弹出框并将焦点返回到其工具栏按钮 |
+| ↑ / ↓、Enter | 在单元格的值列表中移动并选择一个值 |
+
+:::note
+仅限指针的操作都有键盘替代方式。上下文菜单中的 *Column width* 和 *Row height* 命令无需拖动即可设置精确的尺寸，*Open filter* 命令无需点击图标即可打开筛选器。
+:::
+
+## 辅助技术 {#assistive-technology}
+
+DHTMLX 团队使用以下屏幕阅读器测试 Spreadsheet：
+
+| 屏幕阅读器 | 浏览器 | 平台 |
+| ------------- | ------- | -------- |
+| NVDA | Firefox | Windows |
+| JAWS | Chrome | Windows |
+| VoiceOver | Safari | macOS |
+
+屏幕阅读器从各状态所属的元素获取该状态：
+
+| 状态 | 暴露方式 | 朗读位置 |
+| ----- | --------------- | ------- |
+| 位置 | `aria-rowindex`、`aria-colindex`，以及单元格文本中的单元格地址 | 每个单元格。地址包含在活动单元格和所选范围内单元格的文本中 |
+| 选择 | `aria-selected` | 活动单元格和所选范围内的单元格 |
+| 可编辑性 | `aria-readonly` | 只读模式下以及选择功能关闭时的网格和单元格，以及锁定的单元格 |
+| 合并单元格 | `aria-colspan`、`aria-rowspan` | 合并单元格 |
+| 行头 | `role="rowheader"` | 行号 |
+| 切换状态 | `aria-pressed` | 加粗、斜体、下划线、删除线、锁定和筛选按钮，以及工作表标签 |
+| 选中状态 | `aria-checked` | 菜单栏的格式菜单项，以及对齐、文本换行和数字格式菜单项 |
+| 错误和无效值 | 单元格中的隐藏文本、`aria-invalid` | 单元格及其编辑器 |
+| 链接 | `` 和隐藏文本 "link" | 带链接的单元格 |
+
+## 高对比度和焦点 {#high-contrast-and-focus}
+
+### 主题 {#themes}
+
+Spreadsheet 有四个内置主题：`light`（默认）、`dark`、`contrast-light` 和 `contrast-dark`。`contrast-light` 和 `contrast-dark` 主题满足 WCAG AA 对文本的对比度要求。可以使用 `dhx.setTheme()` 方法或 `data-dhx-theme` 属性切换主题：
+
+~~~jsx
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+详情请参阅[内置主题](/themes/)一文。
+
+在浅色主题中，标记公式单元格引用的颜色的对比度至少为 4.5:1。
+
+`contrast-light` 主题在白色背景上绘制深色文本和边框。在下面的 Spreadsheet 中，带有筛选图标的单元格的上下文菜单通过键盘打开。获得焦点的命令 [*Open filter*](filtering_data.md#opening-a-filter-with-the-keyboard) 以虚线轮廓标记，活动单元格以主题主色的实线边框标记：
+
+
+
+`contrast-dark` 主题在深色背景上绘制浅色文本和边框。当焦点位于工具栏控件上时，该控件以 `--dhx-spreadsheet-focus-color` 颜色的焦点环标记，在深色主题中，该颜色比活动单元格边框的主色更浅：
+
+
+
+### 焦点指示器 {#focus-indicator}
+
+键盘焦点在每个主题中都可见：
+
+- 活动单元格具有主题主色的 2px 实线边框
+- 获得键盘焦点的单元格和单元格编辑器具有主题主色的 2px 轮廓
+- 公式栏，以及工具栏、菜单栏、工作表标签、边框弹出框、链接弹出框和搜索栏的控件，具有 `--dhx-spreadsheet-focus-color` 变量颜色的 2px 轮廓
+- 在调色板、边框样式列表、工具栏和菜单栏的下拉菜单以及上下文菜单中，获得焦点的项具有 `--dhx-color-focused` 颜色的 1px 虚线轮廓
+- 在单元格的列表编辑器中，焦点保留在编辑器内，列表的当前项以背景色高亮显示
+
+在深色主题中，`--dhx-spreadsheet-focus-color` 变量比主色更浅，并且可以在[自定义主题](themes/custom_theme.md)中重新定义。每个指示器在每个主题中的对比度见[无障碍合规报告](accessibility_conformance_report.md)。
+
+### 颜色和缩放 {#color-and-zoom}
+
+- **颜色不是唯一的提示。** 活动单元格和选区同时具有边框和填充，无效值具有标记和隐藏描述，格式按钮通过 `aria-pressed` 报告其状态。颜色按钮的无障碍名称中包含颜色名称。
+- **缩放和重排。** Spreadsheet 在 200% 和 400% 缩放下仍可操作。单元格可向两个方向滚动，工具栏、菜单栏和工作表标签适配 320 CSS px 的宽度。
+- **文本间距。** 在应用 WCAG 文本间距覆盖时，不会有控件标签被截断，并且当标签增多时，工作表标签栏可以滚动。
+- **滚动到可见区域。** 活动单元格会滚动到可见区域，并位于冻结的行和列旁边。
+
+## 状态播报 {#status-announcements}
+
+Spreadsheet 通过礼貌（polite）实时区域播报没有独立元素的变化，因此屏幕阅读器会先读完当前这句话：
+
+| 事件 | 播报文本 | 语言环境键 |
+| ----- | -------------- | ---------- |
+| 选择一个范围 | "B2 to D7, 18 cells" | `aria_selectedRange`、`aria_rangeExtent`、`aria_rangeSeparator` |
+| 编辑导致公式错误或无效值 | "B7: Reference error. Check the cell references" | `aria_cellMessage` |
+| 编辑导致多个错误 / 无效值 | "3 new errors. B7: ..." / "3 invalid values. B7: ..." | `aria_newErrors`、`aria_invalidValues` |
+| 对锁定的单元格 / 范围的编辑被拒绝 | "The cell is locked" / "Locked cells were not changed" | `aria_lockedCell`、`aria_lockedCells` |
+| 在只读模式下按下编辑键 | "The sheet is read-only" | `aria_readonlySheet` |
+| 输入搜索文本 | "Results: 5. 1 of 5, B2" 或 "No results" | `aria_searchResults`、`aria_searchMatch`、`aria_searchNoResults` |
+| 显示下一个或上一个匹配项 | "2 of 5, B7" | `aria_searchMatch` |
+| 导出 Excel 文件 | "Exporting the file"、"The file is exported" | `aria_exportStarted`、`aria_exportDone` |
+| 导入在文件对话框中选择的文件 | "Importing the file"、"The file is imported" | `aria_importStarted`、`aria_importDone` |
+| 应用列宽 / 行高命令 | "Column width set to 120 pixels" | `aria_columnWidthSet`、`aria_rowHeightSet` |
+| Ctrl + Shift + 9 / 0 没有找到可显示的内容 | "No hidden rows in the selection" | `aria_noHiddenRows`、`aria_noHiddenCols` |
+
+若要播报您自己命令的结果，请调用 [`announce()`](api/spreadsheet_announce_method.md) 方法：
+
+~~~jsx
+spreadsheet.announce("The report is saved");
+~~~
+
+## 本地化 {#localization}
+
+无障碍名称、单元格描述和播报内容以带有 `aria_` 前缀的键存储在 `spreadsheet` 语言环境中，与界面标签放在一起。请在初始化 Spreadsheet 之前使用 `dhx.i18n.setLocale()` 方法翻译它们：
+
+~~~jsx
+dhx.i18n.setLocale("spreadsheet", {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_cellEditor: "Zelleneditor, {cell}",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt",
+ aria_selectedRange: "{range}, {count} Zellen",
+ aria_rangeExtent: "{start} bis {end}"
+});
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+花括号中的部分，例如 `{cell}` 或 `{count}`，会被替换为相应的值，必须保留在翻译后的字符串中。颜色名称和警告框按钮的名称来自 `colorpicker` 和 `message` 语言环境。完整的键列表请参阅[本地化](localization.md#default-locale)，其他语言环境请参阅[本地化内置组件](localization.md#localizing-built-in-widgets)。
+
+## 配置示例 {#configuration-recipes}
+
+### 无障碍默认设置 {#accessible-default-setup}
+
+Spreadsheet 的键盘和 WAI-ARIA 输出无需任何配置。若要满足 WCAG AA 对文本的对比度要求，请选择对比度主题。设置主题的其他方式请参阅[内置主题](/themes/)：
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ // the keyboard navigation and the WAI-ARIA output need no configuration
+});
+spreadsheet.parse(data);
+
+dhx.setTheme("contrast-light"); // or "contrast-dark"
+~~~
+
+### 只读设置 {#read-only-setup}
+
+使用 [`readonly`](api/spreadsheet_readonly_config.md) 选项显示用户可以阅读和复制但不能修改的数据。键盘和屏幕阅读器用户仍然可以在单元格间移动：
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+ readonly: true
+});
+spreadsheet.parse(data);
+~~~
+
+若要在没有活动单元格和选择的情况下显示数据，请添加 [`selection: false`](api/spreadsheet_selection_config.md)。此时网格会成为一个键盘可直接通过的 Tab 停靠点。
+
+### 翻译无障碍字符串 {#translated-accessibility-strings}
+
+屏幕阅读器从四个语言环境中读取无障碍字符串：`spreadsheet` 包含名称、单元格描述和播报内容，`colorpicker` 包含颜色名称，`message` 包含警告框按钮的名称，`grid` 包含已加载行数的播报内容。请在创建 Spreadsheet 之前设置这四个语言环境。键的说明请参阅[本地化内置组件](localization.md#localizing-built-in-widgets)：
+
+~~~jsx
+const deSpreadsheet = {
+ // other keys of the locale
+ aria_grid: "Tabelle",
+ aria_readonlySheet: "Das Blatt ist schreibgeschützt"
+};
+const deColorpicker = {
+ aria_palette: "Farbpalette",
+ aria_colorRed: "rot"
+};
+const deMessage = {
+ aria_confirm: "Bestätigen"
+};
+const deGrid = {
+ aria_rowsLoaded: "{count} Zeilen geladen"
+};
+
+dhx.i18n.setLocale("spreadsheet", deSpreadsheet);
+dhx.i18n.setLocale("colorpicker", deColorpicker);
+dhx.i18n.setLocale("message", deMessage);
+dhx.i18n.setLocale("grid", deGrid);
+
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+~~~
+
+### 播报自定义命令 {#announcing-a-custom-command}
+
+当您自己的命令更改数据时，请使用 [`announce()`](api/spreadsheet_announce_method.md) 方法告知屏幕阅读器用户结果。下面的示例添加了一个清空活动工作表的[菜单](customization.md#menu)命令：
+
+~~~jsx
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
+
+spreadsheet.menu.data.add({ id: "clear-sheet", value: "Clear sheet" });
+
+spreadsheet.menu.events.on("click", function (id) {
+ if (id === "clear-sheet") {
+ spreadsheet.sheets.clear();
+ spreadsheet.announce("The sheet is cleared");
+ }
+});
+~~~
+
+## 宿主页面的职责 {#host-page-responsibilities}
+
+有一些要求属于页面层面，而不在组件内部。请确保宿主页面：
+
+- 设置文档语言，例如 ``，并设置页面标题
+- 在 Spreadsheet 上方放置标题，并将其置于地标内，例如 `| Esc | 关闭单元格中的编辑器，不保存更改 | +
| Alt (Option) + Enter | +在新标签页中打开活动单元格的链接 | +
| Ctrl + F6 | +按以下顺序将焦点移至 Spreadsheet 的下一部分：菜单、工具栏、工作表（活动单元格）、工作表标签页，然后返回菜单。公式栏和隐藏的部分会被跳过。会先保存已编辑单元格的值 | +
| Ctrl + Shift + F6 | +将焦点移至 Spreadsheet 的上一部分 | +
| Left Arrow/Right Arrow Key | +将焦点移至工具栏、菜单栏或工作表标签页的上一个/下一个控件 | +
| Home/End | +将焦点移至栏中的第一个/最后一个控件 | +
| Enter/Space | +按下获得焦点的控件：执行命令、打开下拉列表，或切换到获得焦点的标签页所对应的工作表 | +
| Down Arrow Key | +打开获得焦点的控件的下拉列表，并将焦点移至其第一项 | +
| Up Arrow/Down Arrow Key | +在已打开的下拉列表或菜单的各项之间移动焦点 | +
| Right Arrow Key | +打开获得焦点的菜单项的子菜单 | +
| Left Arrow Key | +关闭子菜单。在下拉列表的第一级中，关闭下拉列表并将焦点返回到其控件 | +
| Esc | +关闭下拉列表或菜单，并将焦点返回到打开它的控件。关闭工具栏控件的提示。如果不按 Esc，只要指针停留在提示上，提示就会保持打开 | +
| Shift + F10 or Menu key | +打开活动单元格或获得焦点的工作表标签页的上下文菜单，并将焦点移入其中。在按下 Ctrl (Cmd) + Space 之后，单元格的上下文菜单会显示针对列的命令。Esc 关闭上下文菜单并将焦点返回到单元格 | +
| Ctrl (Cmd) + G | -将选中项移至下一个匹配结果 | +高亮显示下一个匹配结果 |
| Ctrl (Cmd) + Shift + G | -将选中项移至上一个匹配结果 | +高亮显示上一个匹配结果 | +
| Esc | +关闭搜索框，并将焦点返回到活动单元格 |
| Ctrl (Cmd) + Shift + 9 | +显示所选区域内的隐藏行 | +
| Ctrl (Cmd) + Shift + 0 | +显示所选区域内的隐藏列 | +
| Arrow keys | +在调色板的颜色之间或 Border 弹窗的控件之间移动焦点 | +
| Home/End | +将焦点移至调色板的第一个/最后一个颜色 | +
| Enter | +应用获得焦点的颜色或边框。应用文本颜色或背景颜色后，焦点返回到活动单元格 | +
| Esc | +从自定义颜色模式返回调色板。在 Border 弹窗之上打开的颜色或样式弹窗中，关闭该弹窗并将焦点返回到 Border 弹窗中的对应按钮。其他情况下，关闭弹窗并将焦点返回到其工具栏控件 | +
| Tab/Tab + Shift | +关闭弹窗并将焦点返回到其工具栏控件。在 Border 弹窗及其上打开的弹窗中，关闭所有弹窗并将焦点返回到 Border 控件。在自定义颜色模式中，在取色器的控件之间移动焦点 | +
| Up Arrow/Down Arrow Key | +在值列表中移动 | +
| Enter | +选择该值并关闭编辑器 | +
| Esc | +关闭编辑器，不保存更改 | +
| Tab | +保存该值并将选中项向右移动一个单元格 | +
| Esc | +关闭筛选器弹窗，并将焦点返回到单元格 | +
| Enter | +在列宽和行高对话框中应用尺寸 | +
| Esc | +关闭列宽和行高对话框，不应用更改 |
Other content
~~~
- 通过 HTMLElement 为指定容器设置主题
~~~html
-
+
Other content
~~~
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/using_typescript.md b/i18n/zh/docusaurus-plugin-content-docs/current/using_typescript.md
index d5d0460a..8f7c3b43 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/using_typescript.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/using_typescript.md
@@ -1,7 +1,7 @@
---
sidebar_label: TypeScript 支持
title: TypeScript 支持
-description: 您可以在文档中了解如何在 DHTMLX JavaScript Spreadsheet 库中使用 TypeScript。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载 DHTMLX Spreadsheet 的免费 30 天评估版本。
+description: 使用 DHTMLX Spreadsheet 内置的 TypeScript 定义，在 IDE 中获得类型检查、自动补全和 JSDoc 提示。
---
# TypeScript 支持 {#typescript-support}
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/vuejs_integration.md b/i18n/zh/docusaurus-plugin-content-docs/current/vuejs_integration.md
index 9d91a388..00d8a094 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/vuejs_integration.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/vuejs_integration.md
@@ -1,7 +1,7 @@
---
sidebar_label: 与 Vue 集成
title: Vue 集成
-description: 您可以在文档中了解 DHTMLX JavaScript Spreadsheet 库的 Vue 集成。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: "在 Vue 应用中使用 DHTMLX Spreadsheet。创建项目，将 Spreadsheet 添加为 Vue 组件，加载数据并处理事件。"
---
# 与 Vue 集成 {#integration-with-vue}
@@ -260,6 +260,10 @@ export default {
//...
~~~
+:::info
+`destructor()` 方法会移除通过 `spreadsheet.events.on()` 附加的事件处理器。创建新的 Spreadsheet 实例时（例如再次创建组件时），请将处理器附加到新实例上。
+:::
+
完成后，您可以启动应用，查看加载了数据的 Spreadsheet 页面。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/whats_new.md b/i18n/zh/docusaurus-plugin-content-docs/current/whats_new.md
index 9cf644bc..3d23f78d 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/whats_new.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/whats_new.md
@@ -1,13 +1,78 @@
---
sidebar_label: 更新日志
title: DHTMLX Spreadsheet 更新日志
-description: 您可以在文档中了解 DHTMLX JavaScript Spreadsheet 库的最新动态。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: DHTMLX Spreadsheet 发布说明，介绍各版本的新功能、更新、修复和破坏性变更。
---
# 更新日志 {#whats-new}
如果您正在从旧版本升级 Spreadsheet，请查阅[迁移到新版本](migration.md)了解详细信息。
+## 版本 6.0.4 {#version-604}
+
+发布于 2026 年 11 月 2 日
+
+### 新功能 {#new-functionality-604}
+
+- 无障碍支持，目标为 WCAG 2.2 AA、Section 508 和 EN 301 549：Spreadsheet 的每个部分均可通过键盘操作，支持屏幕阅读器，并且在每个主题中都有可见的焦点。请查阅[无障碍](accessibility.md)指南和[无障碍合规报告](accessibility_conformance_report.md)
+- 可关闭和开启单元格选择：
+ - 新增配置属性：[`selection`](api/spreadsheet_selection_config.md)
+ - selection 模块的新方法：[`enable()`](api/selection_enable_method.md)、[`disable()`](api/selection_disable_method.md)、[`isDisabled()`](api/selection_isdisabled_method.md)
+- [`announce()`](api/spreadsheet_announce_method.md) 方法用于向屏幕阅读器发送状态消息
+- [上下文菜单](customization.md#context-menu)的新命令：[*列宽*、*行高*](work_with_rows_cols.md#setting-column-width-and-row-height)和*打开筛选器*（见[使用键盘打开筛选器](filtering_data.md#opening-a-filter-with-the-keyboard)）
+
+### 更新 {#updates-604}
+
+- 键盘导航（请查阅[快捷键列表](hotkeys.md)）：
+ - 焦点保持在活动单元格上，`Tab` 和 `Shift + Tab` 可分别从工作表的最后一个和第一个单元格移出，`Ctrl + F6` 在菜单、工具栏、工作表和工作表标签之间移动焦点
+ - 工具栏、菜单栏和工作表标签均为单一 Tab 停靠点，可使用方向键在其中导航
+ - 新增快捷键，例如用于上下文菜单的 `Shift + F10`，以及用于显示隐藏行和列的 `Ctrl (Cmd) + Shift + 9` / `Ctrl (Cmd) + Shift + 0`
+ - 工具栏的颜色和边框弹出窗口在打开时获得焦点，并可通过 `Esc` 和 `Tab` 关闭
+- 方向键在第一个和最后一个可见行和列处停止，而不是跳到对侧边缘；在边缘处按方向键会将选中的区域缩小为活动单元格
+- 使用输入法编辑器（IME）输入的文本会显示在活动单元格中，并通过 [`startEdit()`](api/spreadsheet_startedit_method.md) 方法开始编辑，因此会触发 `beforeEditStart` 和 `afterEditStart` 事件
+- [`setFocusedCell()`](api/selection_setfocusedcell_method.md) 方法将键盘焦点移动到单元格
+- [单元格中的链接](work_with_cells.md#inserting-a-hyperlink-into-a-cell)呈现为在新标签页中打开的真实链接，`Alt (Option) + Enter` 可打开活动单元格的链接
+- [只读模式](api/spreadsheet_readonly_config.md)保留键盘导航、选择、复制和搜索，屏幕阅读器会播报被拒绝的编辑。要关闭选择，请使用 `selection: false` 选项
+- [通过合并单元格删除行或列](merge_cells.md#removing-rows-and-columns-of-merged-cells)时，会删除该合并单元格的所有行或列
+- [`spreadsheet` 语言包](localization.md#default-locale)中新增界面和屏幕阅读器字符串，并支持[内置组件的翻译](localization.md#localizing-built-in-widgets)
+- 用于键盘焦点的 [`--dhx-spreadsheet-focus-color`](/themes/#spreadsheet-specific-styles) 变量，以及浅色主题中对比度更高的公式引用颜色
+
+### 修复 {#fixes-604}
+
+- 删除合并单元格之前的行或列时，合并单元格被丢弃而不是被移动的问题。现在只剩一个单元格的合并单元格会变成普通单元格并保留其值
+- 通过合并单元格删除行或列时只删除合并区域中的一行（列）的问题
+- 删除行和列的上下文菜单标签未显示将被删除的合并单元格的所有行或列的问题
+- 行覆盖整个筛选范围时未被删除的问题
+- 删除冻结的行或列时冻结区域没有缩小的问题
+- 拖动的单元格不包含普通数字时自动填充抛出错误的问题
+- 当第一行或最后一行（列）被隐藏时，按 `Home`、`End`、`Ctrl (Cmd) + Home`、`Ctrl (Cmd) + End` 和 `Ctrl (Cmd) + 方向键` 页面卡死的问题
+- 将单元格复制到 Excel、从 Excel 粘贴或在 Spreadsheet 内部粘贴时字体大小丢失的问题
+- 无效值提示框出现在远离无效单元格的位置或未显示的问题
+- 使用方向键后，列表编辑器中 `Esc` 和 `Tab` 不起作用的问题
+- 搜索先高亮第二个匹配项，且在编辑或切换工作表后未刷新结果的问题
+- 在不支持 WebAssembly 的浏览器中导入或导出时出现脚本错误的问题
+- `destructor()` 之后遗留文档监听器和内部组件的问题
+- 搜索栏关闭后键盘焦点丢失的问题
+- 已关闭的上下文菜单再次打开的问题
+- 键盘导航时活动单元格滚动到距视口边缘差一个单元格的问题
+- 含无效引用的公式显示残缺或重复的 `#REF!` 错误，而不是单个 `#REF!` 的问题
+
+### React Spreadsheet {#react-spreadsheet-604}
+
+React Spreadsheet 包含上述所有 Spreadsheet 更新和修复。以下是仅针对 React 封装的变更。
+
+#### 更新 {#react-updates-604}
+
+- 新增 [`selection`](react/props.md#runtime-props) 属性
+- 重新导出 [`ISelection`](react/types.md#re-exported-upstream-types) 类型
+- [`readonly`](react/props.md#init-only-props) 改为仅初始化属性
+
+#### 修复 {#react-fixes-604}
+
+- 因仅初始化属性变化而重新创建 Spreadsheet 后，事件回调和 `onStateChange` 不触发的问题
+- 卸载时未移除封装组件的事件处理程序的问题
+- 挂载时 `loadUrl` 的数据被加载两次，以及 Spreadsheet 重新创建后再次覆盖保留数据的问题
+
## 版本 6.0.3 {#version-603}
发布于 2026 年 8 月 24 日
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/work_with_cells.md b/i18n/zh/docusaurus-plugin-content-docs/current/work_with_cells.md
index 5afec447..49e84f96 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/work_with_cells.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/work_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: 编辑单元格
title: 编辑单元格
-description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解单元格操作相关内容。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: 在 DHTMLX Spreadsheet 中编辑单元格。输入内容、插入超链接、使用下拉列表、填充多个单元格、在单元格与 Excel 之间复制，以及锁定单元格。
---
# 编辑单元格 {#editing-cells}
@@ -145,14 +145,27 @@ description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解单
- 要生成序列 1, 3, 5, 7, 9, ...，在前两个单元格中分别输入 1 和 3。
- 要生成序列 2, 4, 6, 8, 10, ...，在前两个单元格中分别输入 2 和 4。
- 除数字外，您还可以在规律中使用字母，例如，要生成序列 1, a, 2, b, 3, a, 4, b, ...，在前四个单元格中分别输入 1, a, 2, b。
+ - 要在文本末尾接续数字，请输入前几个值，例如，要生成序列 item1, item2, item3, ...，在前两个单元格中分别输入 item1 和 item2。
+ - 要生成日期序列，请在第一个单元格中输入一个日期：之后每个单元格依次得到下一天的日期。
+- 重复文本
+
+例如，要生成序列 North, South, North, South, ...，在前两个单元格中分别输入 North 和 South。*文本*格式单元格中的数字也以同样方式重复。
3\. 拖动**填充手柄**
+## 单元格与 Excel 之间复制 {#copying-cells-to-and-from-excel}
+
+您可以使用 **Ctrl (Cmd) + C** 复制单元格，并使用 **Ctrl (Cmd) + V** 粘贴，既可在 Spreadsheet 内部进行，也可在 Spreadsheet 与 Microsoft Excel 之间进行：
+
+- 在 Spreadsheet 内部，单元格保留其值、公式、样式、数字格式和链接。公式中的单元格引用会随新位置而偏移
+- 粘贴到 Excel 时，单元格得到的是值（公式的计算结果，而不是公式本身）、样式（包括字体大小）、合并单元格和链接。被筛选器隐藏的行会被跳过
+- 从 Excel 复制的单元格粘贴到 Spreadsheet 时，会保留其值、样式（包括字体大小）、数字格式、合并单元格和链接
+
## 锁定单元格 {#locking-cells}
-您可以锁定单元格以防止其值被更改。锁定单元格后，右上角会显示灰色"钥匙"图标。锁定的单元格不响应任何编辑尝试。
+您可以锁定单元格以防止其值被更改。锁定单元格后，右上角会显示灰色"钥匙"图标。锁定的单元格不响应任何编辑尝试。屏幕阅读器会播报被拒绝的编辑：对单个单元格播报"The cell is locked"，当选中的区域包含锁定单元格时播报"Locked cells were not changed"。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/work_with_rows_cols.md b/i18n/zh/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
index 014b310a..19b0d755 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/work_with_rows_cols.md
@@ -1,7 +1,7 @@
---
sidebar_label: 行与列操作
title: 行与列操作
-description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解行与列的操作方法。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: 在 DHTMLX Spreadsheet 中操作行和列。添加和删除行列，自动适应并设置列宽和行高，以及冻结、隐藏和显示行列。
---
# 行与列操作 {#work-with-rows-and-columns}
@@ -54,6 +54,10 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
要一次删除多行：选择这些行，右键单击调出上下文菜单，然后选择 *行 -> 删除行 [ids]*。
:::
+:::info
+如果选中的单元格位于合并单元格内，则会删除该合并单元格的所有行。详细信息请查阅[合并单元格](merge_cells.md#removing-rows-and-columns-of-merged-cells)一文。
+:::
+
### 添加列 {#adding-columns}
要添加新列，请按以下步骤操作：
@@ -98,6 +102,10 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
要一次删除多列：选择这些列，右键单击调出上下文菜单，然后选择 *列 -> 删除列 [ids]*。
:::
+:::info
+如果选中的单元格位于合并单元格内，则会删除该合并单元格的所有列。详细信息请查阅[合并单元格](merge_cells.md#removing-rows-and-columns-of-merged-cells)一文。
+:::
+
## 列宽自动适应 {#autofit-column-width}
要更改列宽，使其自动适应列中最长的内容，您可以：
@@ -116,6 +124,50 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
+## 设置列宽和行高 {#setting-column-width-and-row-height}
+
+### 设置列宽 {#setting-column-width}
+
+要设置列的精确宽度，请按以下步骤操作：
+
+1\. 选择一列或该列中的某个单元格。若要更改多列，请选择跨越这些列的单元格区域。
+
+2\. 右键单击选区，或按 `Shift + F10` 或 Menu 键，然后选择 *列 -> 列宽*。该命令也可在列的三点图标菜单中找到。
+
+
+
+3\. 在*列宽*对话框中输入以像素为单位的宽度，然后单击**应用**或按 `Enter`。
+
+
+
+### 设置行高 {#setting-row-height}
+
+要设置行的精确高度，请按以下步骤操作：
+
+1\. 选择一行或该行中的某个单元格。若要更改多行，请选择跨越这些行的单元格区域。
+
+2\. 右键单击选区，或按 `Shift + F10` 或 Menu 键，然后选择 *行 -> 行高*。
+
+
+
+3\. 在*行高*对话框中输入以像素为单位的高度，然后单击**应用**或按 `Enter`。
+
+
+
+### 新尺寸的应用方式 {#how-the-new-size-is-applied}
+
+对话框显示所选区域中第一列或第一行的当前尺寸，并将新尺寸应用于该区域内的每一列或每一行。如果选择了多个区域，则使用最后选择的区域。
+
+尺寸会四舍五入为整数像素。列的最小宽度为 20 px，行的最小高度为 10 px：小于最小值的正数会被替换为最小值。当输入框为空或输入的值不是正数时，**应用**按钮不可用。
+
+**取消**按钮或 `Esc` 会关闭对话框且不做任何更改。屏幕阅读器会播报新的尺寸，例如"Column width set to 120 pixels"。
+
+### 撤销更改 {#undoing-the-change}
+
+可以使用 `Ctrl (Cmd) + Z` 撤销新的尺寸。
+
+要在代码中处理该更改，请使用 `resizeCol` 和 `resizeRow` [actions](api/overview/actions_overview.md#list-of-actions)。
+
## 冻结/解冻行和列 {#freezingunfreezing-rows-and-columns}
### 冻结行 {#freezing-rows}
@@ -212,6 +264,10 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
+:::info
+如果活动单元格所在的行被隐藏，活动单元格会移动到其下方第一个可见行，选区缩小为该单元格。如果下方没有可见行，则移动到上方最后一个可见行。
+:::
+
### 显示行 {#showing-rows}
要显示已隐藏的行，请选择以下任一操作：
@@ -228,6 +284,8 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
+- 或选择行或多个单元格，使隐藏的行包含在选区中，然后按 `Ctrl (Cmd) + Shift + 9`。例如，选择第 2-4 行即可显示隐藏的第 3 行。如果选区中没有隐藏的行，屏幕阅读器会播报"No hidden rows in the selection"
+
### 隐藏列 {#hiding-columns}
要隐藏列，请按以下步骤操作：
@@ -244,6 +302,10 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
+:::info
+如果活动单元格所在的列被隐藏，活动单元格会移动到其右侧第一个可见列，选区缩小为该单元格。如果右侧没有可见列，则移动到左侧最后一个可见列。
+:::
+
### 显示列 {#showing-columns}
要显示已隐藏的列，请选择以下任一操作：
@@ -259,3 +321,5 @@ DHTMLX Spreadsheet 支持通过工具栏按钮、菜单选项和单元格上下
（*下图中 C 列已隐藏*）
+
+- 或选择列或多个单元格，使隐藏的列包含在选区中，然后按 `Ctrl (Cmd) + Shift + 0`。如果选区中没有隐藏的列，屏幕阅读器会播报"No hidden columns in the selection"
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/work_with_sheets.md b/i18n/zh/docusaurus-plugin-content-docs/current/work_with_sheets.md
index 6ce426de..c6108f98 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/work_with_sheets.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/work_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: 工作表操作
title: 工作表操作
-description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解工作表操作相关内容。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: 通过 DHTMLX Spreadsheet 底部工具栏和工作表标签添加、删除、重命名和切换工作表，并在公式中引用其他工作表的单元格。
---
# 工作表操作 {#work-with-sheets}
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/working_with_cells.md b/i18n/zh/docusaurus-plugin-content-docs/current/working_with_cells.md
index a9a91940..acfbbcb8 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/working_with_cells.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/working_with_cells.md
@@ -1,7 +1,7 @@
---
sidebar_label: 单元格操作
title: 单元格操作
-description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解单元格操作相关内容。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: 通过 API 设置和获取 DHTMLX Spreadsheet 单元格的值和样式，验证单元格、插入链接，以及编辑、锁定、合并和选择单元格。
---
# 单元格操作 {#work-with-cells}
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/working_with_sheets.md b/i18n/zh/docusaurus-plugin-content-docs/current/working_with_sheets.md
index d6d14cd3..61a263a9 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/working_with_sheets.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/working_with_sheets.md
@@ -1,7 +1,7 @@
---
sidebar_label: 工作表操作
title: 工作表操作
-description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解工作表操作相关内容。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: 将多个工作表加载到 DHTMLX Spreadsheet，并使用 API 方法添加、删除、获取、清除和切换工作表。
---
# 工作表操作 {#work-with-sheets}
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/working_with_ssheet.md b/i18n/zh/docusaurus-plugin-content-docs/current/working_with_ssheet.md
index 002c9033..fcd7f007 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/working_with_ssheet.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/working_with_ssheet.md
@@ -1,7 +1,7 @@
---
sidebar_label: 电子表格操作
title: 电子表格操作
-description: 您可以在 DHTMLX JavaScript Spreadsheet 库的文档中了解电子表格操作相关内容。浏览开发者指南和 API 参考，查看代码示例和在线演示，并下载免费的 30 天评估版 DHTMLX Spreadsheet。
+description: 通过 API 在 DHTMLX Spreadsheet 中撤销和重做操作，添加、删除、冻结和隐藏行与列，自动调整列宽，筛选、搜索和排序数据，以及清空表格。
---
# 电子表格操作 {#work-with-spreadsheet}
@@ -282,7 +282,7 @@ spreadsheet.hideSearch();
- `dir` - 排序方向：1 - 升序，-1 - 降序
~~~jsx {5}
-const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// config parameters
});
diff --git a/sidebars.js b/sidebars.js
index a6c0752e..4d586df4 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -50,6 +50,7 @@ module.exports = {
"api/spreadsheet_addcolumn_method",
"api/spreadsheet_addformula_method",
"api/spreadsheet_addrow_method",
+ "api/spreadsheet_announce_method",
"api/spreadsheet_clear_method",
"api/spreadsheet_deletecolumn_method",
"api/spreadsheet_deleterow_method",
@@ -142,6 +143,7 @@ module.exports = {
"api/spreadsheet_multisheets_config",
"api/spreadsheet_readonly_config",
"api/spreadsheet_rowscount_config",
+ "api/spreadsheet_selection_config",
"api/spreadsheet_toolbarblocks_config"
]
},
@@ -174,8 +176,11 @@ module.exports = {
id: "api/overview/selection_overview"
},
items: [
+ "api/selection_disable_method",
+ "api/selection_enable_method",
"api/selection_getfocusedcell_method",
"api/selection_getselectedcell_method",
+ "api/selection_isdisabled_method",
"api/selection_removeselectedcell_method",
"api/selection_setfocusedcell_method",
"api/selection_setselectedcell_method"
@@ -321,6 +326,19 @@ module.exports = {
}
]
},
+ {
+ type: "category",
+ label: "Accessibility",
+ collapsible: true,
+ collapsed: true,
+ link: {
+ type: 'doc',
+ id: "accessibility"
+ },
+ items: [
+ "accessibility_conformance_report"
+ ]
+ },
{
type: "category",
label: "Frameworks & integrations",
diff --git a/static/img/accessibility/spreadsheet_contrast_dark.png b/static/img/accessibility/spreadsheet_contrast_dark.png
new file mode 100644
index 00000000..4b7ccfa2
Binary files /dev/null and b/static/img/accessibility/spreadsheet_contrast_dark.png differ
diff --git a/static/img/accessibility/spreadsheet_contrast_light.png b/static/img/accessibility/spreadsheet_contrast_light.png
new file mode 100644
index 00000000..d29a9fb4
Binary files /dev/null and b/static/img/accessibility/spreadsheet_contrast_light.png differ
diff --git a/static/img/accessibility/toolbar_dropdown_focus.png b/static/img/accessibility/toolbar_dropdown_focus.png
new file mode 100644
index 00000000..dac3678c
Binary files /dev/null and b/static/img/accessibility/toolbar_dropdown_focus.png differ
diff --git a/static/img/add_column_context_menu.png b/static/img/add_column_context_menu.png
index 0c683ddc..47c80998 100644
Binary files a/static/img/add_column_context_menu.png and b/static/img/add_column_context_menu.png differ
diff --git a/static/img/add_row_context_menu.png b/static/img/add_row_context_menu.png
index fe8298ea..079f7834 100644
Binary files a/static/img/add_row_context_menu.png and b/static/img/add_row_context_menu.png differ
diff --git a/static/img/column_autofit.png b/static/img/column_autofit.png
index e7c5a520..e2275e6a 100644
Binary files a/static/img/column_autofit.png and b/static/img/column_autofit.png differ
diff --git a/static/img/column_context_menu.png b/static/img/column_context_menu.png
index 0cd92396..aea0566f 100644
Binary files a/static/img/column_context_menu.png and b/static/img/column_context_menu.png differ
diff --git a/static/img/column_width_context_menu.png b/static/img/column_width_context_menu.png
new file mode 100644
index 00000000..71cf698a
Binary files /dev/null and b/static/img/column_width_context_menu.png differ
diff --git a/static/img/column_width_dialog.png b/static/img/column_width_dialog.png
new file mode 100644
index 00000000..68efc3a7
Binary files /dev/null and b/static/img/column_width_dialog.png differ
diff --git a/static/img/freeze_columns_context_menu.png b/static/img/freeze_columns_context_menu.png
index 26eb8328..7344c8c3 100644
Binary files a/static/img/freeze_columns_context_menu.png and b/static/img/freeze_columns_context_menu.png differ
diff --git a/static/img/freeze_rows_context_menu.png b/static/img/freeze_rows_context_menu.png
index 9f715280..be5b3199 100644
Binary files a/static/img/freeze_rows_context_menu.png and b/static/img/freeze_rows_context_menu.png differ
diff --git a/static/img/hide_columns_context_menu.png b/static/img/hide_columns_context_menu.png
index 74c5a12a..6064bf4c 100644
Binary files a/static/img/hide_columns_context_menu.png and b/static/img/hide_columns_context_menu.png differ
diff --git a/static/img/hide_row_context_menu.png b/static/img/hide_row_context_menu.png
index 041c1ae6..b36f9cc4 100644
Binary files a/static/img/hide_row_context_menu.png and b/static/img/hide_row_context_menu.png differ
diff --git a/static/img/open_filter_context_menu.png b/static/img/open_filter_context_menu.png
new file mode 100644
index 00000000..e2bdf6a7
Binary files /dev/null and b/static/img/open_filter_context_menu.png differ
diff --git a/static/img/remove_column_context_menu.png b/static/img/remove_column_context_menu.png
index 754701e5..63ee33fc 100644
Binary files a/static/img/remove_column_context_menu.png and b/static/img/remove_column_context_menu.png differ
diff --git a/static/img/remove_merged_rows_context_menu.png b/static/img/remove_merged_rows_context_menu.png
new file mode 100644
index 00000000..677c18b7
Binary files /dev/null and b/static/img/remove_merged_rows_context_menu.png differ
diff --git a/static/img/remove_row_context_menu.png b/static/img/remove_row_context_menu.png
index e9a61dc6..a177e8f7 100644
Binary files a/static/img/remove_row_context_menu.png and b/static/img/remove_row_context_menu.png differ
diff --git a/static/img/row_height_context_menu.png b/static/img/row_height_context_menu.png
new file mode 100644
index 00000000..2bffb3a7
Binary files /dev/null and b/static/img/row_height_context_menu.png differ
diff --git a/static/img/row_height_dialog.png b/static/img/row_height_dialog.png
new file mode 100644
index 00000000..34f58f5d
Binary files /dev/null and b/static/img/row_height_dialog.png differ
diff --git a/static/img/show_columns_context_menu.png b/static/img/show_columns_context_menu.png
index 19084b59..4ccde606 100644
Binary files a/static/img/show_columns_context_menu.png and b/static/img/show_columns_context_menu.png differ
diff --git a/static/img/show_rows_context_menu.png b/static/img/show_rows_context_menu.png
index 76fdb28e..e701b075 100644
Binary files a/static/img/show_rows_context_menu.png and b/static/img/show_rows_context_menu.png differ
diff --git a/static/img/unfreeze_columns_context_menu.png b/static/img/unfreeze_columns_context_menu.png
index 91715ac1..2b67d083 100644
Binary files a/static/img/unfreeze_columns_context_menu.png and b/static/img/unfreeze_columns_context_menu.png differ
diff --git a/static/img/unfreeze_rows_context_menu.png b/static/img/unfreeze_rows_context_menu.png
index 5334c41c..855bd467 100644
Binary files a/static/img/unfreeze_rows_context_menu.png and b/static/img/unfreeze_rows_context_menu.png differ