persian-data-grid 0.7.2 → 0.7.4

package/README.md

@@ -22,6 +22,7 @@ A **Data Grid** for enterprise forms: voucher lines, money columns, Jalali date
 - [Install](#install)
 - [Quick start](#quick-start)
 - [API overview](#api-overview)
+- [Keyboard shortcuts](#keyboard-shortcuts)
 - [Demo](#demo)
 - [فارسی](#فارسی)
 - [Changelog](#changelog)
@@ -144,6 +145,56 @@ See [docs/public-api.md](./docs/public-api.md), [docs/getting-started.md](./docs
 Product docs site (English source + فارسی, live demos, TypeDoc API): `yarn docs:dev` — build with `yarn docs:build` (also in CI).
 ---
 
+## Keyboard shortcuts
+
+Active while focus is inside the grid (`UITableKeyboardHandler`). Full reference, including clipboard, range selection and undo: [`docs/keyboard.md`](https://github.com/hamidrezafallahi/ERP-Table/blob/master/docs/keyboard.md). Persian list: [فارسی](#فارسی).
+
+### Cell navigation and editing
+
+| Shortcut | Action |
+|---|---|
+| `Enter` / `NumpadEnter` | No active cell → activate the first cell of the active row; otherwise → next cell |
+| `Shift+Enter` | Previous cell |
+| `Tab` | Next cell (needs an active row and cell) |
+| `Shift+Tab` | Previous cell (needs an active row and cell) |
+| `ArrowLeft` | Next cell (RTL: document order) |
+| `ArrowRight` | Previous cell (RTL: document order) |
+| `ArrowUp` | Move the active cell up in the same column |
+| `ArrowDown` | Move the active cell down in the same column |
+
+### Row selection and reordering
+
+| Shortcut | Action |
+|---|---|
+| `Ctrl+Space` | Toggle selection of the active row |
+| `Shift+End` | Toggle selection of the active row |
+| `Ctrl+Shift+End` | Select from the active row to the last row |
+| `Ctrl+ArrowUp` / `Ctrl+ArrowDown` | Move the active row up / down |
+| `Alt+ArrowUp` / `Alt+ArrowDown` | Move the selected rows up / down (needs a selection) |
+
+### Row and table operations
+
+| Shortcut | Action |
+|---|---|
+| `Alt+N` | Add an empty row and activate it |
+| `Alt+D` | Duplicate the active row |
+| `Alt+Delete` | Delete the active row |
+| `Alt+ArrowLeft` | Collapse all expanded rows |
+| `Alt+C` / `Alt+X` / `Alt+V` | Table copy / cut / paste mode |
+| `Alt+B` | Paste-as-insert mode |
+| `Escape` | Clear the current table action |
+
+### Pagination
+
+| Shortcut | Action |
+|---|---|
+| `PageUp` | Previous page (no-op on the first page) |
+| `PageDown` | Next page (no-op on the last page) |
+
+`Ctrl` and `Alt` are the browser modifier keys; `Meta` (⌘) is not treated as `Ctrl`.
+
+---
+
 ## Demo
 
 | Page | URL |
@@ -196,6 +247,64 @@ import 'persian-data-grid/styles.css';
 />
 ```
 
+### میانبرهای صفحه‌کلید
+
+وقتی focus داخل گرید است این میانبرها فعال‌اند (پیاده‌سازی در `UITableKeyboardHandler`).
+
+#### جابه‌جایی و ویرایش سلول
+
+| میانبر | عملکرد |
+|---|---|
+| `Enter` یا `NumpadEnter` | اگر سلول فعالی وجود نداشته باشد، نخستین سلول سطر فعال را فعال می‌کند؛ در غیر این صورت به سلول بعدی می‌رود. |
+| `Shift+Enter` | به سلول قبلی می‌رود. |
+| `Tab` | با وجود سطر و سلول فعال، به سلول بعدی می‌رود. |
+| `Shift+Tab` | با وجود سطر و سلول فعال، به سلول قبلی می‌رود. |
+| `ArrowLeft` | با وجود سطر و سلول فعال، به سلول بعدی می‌رود. |
+| `ArrowRight` | با وجود سطر و سلول فعال، به سلول قبلی می‌رود. |
+| `ArrowUp` | با وجود سطر و سلول فعال، سلول فعال را در همان ستون به بالا می‌برد. |
+| `ArrowDown` | با وجود سطر و سلول فعال، سلول فعال را در همان ستون به پایین می‌برد. |
+
+> جهت حرکت بین سلول‌ها همان `next` و `prev` موتور جدول است؛ در نتیجه الزاماً با جهت بصری فلش چپ و راست یکی نیست.
+
+#### انتخاب و جابه‌جایی سطر
+
+| میانبر | عملکرد |
+|---|---|
+| `Ctrl+Space` | انتخاب سطر فعال را تغییر می‌دهد (انتخاب یا لغو انتخاب). |
+| `Shift+End` | انتخاب سطر فعال را تغییر می‌دهد (انتخاب یا لغو انتخاب). |
+| `Ctrl+Shift+End` | از سطر فعال تا آخر، سطرها را انتخاب می‌کند. |
+| `Ctrl+ArrowUp` | سطر فعال را به بالا جابه‌جا می‌کند. |
+| `Ctrl+ArrowDown` | سطر فعال را به پایین جابه‌جا می‌کند. |
+| `Alt+ArrowUp` | سطرهای انتخاب‌شده را به بالا جابه‌جا می‌کند؛ باید سطری انتخاب شده باشد. |
+| `Alt+ArrowDown` | سطرهای انتخاب‌شده را به پایین جابه‌جا می‌کند؛ باید سطری انتخاب شده باشد. |
+
+#### عملیات سطر و جدول
+
+| میانبر | عملکرد |
+|---|---|
+| `Alt+N` | یک سطر خالی اضافه و آن را فعال می‌کند. |
+| `Alt+D` | سطر فعال را کپی می‌کند؛ وجود سطر فعال لازم است. |
+| `Alt+Delete` | سطر فعال را حذف می‌کند؛ وجود سطر فعال لازم است. |
+| `Alt+ArrowLeft` | همهٔ سطرهای بازشده را می‌بندد. |
+| `Alt+C` | حالت کپی جدول را فعال می‌کند. |
+| `Alt+X` | حالت برش جدول را فعال می‌کند. |
+| `Alt+V` | حالت چسباندن جدول را فعال می‌کند. |
+| `Alt+B` | حالت چسباندن به‌صورت درج را فعال می‌کند. |
+| `Escape` | کنش جاری جدول را پاک می‌کند. |
+
+#### صفحه‌بندی
+
+| میانبر | عملکرد |
+|---|---|
+| `PageUp` | به صفحهٔ قبلی می‌رود؛ اگر صفحهٔ قبلی وجود نداشته باشد کاری نمی‌کند. |
+| `PageDown` | به صفحهٔ بعدی می‌رود؛ اگر صفحهٔ بعدی وجود نداشته باشد کاری نمی‌کند. |
+
+#### نکته‌ها
+
+- `Ctrl` و `Alt` بر اساس کلیدهای اصلاح‌کنندهٔ مرورگر تعریف شده‌اند؛ `Meta` جایگزین `Ctrl` نیست.
+- میانبرهای وابسته به سطر فقط وقتی اجرا می‌شوند که سطر فعال پیدا شود. اگر focus داخل کنترل انتخاب باشد، هندلر برای یافتن سطر فعال از وضعیت موتور و سپس سطر انتخاب‌شده کمک می‌گیرد.
+- میانبرهای `Tab` و فلش‌ها فقط وقتی به حرکت سلول منجر می‌شوند که سطر و ستون فعال موجود باشند.
+
 ### دمو زنده
 
 [https://hamidrezafallahi.github.io/ERP-Table/](https://hamidrezafallahi.github.io/ERP-Table/)

package/dist/index.cjs

@@ -954,7 +954,7 @@ function Excel({ config, className }) {
           "path",
           {
             d: "M6.3 10.7l2.2-.1 1.3 3.7 1.6-3.9 2.2-.1-2.6 5.2 2.6 5.3-2.3-.2-1.5-4-1.5 3.9-2.1-.2 2.4-4.6z",
-            fill: "#fff"
+            fill: "#585858"
           }
         )
       ]