Reorganize Blazor forms coverage 8.0

[guardrex]

I think what we eventually want to do here is build up the user's understanding of form handling in Blazor by building off of concepts they probably already know, like the basics of forms in HTML. So, I think that means the initially sections should start with just a plain <form> (not EditForm) and then build up from there. First show how you can handle the form submission from the server using @onsubmit. Then introduce EditForm as a more convenient way to build a server based form. Then introduce enhanced form handling from the server. Then introduce interactive form handling. But we don't have to do this restructuring right away. It can wait until we get the .NET 8 stuff covered.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/blazor/forms-and-input-components?view=aspnetcore-7.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/blazor/forms-and-input-components.md

Version Independent Document ID

c3128506-d228-35ca-e34a-183a881acdec

Article author

guardrex

[guardrex]

Current article ToC

• Opening remarks
• Examples in this article
• Additional form examples (>=8.0) (currently not in the doc; for future work)
• Introduction
• Binding
  • Model binding
  • Context binding
  • Supported types (>=8.0)
  • Additional binding options (>=8.0)
  • Form names (>=8.0)
  • Supply a parameter from the form ([SupplyParameterFromForm]) (>=8.0)
  • Nest and bind forms (>=8.0)
  • Advanced form mapping error scenarios (>=8.0)
• Handle form submission
• Built-in input components
• Example form
• Multiple option selection with the InputSelect component (>=6.0)
• Binding InputSelect options to C* object null values
• Display name support (>=5.0)
• Error message template support
• Basic validation
• Data Annotations Validator component and custom validation
• Validator components
• Business logic validation with a validator component
• Server validation with a validator component
• InputText based on the input event
• Radio buttons
• Validation Summary and Validation Message components
• Determine if a form field is valid (>=8.0)
• Custom validation attributes
• Custom validation CSS class attributes (>=7.0)
• Blazor data annotations validation package
• [CompareProperty] attribute (<=6.0)
• Nested models, collection types, and complex types
• Enable the submit button based on form validation
• Large form payloads and the SignalR message size limit
• HTML forms (>=8.0)
• Antiforgery support (>=8.0)
• Enhanced form handling (>=8.0)
• Troubleshoot
  • EditForm parameter error
  • Connection disconnected
• Additional resources

Proposed article ToC

Node name: Forms

• Overview article

  • Opening remarks
  • Introduction (rolling in the content from the current Handle form submission section)
  • >=8.0: Plain HTML forms and EditForm forms
  • <8.0: EditForm forms
  • Antiforgery support (>=8.0)
  • Enhanced form handling (>=8.0)
  • Examples (formerly Examples in this article, orienting info about the examples throughout the node)
  • Additional form examples (>=8.0) (not used at this time; for future cross-links to framework test assets/sample code)
  • Additional resources

• Binding article (examples are EditForms)

  • Model binding
  • Context binding
  • Supported types (>=8.0)
  • Additional binding options (>=8.0)
  • Form names (>=8.0)
  • Supply a parameter from the form ([SupplyParameterFromForm]) (>=8.0)
  • Nest and bind forms (>=8.0)
  • Advanced form mapping error scenarios (>=8.0)
  • Radio buttons

• Built-in input components article (examples are EditForms)

  • Example form
  • Multiple option selection with the InputSelect component (>=6.0)
  • Binding InputSelect options to C* object null values
  • Display name support (>=5.0)
  • Error message template support (for built-in input components)

• Validation article (examples are EditForms)

  • Basic validation
  • Data Annotations Validator component and custom validation
  • Validator components
  • Business logic validation with a validator component
  • Server validation with a validator component
  • InputText based on the input event
  • Validation Summary and Validation Message components
  • Determine if a form field is valid (>=8.0)
  • Custom validation attributes
  • Custom validation CSS class attributes (>=7.0)
  • Blazor data annotations validation package
  • [CompareProperty] attribute (<=6.0)
  • Nested models, collection types, and complex types
  • Enable the submit button based on form validation

• Troubleshoot article

  • Large form payloads and the SignalR message size limit
  • EditForm parameter error
  • Connection disconnected