Skip to content

Commit 610f568

Browse files
Merge pull request #6928 from syncfusion-content/BLAZ-983104-data-form
Updated the UG Documentation for data-form
2 parents 1f74568 + deb76b5 commit 610f568

14 files changed

+204
-201
lines changed

blazor/data-form/autogeneration.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ documentation: ug
99

1010
# Configuring auto generation
1111

12-
Blazor DataForm component generates the editors automatically based on the primitive property types if we use [FormAutoGenerateItems](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.DataForm.FormAutoGenerateItems.html) inside it.The types with its corresponding default editor components listed below for reference.
12+
Blazor DataForm can create editor fields automatically based on the primitive property types when the [FormAutoGenerateItems](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.DataForm.FormAutoGenerateItems.html) tag is used inside the DataForm. The following table lists each supported type with its corresponding default editor component.
1313

1414
| Type | Component |
1515
| ------------ | ----------------------- |
@@ -21,7 +21,7 @@ Blazor DataForm component generates the editors automatically based on the primi
2121
| `bool` | [SfCheckBox](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Buttons.SfCheckBox-1.html) |
2222
| `enum` | [SfDropDownList](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.DropDowns.SfDropDownList-2.html) |
2323

24-
The below example demonstrates the auto generated items with possible types
24+
The following example demonstrates auto-generated items for the supported types.
2525

2626
{% tabs %}
2727
{% highlight razor tabtitle="FormAutoGenerateItems" %}
@@ -35,7 +35,7 @@ The below example demonstrates the auto generated items with possible types
3535

3636
## Combined auto generated and custom fields
3737

38-
The `FormAutoGenerateItems` can be utilized independently, as demonstrated in the previous example, or it can be placed in-between, above, or below multiple `FormItem` tags. This will create editors for all types except those explicitly defined using `FormItem`.
38+
The `FormAutoGenerateItems` can be utilized independently, as demonstrated in the previous example, or it can be placed in-between, above, or below multiple `FormItem` tags. This creates editors for all supported types except those explicitly defined using `FormItem`, preventing duplicate editors.
3939

4040
{% tabs %}
4141
{% highlight razor tabtitle="FormAutoGenerateItems" %}
@@ -45,13 +45,15 @@ The `FormAutoGenerateItems` can be utilized independently, as demonstrated in th
4545
{% endhighlight %}
4646
{% endtabs %}
4747

48-
In the given example, apart from `StringField`, `DateTimeField`, and `BoolField`, the remaining elements will be generated and placed automatically within the specified `FormItem` along with their corresponding editor types.
48+
In the given example, `StringField`, `DateTimeField`, and `BoolField` are explicitly defined with `FormItem`. All remaining eligible properties are auto-generated with their corresponding editor types and positioned relative to the `FormAutoGenerateItems` tag.
4949

50-
![Blazor DataForm Form Item](images/blazor_dataform_partially_autogenerated_items.png)
50+
![Blazor DataForm showing a mix of custom-defined FormItem fields and auto-generated fields](images/blazor_dataform_partially_autogenerated_items.png)
5151

5252
## Cancel the auto generate fields
5353

54-
We can prevent the auto generation of fields by explicitly defining the `FormItem` for required fields in model , which will render the editors based on the specified editors.
54+
Auto-generation can be controlled in two ways:
55+
- To disable auto-generation entirely, omit the `FormAutoGenerateItems` tag. Only the explicitly declared `FormItem` elements will render.
56+
- To exclude specific fields while keeping auto-generation for the rest, declare those fields explicitly using `FormItem`. When both `FormItem` and `FormAutoGenerateItems` are present, the explicitly defined fields are not auto-generated.
5557

5658
{% tabs %}
5759
{% highlight razor tabtitle="AutoGenerate" %}

blazor/data-form/column-layout.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ documentation: ug
99

1010
# Column layout in DataForm component
1111

12-
This segment provides guidance on dividing the form field editors inside the DataForm component into a column-based layout. The [ColumnCount](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.DataForm.SfDataForm.html#Syncfusion_Blazor_DataForm_SfDataForm_ColumnCount) property allows us to specify the number of columns into which the DataForm should be divided.
12+
This section explains how to arrange DataForm editors in a column-based layout. The [ColumnCount](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.DataForm.SfDataForm.html#Syncfusion_Blazor_DataForm_SfDataForm_ColumnCount) property allows us to specify the number of columns into which the DataForm should be divided.
1313

1414
{% tabs %}
1515
{% highlight razor tabtitle="razor" %}
@@ -19,7 +19,7 @@ This segment provides guidance on dividing the form field editors inside the Dat
1919
{% endhighlight %}
2020
{% endtabs %}
2121

22-
![Blazor DataForm Column Layout](images/blazor_dataform_change_form_width.png)
22+
![Blazor DataForm column layout](images/blazor_dataform_change_form_width.png)
2323

2424
## Configure the column span
2525

@@ -33,9 +33,9 @@ Additionally, by utilizing the [ColumnSpan](https://help.syncfusion.com/cr/blazo
3333
{% endhighlight %}
3434
{% endtabs %}
3535

36-
In the provided example, the layout of the DataForm is segmented into six equal columns, with the editor fields distributed accordingly, depending on the column span allocated to each one.
36+
In the following example, the DataForm is divided into six equal columns. Each editor consumes space based on its configured column span, resulting in rows where items align cleanly and wrap to the next row when the remaining columns are insufficient.
3737

38-
![Blazor DataForm Column Layout](images/blazor_dataform_column_span.png)
38+
![Blazor DataForm demonstrating ColumnSpan across a six-column grid](images/blazor_dataform_column_span.png)
3939

4040

4141
## See Also

0 commit comments

Comments
 (0)