[update] grid data export guides

mafanya23 · mafanya23 · commit 489e8f7e29bf · 2025-07-02T18:26:43.000+03:00
diff --git a/docs/grid/api/export/grid_csv_method.md b/docs/grid/api/export/grid_csv_method.md
@@ -13,7 +13,7 @@ description: You can explore the csv export method of Grid in the documentation
 @params:
 - `config` - (optional) an object with export settings. You can specify the following settings for export to CSV:
     - `asFile?: boolean` - (optional) defines whether Grid should be exported to a file, *true* by default. To export Grid only as a CSV string, you need to set *asFile:false*
-    - `name?: string` - (optional) the name of the exported CSV file (if asFile is not set to *false*)
+    - `name?: string` - (optional) "grid" by default. The name of the exported CSV file (if asFile is not set to *false*)
     - `rowDelimiter?: string` - (optional) a newline ("\n") by default. A separator between rows, can be a tab - "\t", or any other value
     - `columnDelimiter?: string` - (optional) a comma (",") by default. A separator between columns, can be a semicolon - ";", or any other value
 
@@ -26,9 +26,9 @@ grid.export.csv();
 
 // export with config settings
 grid.export.csv({
-    name:"grid_data", // grid data will be exported to a CSV file named "grid_data"
-    rowDelimiter: "\t", // the tab delimiter will be used to separate rows
-    columnDelimiter: ";" // the semicolon delimiter will be used to separate columns
+    name: "my_file", // the name of a ready CSV file
+    rowDelimiter: "\t", // the delimiter used to separate rows
+    columnDelimiter: ";" // the delimiter used to separate columns
 });
 
 
diff --git a/docs/grid/api/export/grid_xlsx_method.md b/docs/grid/api/export/grid_xlsx_method.md
@@ -16,22 +16,21 @@ DHTMLX Grid uses the WebAssembly-based library [Json2Excel](https://github.com/d
 
 @params:
 - `config` - (optional) an object with export settings. You can specify the following settings for export to Excel:
-    - `url?: string` - (optional) the link to the **worker.js** file of the [Json2Excel](https://github.com/dhtmlx/json2excel) library where export will be processed
-    - `name?: string` - (optional) the name of a ready Excel file
-    - `tableName?: string` - (optional) the name of a sheet with grid data in the Excel file
-    - `dateFormatMask?: string` - (optional) the mask used for [dates formatting in Excel](https://support.microsoft.com/en-us/office/format-a-date-the-way-you-want-in-excel-8e10019e-d5d8-47a1-ba95-db95123d273e) 
+    - `url?: string` - (optional) a local path to the **worker.js** file of the [Json2Excel](https://github.com/dhtmlx/json2excel) library (where export will be processed) set as `"../libs/json2excel/1.3/worker.js?vx"`
+    - `name?: string` - (optional) "grid" by default. The name of a ready Excel file
+    - `tableName?: string` - (optional) "data" by default. The name of a sheet with grid data in the Excel file
+    - `dateFormatMask?: string` - (optional) "dd/mm/yy" by default. The mask used for [dates formatting in Excel](https://support.microsoft.com/en-us/office/format-a-date-the-way-you-want-in-excel-8e10019e-d5d8-47a1-ba95-db95123d273e)
 
 @example:
 // default export
 grid.export.xlsx();
 
 // export with config settings
 grid.export.xlsx({
-    // a local path to the `worker.js` file of the Json2Excel library
-    url: "../libs/json2excel/1.3/worker.js?vx", 
-    name: "my_file",
-    tableName: "grid",
-    dateFormatMask: "mm.dd.yy"
+    url: "../libs/json2excel/1.3/worker.js?vx", // a local path to the `worker.js` file of the export module
+    name: "my_file", // the name of a ready Excel file
+    tableName: "grid", // the name of a sheet with grid data in the Excel file
+    dateFormatMask: "mm.dd.yy" // the date format mask for Excel
 });
 
 @descr:
diff --git a/docs/grid/usage.md b/docs/grid/usage.md
@@ -481,35 +481,34 @@ DHTMLX Grid uses the WebAssembly-based library [Json2Excel](https://github.com/d
 
 - install the [Json2Excel](https://github.com/dhtmlx/json2excel) library
 - if you need to set a local path to the export module on your computer, specify the `url` option in the configuration object of the [`xlsx()`](grid/api/export/grid_xlsx_method.md) method and set the path to the **worker.js** file like: `"../libs/json2excel/1.3/worker.js?vx"`. If the local path isn't set, the link to the file from CDN will be used
-- call the [`xlsx()`](grid/api/export/grid_xlsx_method.md) method of the `Export` module with the provided settings (all settings are optional)
+- call the [`xlsx()`](grid/api/export/grid_xlsx_method.md) method of the `Export` module. The method takes an [object with export settings](grid/api/export/grid_xlsx_method.md) as a parameter (all settings are optional)
 
 ~~~jsx
 grid.export.xlsx({
-    // a local path to the `worker.js` file of the Json2Excel library 
-    url: "../libs/json2excel/1.3/worker.js?vx", 
-    name: "my_file", // the name of a ready Excel file
-    tableName: "grid", // the name of a sheet with grid data in the Excel file
-    dateFormatMask: "mm.dd.yy" // the mask used for dates formatting in Excel
+    url: "../libs/json2excel/1.3/worker.js?vx", // a local path to the export module
+    name: "my_file", // the name of a ready Excel file, "grid" by default
+    tableName: "grid", // the name of a sheet with grid data in the Excel file, "data" by default
+    dateFormatMask: "mm.dd.yy" // the date format mask for Excel, "dd/mm/yy" by default
 });
 ~~~
 
 :::note
 You can check the latest version of the Json2Excel library at the [github repository](https://github.com/dhtmlx/json2excel).
 :::
 
-You can read the details on dates formatting in Excel in the [related Excel documentation](https://support.microsoft.com/en-us/office/format-a-date-the-way-you-want-in-excel-8e10019e-d5d8-47a1-ba95-db95123d273e). 
+Read the details on dates formatting in Excel in the [related Excel documentation](https://support.microsoft.com/en-us/office/format-a-date-the-way-you-want-in-excel-8e10019e-d5d8-47a1-ba95-db95123d273e). 
 
 **Related sample**: [Grid. Export to xlsx and csv](https://snippet.dhtmlx.com/58oqij47)
 
 #### Exporting data to CSV
 
-You can export data from Grid to the CSV format with the [`csv()`](grid/api/export/grid_csv_method.md) method of the Export module. 
+You can export data from Grid to the CSV format with the [`csv()`](grid/api/export/grid_csv_method.md) method of the Export module. The method takes an [object with export settings](grid/api/export/grid_csv_method.md) as a parameter (all settings are optional).
 
 ~~~jsx
 grid.export.csv({
-    name:"grid_data", // grid data will be exported to a CSV file named "grid_data"
-    rowDelimiter: "\t", // the tab delimiter will be used to separate rows
-    columnDelimiter: ";" // the semicolon delimiter will be used to separate columns
+    name: "my_file", // the name of a ready CSV file, "grid" by default
+    rowDelimiter: "\t", // the delimiter used to separate rows, "\n" (newline) by default
+    columnDelimiter: ";" // the delimiter used to separate columns, "," (comma) by default
 });
 ~~~
 
@@ -519,26 +518,26 @@ The `csv()` method returns a CSV string with Grid data.
 
 #### Exporting data to PDF
 
-The [`pdf()`](grid/api/export/grid_pdf_method.md) method of the Export module allows you to export data from Grid into a PDF file. The method takes an object with export settings as a parameter.
+The [`pdf()`](grid/api/export/grid_pdf_method.md) method of the Export module allows you to export data from Grid into a PDF file. The method takes an [object with export settings](grid/api/export/grid_pdf_method.md) as a parameter (all settings are optional).
 
 ~~~jsx
 grid.export.pdf({
-    format: "A4",
-    scale: 0.75,
-    displayHeaderFooter: true,
-    theme: "dark",
+    format: "A4", // the format of the output file, "A4" by default
+    scale: 0.75, // the scale of the grid rendering (between 0.1 and 2)
+    displayHeaderFooter: true, // defines whether to display the header and footer, false by default
+    theme: "dark" // the exported theme, "light" by default
 });
 ~~~
 
 **Related sample**: [Grid. Export to PDF/PNG](https://snippet.dhtmlx.com/ti9l91mn)
 
 #### Exporting data to PNG
 
-The [`png()`](grid/api/export/grid_png_method.md) method of the Export module allows you to export data from Grid into a PNG file. The method takes an object with export settings as a parameter.
+The [`png()`](grid/api/export/grid_png_method.md) method of the Export module allows you to export data from Grid into a PNG file. The method takes an [object with export settings](grid/api/export/grid_png_method.md) as a parameter (all settings are optional).
 
 ~~~jsx
 grid.export.png({
-    theme: "dark",
+    theme: "dark" // the exported theme, "light" by default
 });
 ~~~
 
diff --git a/docs/whatsnew.md b/docs/whatsnew.md
@@ -40,7 +40,7 @@ Released on June X, 2025
 
 - Grid. The logic and appearance of the [drag-n-drop functionality](grid/configuration.md/#drag-n-drop) is improved. Check the [related sample](https://snippet.dhtmlx.com/uevdwjuo) 
 - Grid. The [export to Excel](grid/usage.md/#exporting-data-to-excel) functionality is updated. The [Json2Excel](https://github.com/dhtmlx/json2excel) module is now used for exporting Grid data to Excel. Check the [Migration guide](migration.md/#91---92) for details
-- Grid. The [`xlsx()`](grid/api/export/grid_xlsx_method.md) method of the Export module gets two new properties:
+- Grid. The [`xlsx()`](grid/api/export/grid_xlsx_method.md) method of the Export module gets two new configuration settings:
     - `tableName`- to set the name of a sheet with grid data in the Excel file
     - `dateFormatMask` - to set the date format mask for Excel
 - Grid. The possibility to use keyboard navigation for [selecting ranges of cells](grid/configuration.md/#shortcut-keys-for-selecting-ranges-of-cells). The following shortcut keys and their combinations are available: 
