Skip to content

Commit 1612ff3

Browse files
dimodidimodi
authored andcommitted
Address PR suggestions
1 parent afd40b3 commit 1612ff3

File tree

5 files changed

+15
-13
lines changed

5 files changed

+15
-13
lines changed

_contentTemplates/grid/editing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#overview-required
22

3-
> This article requires the knowledge from [Grid CRUD Operations](slug:grid-editing-overview).
3+
> Make sure to read the [Grid CRUD Operations](slug:grid-editing-overview) article first.
44
55
#end
66

_contentTemplates/treelist/editing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#overview-required
22

3-
> This article requires the knowledge from [TreeList CRUD Operations](slug:treelist-editing-overview).
3+
> Make sure to read the [TreeList CRUD Operations](slug:treelist-editing-overview) article first.
44
55
#end
66

components/grid/editing/overview.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The Grid offers several ways to add and edit rows with a different user experien
4848

4949
To allow users to add or edit values in the Grid:
5050

51-
1. Set the `EditMode` parameter to a [member of the `GridEditMode` enum](slug:telerik.blazor.grideditmode). The default `EditMode` parameter value is `None`. The built-in [`Add` and `Edit` commands](slug://components/grid/columns/command#built-in-commands) don't work in this case.
51+
1. Set the `EditMode` parameter to a [member of the `GridEditMode` enum](slug:telerik.blazor.grideditmode). The default `EditMode` parameter value is `None` and the built-in [`Add` and `Edit` commands](slug://components/grid/columns/command#built-in-commands) don't work.
5252
1. Define the required [command buttons](#commands) and [events](#events) for the selected edit mode and operations.
5353

5454
>caption Set up Grid popup edit mode
@@ -114,6 +114,8 @@ The following table describes the Grid events, which are related to adding, dele
114114
| `OnModelInit` | [Depends on the Grid model type](slug:grid-events#onmodelinit) | Fires when the Grid requires a [new model instance](#item-instances), which is immediately before `OnAdd` or immediately after `OnEdit`. <br /> Use this event when the Grid model type is an [interface, abstract class, or has no parameterless constructor](slug:grid-events#onmodelinit). | No event arguments | Not cancellable |
115115
| `OnUpdate` | To edit existing items. | Fires on `Save` command invocation for existing items. This event succeeds `OnEdit`. | [Cloned](#item-instances) | Grid remains in edit mode. |
116116

117+
The following considerations apply for the Grid CRUD events:
118+
117119
* Most events provide a [`GridCommandEventArgs` argument](#gridcommandeventargs) in the handler. `OnModelInit` has no event argument.
118120
* All events, except `OnModelInit`, are cancellable and the user action can be prevented. Cancelling `OnDelete` does not automatically prevent item deletion from the Grid data source. This depends entirely on the executed application code.
119121
* The `OnCreate`, `OnDelete`, and `OnUpdate` events are required when using add, delete, and edit operations, respectively. The app must use these events to modify the Grid data source. [The Grid does not modify its data directly](#item-instances).

components/treelist/editing/incell.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -80,9 +80,7 @@ To see how to select the row that is currently in in-cell edit mode without usin
8080

8181
[Cell selection](slug:treelist-selection-cell) is not supported with in-cell edit mode.
8282

83-
## Examples
84-
85-
### Basic
83+
## Example
8684

8785
The example below shows how to:
8886

components/treelist/editing/overview.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,8 @@ The Telerik TreeList for Blazor supports create, update, and delete operations (
1515

1616
* [How the create, update, and delete operations work in the TreeList](#basics).
1717
* [What are the available edit modes and how to enable them](#edit-modes).
18-
* [The applicable TreeList commands](#commands)
19-
* [The applicable TreeList events](#events)
18+
* [The applicable TreeList commands](#commands).
19+
* [The applicable TreeList events](#events).
2020
* [How to change the built-in editors for certain data types](#column-editors).
2121
* [How to refresh the TreeList data after add, edit, and delete operations](#rebinding-after-data-changes).
2222
* [How the TreeList CRUD operations integrate with other component features](#integration-with-other-features).
@@ -48,7 +48,7 @@ The TreeList offers several ways to add and edit rows with a different user expe
4848

4949
To allow users to add or edit values in the TreeList:
5050

51-
1. Set the `EditMode` parameter to a [member of the `TreeListEditMode` enum](slug:telerik.blazor.treelisteditmode). The default `EditMode` parameter value is `None`. The built-in [`Add` and `Edit` commands](slug://treelist-columns-command#built-in-commands) don't work in this case.
51+
1. Set the `EditMode` parameter to a [member of the `TreeListEditMode` enum](slug:telerik.blazor.treelisteditmode). The default `EditMode` parameter value is `None` and the built-in [`Add` and `Edit` commands](slug://treelist-columns-command#built-in-commands) don't work.
5252
1. Define the required [command buttons](#commands) and [events](#events) for the selected edit mode and operations.
5353

5454
>caption Set up TreeList popup edit mode
@@ -64,21 +64,21 @@ To allow users to add or edit values in the TreeList:
6464
</TelerikTreeList>
6565
````
6666

67-
>tip See the TreeList add and edit operations in action in the complete examples for TreeList [inline](slug:treelist-editing-inline#example), [in-cell](slug:treelist-editing-incell#example) and [popup](slug:treelist-editing-popup#example) editing.
67+
>tip See the TreeList add and edit operations in action in the complete examples for TreeList [inline](slug:treelist-editing-inline#example), [in-cell](slug:treelist-editing-incell#example), and [popup](slug:treelist-editing-popup#example) editing.
6868
6969
> Editing multiple rows at the same time is not supported. You can [render editors in all TreeList data cells through column `<Template>`s](slug:grid-kb-edit-all-rows-cells) as an alternative.
7070
7171
### Delete Operations
7272

7373
Delete operations provide the same user experience in all TreeList edit modes and require the same configuration:
7474

75-
* [**Delete** command button](#commands)
76-
* [`OnDelete` event](#events)
75+
* [**Delete** command button](#commands).
76+
* [`OnDelete` event](#events).
7777
* Optional `ConfirmDelete` TreeList parameter. It determines if the component will show a Dialog before firing `OnDelete`, so that users can abort the operation.
7878

7979
Delete operations can work even if the TreeList `EditMode` parameter value is `None`.
8080

81-
>tip See delete operations in action in the complete examples for TreeList [inline](slug:treelist-editing-inline#example), [in-cell](slug:treelist-editing-incell#example) and [popup](slug:treelist-editing-popup#example) editing. Also check how to [customize the Delete Confirmation Dialog](slug:grid-kb-customize-delete-confirmation-dialog).
81+
>tip See the delete operations in action in the complete examples for TreeList [inline](slug:treelist-editing-inline#example), [in-cell](slug:treelist-editing-incell#example) and [popup](slug:treelist-editing-popup#example) editing. Also check how to [customize the Delete Confirmation Dialog](slug:grid-kb-customize-delete-confirmation-dialog).
8282
8383
## Commands
8484

@@ -114,6 +114,8 @@ The following table describes the TreeList events, which are related to adding,
114114
| `OnModelInit` | [Depends on the TreeList model type](slug:treelist-events#onmodelinit) | Fires when the TreeList requires a [new model instance](#item-instances), which is immediately before `OnAdd` or immediately after `OnEdit`. <br /> Use this event when the TreeList model type is an [interface, abstract class, or has no parameterless constructor](slug:treelist-events#onmodelinit). | No event arguments | Not cancellable |
115115
| `OnUpdate` | To edit existing items. | Fires on `Save` command invocation for existing items. This event succeeds `OnEdit`. | [Cloned](#item-instances) | TreeList remains in edit mode. |
116116

117+
The following considerations apply for the TreeList CRUD events:
118+
117119
* Most events provide a [`TreeListCommandEventArgs` argument](#treelistcommandeventargs) in the handler. `OnModelInit` has no event argument.
118120
* All events, except `OnModelInit`, are cancellable and the user action can be prevented. Cancelling `OnDelete` does not automatically prevent item deletion from the TreeList data source. This depends entirely on the executed application code.
119121
* The `OnCreate`, `OnDelete`, and `OnUpdate` events are required when using add, delete, and edit operations, respectively. The app must use these events to modify the TreeList data source. [The TreeList does not modify its data directly](#item-instances).

0 commit comments

Comments
 (0)