Skip to content

Commit 02ec7bc

Browse files
committed
998328: committed changes
1 parent eed2f31 commit 02ec7bc

File tree

4 files changed

+58
-69
lines changed

4 files changed

+58
-69
lines changed

blazor/treegrid/columns/column-spanning.md

Lines changed: 27 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -9,25 +9,9 @@ documentation: ug
99

1010
# Column Spanning in Blazor TreeGrid
1111

12-
Column spanning in the Blazor TreeGrid provides automatic vertical merging of adjacent cells within the same column when identical values are detected. This feature improves readability by consolidating repeated values into a single taller cell, which is especially useful when the same value appears across consecutive rows.
12+
Column spanning in the Blazor TreeGrid provides automatic vertical merging of adjacent cells within the same column when identical values are detected. This improves readability by consolidating repeated values into a single taller cell, which is especially useful when the same value appears across consecutive rows.
1313

14-
The functionality is enabled by setting the [AutoSpan](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.TreeGrid.SfTreeGrid-1.html#Syncfusion_Blazor_TreeGrid_SfTreeGrid_1_AutoSpan) property of the `SfTreeGrid` component to `AutoSpanMode.Column`. Once applied, the TreeGrid evaluates each column and merges stacked cells that share identical values, thereby reducing visual redundancy and presenting a cleaner, more structured layout. The merging process is fully declarative and requires no additional code or preprocessing.
15-
16-
Column spanning is part of the broader `AutoSpanMode` enumeration, which provides multiple options for customizing cell merging behavior in the Blazor TreeGrid. The available modes include `None`, `Row`, `Column`, and `HorizontalAndVertical`.
17-
18-
## AutoSpanMode enumeration
19-
20-
| Enum Value | Description |
21-
|---------|-----|
22-
| AutoSpanMode.None | Disables automatic cell spanning. Every cell remains isolated. (Default Mode) |
23-
| AutoSpanMode.Row | Enables horizontal merging across columns within the same row. |
24-
| AutoSpanMode.Column | Enables vertical merging of adjacent cells with identical values in the same column. |
25-
| AutoSpanMode.HorizontalAndVertical | Enables both horizontal and vertical merging. Executes row merging first, followed by column merging. |
26-
27-
28-
## Enabling column spanning
29-
30-
Vertical cell merging in the Blazor TreeGrid is enabled by setting the `AutoSpan` property of the `SfTreeGrid` component to `AutoSpanMode.Column`. In this mode, the TreeGrid automatically merges stacked cells that share identical values within the same column. This reduces redundancy across consecutive rows and provides a cleaner, more structured layout for repeated data. The merging process is fully declarative and requires no additional code or preprocessing.
14+
Column spanning is enabled by setting the [AutoSpan](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.TreeGrid.SfTreeGrid-1.html#Syncfusion_Blazor_TreeGrid_SfTreeGrid_1_AutoSpan) property of the `SfTreeGrid` component to `AutoSpanMode.Column`. When activated, the TreeGrid evaluates each column and merges stacked cells that share identical values, thereby reducing visual redundancy and presenting a cleaner, more structured layout. The merging process is fully declarative and requires no additional code or preprocessing.
3115

3216
{% tabs %}
3317
{% highlight razor tabtitle="Index.razor" %}
@@ -96,6 +80,15 @@ Vertical cell merging in the Blazor TreeGrid is enabled by setting the `AutoSpan
9680
{% endhighlight %}
9781
{% endtabs %}
9882

83+
## AutoSpanMode enumeration
84+
85+
Column spanning is part of the broader `AutoSpanMode` enumeration, which provides multiple options for customizing cell merging behavior in the Blazor TreeGrid. The available modes are:
86+
| Enum Value | Description |
87+
|---------|-----|
88+
| AutoSpanMode.None | Disables automatic cell spanning. Every cell remains isolated. (Default Mode) |
89+
| AutoSpanMode.Row | Enables horizontal merging across columns within the same row. |
90+
| AutoSpanMode.Column | Enables vertical merging of adjacent cells with identical values in the same column. |
91+
| AutoSpanMode.HorizontalAndVertical | Enables both horizontal and vertical merging. Executes row merging first, followed by column merging. |
9992

10093
## Disable column spanning for specific column
10194

@@ -497,21 +490,21 @@ Spanning in the Syncfusion Blazor TreeGrid can be disabled at the column level b
497490
{% endhighlight %}
498491
{% endtabs %}
499492

500-
The effective spanning behavior in the Blazor TreeGrid is determined by the intersection of TreeGrid-level and column-level `AutoSpan` modes. A column can only restrict the spanning directions permitted at the TreeGrid level and cannot enable a span direction that has been disabled globally. This ensures consistent behavior across the TreeGrid while allowing fine-grained control for individual columns.
493+
## Controlling spanning at the TreeGrid and column levels
501494

502-
### Complete combination matrix
495+
The spanning behavior is determined by how the TreeGrid‑level and column‑level `AutoSpan` settings interact. When spanning is disabled at the TreeGrid level, all spanning directions are turned off globally, and column settings cannot override this restriction. Column‑level `AutoSpan` can only narrow the spanning directions permitted by the TreeGrid, ensuring consistent behavior across the component while still allowing fine‑grained control at the column level.
503496

504497
| TreeGrid AutoSpan | Column AutoSpan | Effective Behavior |
505498
|---|---|---|
506499
| None | None | No spanning. Both TreeGrid and column explicitly disable spanning. |
507-
| None | Row | No spanning. TreeGrid-level None overrides column-level Row. |
508-
| None | Column | No spanning. TreeGrid-level None overrides column-level Column. |
509-
| None | HorizontalAndVertical | No spanning. TreeGrid-level None overrides all spanning modes. |
510-
| Row | None | No spanning. Column explicitly disables spanning. |
500+
| None | Row | No spanning. Both TreeGrid and column explicitly disable spanning. |
501+
| None | Column | No spanning. Both TreeGrid and column explicitly disable spanning. |
502+
| None | HorizontalAndVertical | No spanning. Both TreeGrid and column explicitly disable spanning. |
503+
| Row | None | No spanning occurs when all columns are set to None. Column explicitly disables spanning. |
511504
| Row | Row | Row spanning only. Both TreeGrid and column enable row spanning. |
512505
| Row | Column | No spanning. TreeGrid only allows row spanning; column cannot enable column spanning. |
513506
| Row | HorizontalAndVertical | Row spanning only. TreeGrid only allows row spanning. |
514-
| Column | None | No spanning. Column explicitly disables spanning. |
507+
| Column | None | No spanning occurs when all columns are set to None. Column explicitly disables spanning. |
515508
| Column | Row | No spanning. TreeGrid only allows column spanning; column cannot enable row spanning. |
516509
| Column | Column | Column spanning only. Both TreeGrid and column enable column spanning. |
517510
| Column | HorizontalAndVertical | Column spanning only. TreeGrid only allows column spanning. |
@@ -537,10 +530,10 @@ To define a merged region, use the following properties of the MergeCellInfo cla
537530

538531
| Property | Type | Description |
539532
|--------------|------|-----------------------------------------------------------------------------|
540-
| RowIndex | int | The zero-based index of the anchor row (top-left cell of the merged region). |
541-
| ColumnIndex | int | The zero-based index of the anchor column (top-left cell of the merged region). |
542-
| RowSpan | int (optional) | The number of rows to span, starting from the anchor cell. By default set to 1. |
543-
| ColumnSpan | int (optional) | The number of columns to span, starting from the anchor cell. By default set to 1. |
533+
| `RowIndex` | int | The zero-based index of the anchor row (top-left cell of the merged region). |
534+
| `ColumnIndex` | int | The zero-based index of the anchor column (top-left cell of the merged region). |
535+
| `RowSpan` | int (optional) | The number of rows to span, starting from the anchor cell. By default set to 1. |
536+
| `ColumnSpan` | int (optional) | The number of columns to span, starting from the anchor cell. By default set to 1. |
544537

545538
The following sample demonstrates programmatic column spanning by calling `MergeCellsAsync` with parameters such as `RowIndex`, `ColumnIndex`, and `ColumnSpan` for a single merge, and by passing multiple `MergeCellInfo` objects with the same parameters in an array for batch merging.
546539

@@ -772,12 +765,12 @@ The Blazor TreeGrid provides API support to manually remove merged regions when
772765
| `UnmergeCellsAsync` | infos | `IEnumerable<UnmergeCellInfo>` | Removes multiple merged areas in one combined operation, improving performance by reducing re‑renders. |
773766
| `UnmergeAllAsync` ||| Removes all merged regions in the current view, restoring every cell to its original state. |
774767

775-
To identify a merged region, use the following properties of the UnmergeCellInfo class:
768+
To identify a merged region, use the following properties of the `UnmergeCellInfo` class:
776769

777770
| Property | Type | Description |
778771
|--------------|------|-----------------------------------------------------------------------------|
779-
| RowIndex | int | The zero-based index of the anchor row (top-left cell of the merged region). |
780-
| ColumnIndex | int | The zero-based index of the anchor column (top-left cell of the merged region). |
772+
| `RowIndex` | int | The zero-based index of the anchor row (top-left cell of the merged region). |
773+
| `ColumnIndex` | int | The zero-based index of the anchor column (top-left cell of the merged region). |
781774

782775
This sample demonstrates clearing merged regions in the TreeGrid by calling `UnmergeCellsAsync` with parameters such as `RowIndex` and `ColumnIndex` to remove specific spans, passing multiple `UnmergeCellInfo` objects for batch unmerging, and using `UnmergeAllAsync` to reset all merged cells at once.
783776

@@ -1030,7 +1023,7 @@ public class ProjectTask
10301023

10311024
## Limitations
10321025

1033-
The following list outlines the features that are not compatible with row spanning.
1026+
The following list outlines the features that are not compatible with column spanning.
10341027

10351028
* Virtualization
10361029
* Infinite Scrolling
@@ -1042,6 +1035,6 @@ The following list outlines the features that are not compatible with row spanni
10421035

10431036
## See also
10441037

1045-
* [Column spanning in Syncfusion<sup style="font-size:70%">&reg;</sup> TreeGrid](https://blazor.syncfusion.com/documentation/treegrid/columns/column-spanning)
1038+
* [Column spanning in Syncfusion<sup style="font-size:70%">&reg;</sup> TreeGrid](https://blazor.syncfusion.com/documentation/treegrid/rows/row-spanning)
10461039

10471040

blazor/treegrid/filtering/filtering.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -417,7 +417,7 @@ namespace TreeGridComponent.Data {
417417

418418
## Filtering with case sensitivity
419419

420-
The Blazor TreeGrid filtering feature lets you choose whether to match uppercase and lowercase letters exactly or ignore them. By default, filtering is not case-sensitive, meaning matches are found regardless of character case (e.g., "Task" and "task" are treated the same). Case-sensitive filtering is enabled by setting the [`TreeGridFilterSettings.EnableCaseSensitivity`](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.TreeGrid.SfTreeGrid-1.html#Syncfusion_Blazor_TreeGrid_SfTreeGrid_1_EnableCaseSensitivity) property to **true**.
420+
The Blazor TreeGrid filtering functionality allows control over whether uppercase and lowercase letters must match exactly or can be ignored. By default, filtering is not case-sensitive, meaning matches are found regardless of character case (e.g., "Task" and "task" are treated the same). Case-sensitive filtering is enabled by setting the [`TreeGridFilterSettings.EnableCaseSensitivity`](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.TreeGrid.SfTreeGrid-1.html#Syncfusion_Blazor_TreeGrid_SfTreeGrid_1_EnableCaseSensitivity) property to **true**.
421421

422422
The following example demonstrates configuration of the `EnableCaseSensitivity` property within `TreeGridFilterSettings`:
423423

0 commit comments

Comments
 (0)