Skip to content

Commit c669535

Browse files
Merge pull request #79 from DHTMLX/next
Next
2 parents af161b6 + 52a125d commit c669535

722 files changed

Lines changed: 64873 additions & 542 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/angular_integration.md‎

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,14 @@ DHTMLX Spreadsheet is compatible with **Angular**. We have prepared code example
1818
Before you start to create a new project, install [**Angular CLI**](https://angular.dev/tools/cli) and [**Node.js**](https://nodejs.org/en/).
1919
:::
2020

21-
Create a new **my-angular-spreadsheet-app** project using Angular CLI. Run the following command for this purpose:
21+
Create a new *my-angular-spreadsheet-app* project using Angular CLI. Run the following command:
2222

2323
~~~json
2424
ng new my-angular-spreadsheet-app
2525
~~~
2626

2727
:::note
28-
If you want to follow this guide, disable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) when creating new Angular app!
28+
If you want to follow this guide, disable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) when creating a new Angular app.
2929
:::
3030

3131
The command above installs all the necessary tools, so you don't need to run any additional commands.
@@ -45,25 +45,25 @@ yarn
4545
yarn start
4646
~~~
4747

48-
The app should run on a localhost (for instance `http://localhost:3000`).
48+
The app should run on localhost (for instance `http://localhost:3000`).
4949

5050
## Creating Spreadsheet
5151

52-
Now you should get the DHTMLX Spreadsheet source code. First of all, stop the app and proceed with installing the Spreadsheet package.
52+
Now you should get the DHTMLX Spreadsheet source code. First, stop the app and install the Spreadsheet package.
5353

5454
### Step 1. Package installation
5555

56-
Download the [**trial Spreadsheet package**](how_to_start.md#installing-spreadsheet-via-npm-or-yarn) and follow steps mentioned in the README file. Note that trial Spreadsheet is available 30 days only.
56+
Download the [**trial Spreadsheet package**](how_to_start.md#installing-spreadsheet-via-npm-or-yarn) and follow the steps in the README file. Note that trial Spreadsheet is available for 30 days only.
5757

5858
### Step 2. Component creation
5959

60-
Now you need to create an Angular component, to add Spreadsheet into the application. Create the **spreadsheet** folder in the **src/app/** directory, add a new file into it and name it **spreadsheet.component.ts**. Then complete the steps described below.
60+
Now you need to create an Angular component to add Spreadsheet into the application. Create the *spreadsheet* folder in the *src/app/* directory, add a new file into it and name it *spreadsheet.component.ts*. Then complete the steps described below.
6161

6262
#### Importing source files
6363

6464
Open the file and import Spreadsheet source files. Note that:
6565

66-
- if you use PRO version and install the Spreadsheet package from a local folder, the imported path looks like this:
66+
- if you use the PRO version and install the Spreadsheet package from a local folder, the imported path looks like this:
6767

6868
~~~jsx
6969
import { Spreadsheet } from 'dhx-spreadsheet-package';
@@ -111,7 +111,7 @@ export class SpreadsheetComponent implements OnInit, OnDestroy {
111111

112112
#### Adding styles
113113

114-
To display Spreadsheet correctly, you need to provide the corresponding styles. For this purpose, you can create the **spreadsheet.component.css** file in the **src/app/spreadsheet/** directory and specify important styles for Spreadsheet and its container:
114+
To display Spreadsheet correctly, you need to provide the corresponding styles. For this purpose, you can create the *spreadsheet.component.css* file in the *src/app/spreadsheet/* directory and specify important styles for Spreadsheet and its container:
115115

116116
~~~css title="spreadsheet.component.css"
117117
/* import Spreadsheet styles */
@@ -133,7 +133,7 @@ body {
133133

134134
#### Loading data
135135

136-
To add data into Spreadsheet, you need to provide a data set. You can create the **data.ts** file in the **src/app/spreadsheet/** directory and add some data into it:
136+
To add data into Spreadsheet, you need to provide a data set. You can create the *data.ts* file in the *src/app/spreadsheet/* directory and add some data into it:
137137

138138
~~~jsx title="data.ts"
139139
export function getData(): any {
@@ -178,7 +178,7 @@ export function getData(): any {
178178
}
179179
~~~
180180

181-
Then open the ***spreadsheet.component.ts*** file. Import the file with data and apply it using the [`parse()`](api/spreadsheet_parse_method.md) method within the `ngOnInit()` method, as shown below.
181+
Then open the *spreadsheet.component.ts* file. Import the file with data and apply it using the [`parse()`](api/spreadsheet_parse_method.md) method within the `ngOnInit()` method, as shown below.
182182

183183
~~~jsx {2,18,21} title="spreadsheet.component.ts"
184184
import { Spreadsheet } from "@dhx/trial-spreadsheet";
@@ -210,13 +210,13 @@ export class SpreadsheetComponent implements OnInit, OnDestroy {
210210
}
211211
~~~
212212

213-
Now the Spreadsheet component is ready to use. When the element will be added to the page, it will initialize the Spreadsheet with data. You can provide necessary configuration settings as well. Visit our [Spreadsheet API docs](api/overview/events_overview.md) to check the full list of available properties.
213+
Now the Spreadsheet component is ready to use. When the element is added to the page, it initializes Spreadsheet with data. You can provide necessary configuration settings as well. Visit our [Spreadsheet API docs](api/overview/events_overview.md) to check the full list of available properties.
214214

215215
#### Handling events
216216

217-
When a user makes some action in the Spreadsheet, it invokes an event. You can use these events to detect the action and run the desired code for it. See the [full list of events](api/overview/events_overview.md).
217+
When a user performs an action in Spreadsheet, the widget invokes an event. You can use these events to detect the action and run the desired code for it. See the [full list of events](api/overview/events_overview.md).
218218

219-
Open the **spreadsheet.component.ts** file and complete the `ngOnInit()` method as in:
219+
Open the *spreadsheet.component.ts* file and complete the `ngOnInit()` method as in:
220220

221221
~~~jsx {5-8} title="spreadsheet.component.ts"
222222
// ...
@@ -236,7 +236,7 @@ ngOnDestroy() {
236236

237237
### Step 3. Adding Spreadsheet into the app
238238

239-
To add the ***SpreadsheetComponent*** component into the app, open the ***src/app/app.component.ts*** file and replace the default code with the following one:
239+
To add the `SpreadsheetComponent` component into the app, open the *src/app/app.component.ts* file and replace the default code with the following one:
240240

241241
~~~jsx {5} title="app.component.ts"
242242
import { Component } from "@angular/core";
@@ -250,7 +250,7 @@ export class AppComponent {
250250
}
251251
~~~
252252

253-
Then create the ***app.module.ts*** file in the ***src/app/*** directory and specify the *SpreadsheetComponent* as shown below:
253+
Then create the *app.module.ts* file in the *src/app/* directory and specify the `SpreadsheetComponent` as shown below:
254254

255255
~~~jsx {4-5,8} title="app.module.ts"
256256
import { NgModule } from "@angular/core";
@@ -267,7 +267,7 @@ import { SpreadsheetComponent } from "./spreadsheet/spreadsheet.component";
267267
export class AppModule {}
268268
~~~
269269

270-
The last step is to open the ***src/main.ts*** file and replace the existing code with the following one:
270+
The last step is to open the *src/main.ts* file and replace the existing code with the following one:
271271

272272
~~~jsx title="main.ts"
273273
import { platformBrowserDynamic } from "@angular/platform-browser-dynamic";
@@ -281,4 +281,4 @@ After that, you can start the app to see Spreadsheet loaded with data on a page.
281281

282282
![DHTMLX Spreadsheet initialized with sample data in an Angular application](/img/integrations/trial_spreadsheet.png)
283283

284-
Now you know how to integrate DHTMLX Spreadsheet with Angular. You can customize the code according to your specific requirements. The final example you can find on [**GitHub**](https://github.com/DHTMLX/angular-spreadsheet-demo).
284+
Now you know how to integrate DHTMLX Spreadsheet with Angular. You can customize the code according to your specific requirements. You can find the final example on [**GitHub**](https://github.com/DHTMLX/angular-spreadsheet-demo).

‎docs/api/eventsbus_detach_method.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: You can learn about the detach events bus method in the documentati
88

99
### Description
1010

11-
@short: Detaches a handler from an event (which was attached before by the on() method)
11+
@short: Detaches a handler from an event (previously attached with the `on()` method)
1212

1313
### Usage
1414

@@ -18,7 +18,7 @@ detach(name: string): void;
1818

1919
### Parameters
2020

21-
- `name` - (required) the name of event to detach
21+
- `name` - (required) the name of the event to detach
2222

2323
### Example
2424

@@ -36,7 +36,7 @@ spreadsheet.events.detach("StyleChange");
3636
~~~
3737

3838
:::info
39-
By default **detach()** removes all event handlers from the target event. You can detach particular event handlers by using the context marker.
39+
By default, `detach()` removes all event handlers from the target event. You can detach particular event handlers using a context marker.
4040
:::
4141

4242
~~~jsx
@@ -48,4 +48,4 @@ spreadsheet.events.on("StyleChange", handler2, marker);
4848
spreadsheet.events.detach("StyleChange", marker);
4949
~~~
5050

51-
**Related articles:** [Event Handling](handling_events.md)
51+
**Related article:** [Event Handling](handling_events.md)

‎docs/api/eventsbus_fire_method.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ fire(name: string, arguments: array): boolean;
2727

2828
### Returns
2929

30-
The method returns `false`, if some of the event handlers return `false`. Otherwise, `true`
30+
The method returns `false` if some of the event handlers return `false`. Otherwise, `true`
3131

3232
### Example
3333

@@ -44,4 +44,4 @@ spreadsheet.events.on("CustomEvent", function(param1, param2){
4444
const res = spreadsheet.events.fire("CustomEvent", [12, "abc"]);
4545
~~~
4646

47-
**Related articles:** [Event Handling](handling_events.md)
47+
**Related article:** [Event Handling](handling_events.md)

‎docs/api/eventsbus_on_method.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ spreadsheet.events.on("StyleChange", function(id){
3737
:::info
3838
See the full list of the Spreadsheet events [here](api/api_overview.md#spreadsheet-events).
3939

40-
You can attach several handlers to the same event and all of them will be executed. If some of handlers return *false*, the related operations will be blocked. Event handlers are processed in the same order that they are attached.
40+
You can attach several handlers to the same event and all of them are executed. If some handlers return `false`, the related operations are blocked. Event handlers are processed in the same order that they are attached.
4141
:::
4242

43-
**Related articles:** [Event Handling](handling_events.md)
43+
**Related article:** [Event Handling](handling_events.md)
4444

4545
**Related sample:** [Spreadsheet. Events](https://snippet.dhtmlx.com/2vkjyvsi)

‎docs/api/export_json_method.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,6 @@ spreadsheet.export.json();
3030

3131
**Changelog:** Added in v4.3
3232

33-
**Related articles:** [Data loading and export](loading_data.md)
33+
**Related article:** [Data loading and export](loading_data.md)
3434

3535
**Related sample:** [Spreadsheet. Export/import JSON](https://snippet.dhtmlx.com/e3xct53l)

‎docs/api/export_xlsx_method.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,13 @@ spreadsheet.export.xlsx("MyData");
3636
~~~
3737

3838
:::note
39-
Please note that the component supports export to Excel files with the **.xlsx** extension only.
39+
Note that the component supports export to Excel files with the `.xlsx` extension only.
4040
:::
4141

4242
:::info
43-
DHTMLX Spreadsheet uses the WebAssembly-based library [Json2Excel](https://github.com/dhtmlx/json2excel) for export of data to Excel. [Check the details](loading_data.md#exporting-data).
43+
DHTMLX Spreadsheet uses the WebAssembly-based library [Json2Excel](https://github.com/dhtmlx/json2excel) to export data to Excel. [Check the details](loading_data.md#exporting-data).
4444
:::
4545

46-
**Related articles:** [Data loading and export](loading_data.md)
46+
**Related article:** [Data loading and export](loading_data.md)
4747

4848
**Related sample:** [Spreadsheet. Export Xlsx](https://snippet.dhtmlx.com/btyo3j8s)

‎docs/api/overview/actions_overview.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ description: You can check an Actions overview of the DHTMLX JavaScript Spreadsh
66

77
# Actions overview
88

9-
This section is dedicated to a new conception of interaction with Spreadsheet events.
9+
This section describes a new approach to interacting with Spreadsheet events.
1010

11-
Starting from v4.3, DHTMLX Spreadsheet includes a pair of the [beforeAction](api/spreadsheet_beforeaction_event.md)/[afterAction](api/spreadsheet_afteraction_event.md) events that are intended to make your code simple and concise. They will fire right before an action is executed and indicate which exactly action has been performed.
11+
Starting from v4.3, DHTMLX Spreadsheet includes a pair of [`beforeAction`](api/spreadsheet_beforeaction_event.md)/[`afterAction`](api/spreadsheet_afteraction_event.md) events that make your code simpler and more concise. They fire right before an action is executed and indicate exactly which action was performed.
1212

1313
~~~jsx
1414
spreadsheet.events.on("beforeAction", (actionName, config) => {
@@ -29,9 +29,9 @@ spreadsheet.events.on("afterAction", (actionName, config) => {
2929

3030
[The full list of the available actions is given below.](#list-of-actions)
3131

32-
>It means, that you don't have to constantly add sets of paired [**before-** and **after-**](api/overview/events_overview.md) events anymore to track and handle the actions which you execute when changing something in the spreadsheet.
32+
>This means that you no longer have to add sets of paired [**before-** and **after-**](api/overview/events_overview.md) events to track and handle the actions you execute when changing something in the spreadsheet.
3333
34-
>But if needed you can use an **old approach** because all the existing events will continue work as before:
34+
>But if needed, you can use the **old approach**, because all the existing events continue to work as before:
3535
~~~jsx
3636
spreadsheet.events.on("afterColumnAdd", function(cell){
3737
console.log("A new column is added", cell);
@@ -61,7 +61,7 @@ spreadsheet.events.on("beforeColumnAdd", function(cell){
6161
| **deleteSheet** | The action is executed when removing a sheet |
6262
| **filter** | The action is executed when filtering data in a sheet |
6363
| **fitColumn** | The action is executed when auto-fitting the width of the column |
64-
| **groupAction** | The action is executed when selecting a range of cells and applying to them some actions (for instance, change the style or format of cells, lock/unlock the cells, clear cells' value or styles, etc.) |
64+
| **groupAction** | The action is executed when selecting a range of cells and applying to them some actions (for instance, change the style or format of cells, lock/unlock the cells, or clear cells' value or styles) |
6565
| **insertLink** | The action is executed when inserting a hyperlink in a cell |
6666
| **lockCell** | The action is executed when locking/unlocking a cell |
6767
| **merge** | The action is executed when merging a range of cells |

‎docs/api/selection_getfocusedcell_method.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ getFocusedCell(): string;
1818

1919
### Returns
2020

21-
The method returns an id of a focused cell
21+
The method returns the id of the focused cell
2222

2323
### Example
2424

@@ -35,4 +35,4 @@ spreadsheet.selection.setFocusedCell("D4");
3535
const focused = spreadsheet.selection.getFocusedCell(); // ->"D4"
3636
~~~
3737

38-
**Related articles:** [Work with Spreadsheet](working_with_ssheet.md)
38+
**Related article:** [Work with Spreadsheet](working_with_ssheet.md)

‎docs/api/selection_getselectedcell_method.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ getSelectedCell(): string;
1818

1919
### Returns
2020

21-
The method returns an id(s) or a range of selected cell(s)
21+
The method returns the id(s) or a range of selected cell(s)
2222

2323
### Example
2424

@@ -33,4 +33,4 @@ spreadsheet.selection.setSelectedCell("B7,B3,D4,D6,E4:E8");
3333
const selected = spreadsheet.selection.getSelectedCell(); // -> "B7,B3,D4,D6,E4:E8"
3434
~~~
3535

36-
**Related articles:** [Work with Spreadsheet](working_with_ssheet.md)
36+
**Related article:** [Work with Spreadsheet](working_with_ssheet.md)

‎docs/api/selection_removeselectedcell_method.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,6 @@ spreadsheet.selection.removeSelectedCell("A3:A6,C2");
3737

3838
**Change log:** Added in v4.2
3939

40-
**Related articles:** [Work with Spreadsheet](working_with_ssheet.md)
40+
**Related article:** [Work with Spreadsheet](working_with_ssheet.md)
4141

4242
**Related sample:** [Spreadsheet. Remove selection](https://snippet.dhtmlx.com/u4j76cuh)

0 commit comments

Comments
 (0)