# FocusOnInvalidSubmit **Also known as:** FocusFirstInvalid, ScrollToFirstError ## Description BitFocusOnInvalidSubmit moves the focus to the first invalid field of an EditForm when a submit of the form fails, so a keyboard or screen reader user lands on what has to be fixed instead of staying on the submit button. Put it anywhere inside the form; it renders nothing visible. ## Notes The field it focuses is the first element of the form, in document order, that reports aria-invalid="true" - every bit BlazorUI input does when its field fails, and so do the inputs of the framework. A group that carries the state for its items hands the focus to the item the Tab key lands on: a ChoiceGroup to its checked radio, or its first one. Only a validation of the whole form - the one a submit runs, or one the app asks the EditContext for - moves the focus, and only once it is over: a validator that finishes asynchronously is waited for. A field validated as it is edited never moves it, and neither does a validation still running when the user starts editing a field again. Paired with ShowValidationMessage on the inputs, the focused field reads out what is wrong with it. The focus is moved by the browser, so it takes an interactive render mode. ## Parameters | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | EditContext | `EditContext?` | null | The EditContext of the form the component sits in, cascaded by the EditForm. The component requires one: it throws an InvalidOperationException when rendered outside a form. | | AriaLabel | `string?` | null | Gets or sets the accessible label for the component, used by assistive technologies. | | Class | `string?` | null | Gets or sets the CSS class name(s) to apply to the rendered element. | | Dir | `BitDir?` | null | Gets or sets the text directionality for the component's content. | | Disabled | `bool` | false | Gets or sets a value indicating whether the component is disabled and cannot respond to user interaction. | | ForceAnimation | `bool` | false | Gets or sets a value indicating whether the component's animations play at their full duration even when reduced motion is requested. | | HtmlAttributes | `Dictionary<string, object>` | new Dictionary<string, object>() | Captures additional HTML attributes to be applied to the rendered element, in addition to the component's parameters. An attribute written on the component wins over an entry of the same name. | | Id | `string?` | null | Gets or sets the unique identifier for the component's root element. | | Style | `string?` | null | Gets or sets the CSS style string to apply to the rendered element. | | TabIndex | `string?` | null | Gets or sets the tab order index for the component when navigating with the keyboard. | | Visibility | `BitVisibility` | BitVisibility.Visible | Gets or sets the visibility state (visible, hidden, or collapsed) of the component. | ## Public Members | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | UniqueId | `Guid` | Guid.NewGuid() | Gets the readonly unique identifier for the component's root element, assigned when the component instance is constructed. | | RootElement | `ElementReference` | | Gets the reference to the root HTML element associated with this component. | ## Enums ### BitVisibility Enum | Name | Value | Description | | :--- | :--- | :---------- | | Visible | 0 | The content of the component is visible. | | Hidden | 1 | The content of the component is hidden, but the space it takes on the page remains (visibility:hidden). | | Collapsed | 2 | The component is hidden (display:none). | ### BitDir Enum | Name | Value | Description | | :--- | :--- | :---------- | | Ltr | 0 | Ltr (left to right) is to be used for languages that are written from the left to the right (like English). | | Rtl | 1 | Rtl (right to left) is to be used for languages that are written from the right to the left (like Arabic). | | Auto | 2 | Auto lets the user agent decide. It uses a basic algorithm as it parses the characters inside the element until it finds a character with a strong directionality, then applies that directionality to the whole element. | ## Examples \n**Basic**: ```razor Submit ``` ```csharp public class BitFocusOnInvalidSubmitDemoModel { [Required(ErrorMessage = "Enter your name.")] public string? Name { get; set; } = "Ada"; [Required(ErrorMessage = "Enter your email.")] [EmailAddress(ErrorMessage = "Enter an email address.")] public string? Email { get; set; } [Required(ErrorMessage = "Pick a plan.")] public string? Plan { get; set; } } private BitFocusOnInvalidSubmitDemoModel model = new(); private readonly List> planItems = [ new() { Text = "Free", Value = "free" }, new() { Text = "Team", Value = "team" }, new() { Text = "Enterprise", Value = "enterprise" }, ]; private void HandleValidSubmit() { } ```