Merge branch 'rel-2.0'

# Conflicts:
#	Documentation/Blazorise.Docs/Resources/docs-api-index.json
#	Documentation/Blazorise.Docs/Resources/docs-index.json

Author: stsrki

Documentation/Blazorise.Docs/Pages/Docs/Extensions/Autocomplete/AutocompletePage.razor

@@ -96,7 +96,17 @@
 
 <DocsPageSection>
     <DocsPageSectionHeader Title="Validation (data annotations)">
-        Use <Code>ValidationMode.Auto</Code> with a model decorated with data annotations to validate single and multiple selections.
+        <Paragraph>
+            Use <Code>ValidationMode.Auto</Code> with a model decorated with data annotations to validate single and multiple selections.
+        </Paragraph>
+
+        <Paragraph>
+            <Alert Color="Color.Info" Visible>
+                <AlertDescription>
+                    <Strong>Note:</Strong> When both <Code>Value</Code> and <Code>Text</Code> are bound then validation will work on the <Code>Value</Code> binding.
+                </AlertDescription>
+            </Alert>
+        </Paragraph>
     </DocsPageSectionHeader>
     <DocsPageSectionContent Outlined FullWidth>
         <AutocompleteDataAnnotationValidationExample />
@@ -189,4 +199,4 @@
 </DocsPageSection>
 
 
-<ComponentApiDocs ComponentTypes="[typeof(Autocomplete<,>)]" />
+<ComponentApiDocs ComponentTypes="[typeof(Autocomplete<,>)]" />

Documentation/Blazorise.Docs/Pages/Docs/Specifications/AutocompletePage.razor

@@ -209,4 +209,27 @@
             <TableRowCell></TableRowCell>
         </TableRow>
     </TableBody>
-</Table>
+</Table>
+
+<DocsPageSubtitle>
+    Validation
+</DocsPageSubtitle>
+
+<DocsPageParagraph>
+    The <Code>Autocomplete</Code> component supports <Code>Validation</Code> like any other regular input field. But because you can
+    bind both the <Code>Value(s)</Code> and <Code>Text(s)</Code> properties the validation logic will work with a prioritized system
+    for which binding expression field will be validated.
+
+    <OrderedList>
+        <OrderedListItem><Code>@@bind-Value</Code> expression</OrderedListItem>
+        <OrderedListItem><Code>@@bind-SelectedValue</Code> expression</OrderedListItem>
+        <OrderedListItem><Code>@@bind-SelectedText</Code> expression</OrderedListItem>
+    </OrderedList>
+
+</DocsPageParagraph>
+
+<DocsPageParagraph>
+    <Strong>Note:</Strong> If you want to validate both the <Code>Value</Code> and the <Code>Text</Code> bindings then you will need
+    to validate the text as part of the <Code>Value</Code> validation rule. Then the validation feedback will be correctly displayed
+    on the <Code>Autocomplete</Code> component.
+</DocsPageParagraph>

Documentation/Blazorise.Docs/Resources/docs-api-index.json

@@ -1,5 +1,5 @@
 {
-  "generatedUtc": "2026-03-22T12:27:01.1998578Z",
+  "generatedUtc": "2026-03-24T09:42:27.6885828Z",
   "components": [
     {
       "type": "global::Blazorise.Abbreviation",
@@ -5036,6 +5036,14 @@
           "summary": "Gets or sets the currently selected item text.",
           "isBlazoriseEnum": false
         },
+        {
+          "name": "SelectedTextExpression",
+          "type": "Expression<>",
+          "typeName": "Expression<Func<string>>",
+          "defaultValue": "null",
+          "summary": "Gets or sets an expression that identifies the selected text.",
+          "isBlazoriseEnum": false
+        },
         {
           "name": "SelectedTexts",
           "type": "List<>",
@@ -5044,6 +5052,14 @@
           "summary": "Currently selected items texts.     Used when multiple selection is set.",
           "isBlazoriseEnum": false
         },
+        {
+          "name": "SelectedTextsExpression",
+          "type": "Expression<>",
+          "typeName": "Expression<Func<List<string>>>",
+          "defaultValue": "null",
+          "summary": "Gets or sets an expression that identifies the selected texts.     Used when multiple selection is set.",
+          "isBlazoriseEnum": false
+        },
         {
           "name": "SelectedValue",
           "type": "object",
@@ -40005,6 +40021,14 @@
           "summary": "Custom inline styles to apply to the component.",
           "isBlazoriseEnum": false
         },
+        {
+          "name": "TabIndex",
+          "type": "int?",
+          "typeName": "int?",
+          "defaultValue": "null",
+          "summary": "Gets or sets the tabindex value for keyboard navigation.",
+          "isBlazoriseEnum": false
+        },
         {
           "name": "TextAlignment",
           "type": "global::Blazorise.TextAlignment",

Documentation/Blazorise.Docs/Resources/docs-index.json

@@ -1,5 +1,5 @@
 {
-  "generatedUtc": "2026-03-22T12:27:01.5526320Z",
+  "generatedUtc": "2026-03-24T09:42:47.9552921Z",
   "pages": [
     {
       "route": "/docs",
@@ -4017,7 +4017,7 @@
           "sourcePath": "Pages/Docs/Extensions/Autocomplete/Examples/AutocompleteDataAnnotationValidationExample.razor",
           "content": "@using System.ComponentModel.DataAnnotations\r\n\r\n<Validations Mode=\"ValidationMode.Auto\" Model=\"@model\">\r\n    <Validation>\r\n        <Field>\r\n            <FieldLabel>Country</FieldLabel>\r\n            <FieldBody>\r\n                <Autocomplete TItem=\"Country\"\r\n                              TValue=\"string\"\r\n                              Data=\"@Countries\"\r\n                              TextField=\"@(( item ) => item.Name)\"\r\n                              ValueField=\"@(( item ) => item.Iso)\"\r\n                              Placeholder=\"Select a country\"\r\n                              @bind-SelectedValue=\"@model.CountryIso\">\r\n                    <Feedback>\r\n                        <ValidationError />\r\n                    </Feedback>\r\n                </Autocomplete>\r\n            </FieldBody>\r\n        </Field>\r\n    </Validation>\r\n    <Validation>\r\n        <Field>\r\n            <FieldLabel>Countries</FieldLabel>\r\n            <FieldBody>\r\n                <Autocomplete TItem=\"Country\"\r\n                              TValue=\"string\"\r\n                              Data=\"@Countries\"\r\n                              TextField=\"@(( item ) => item.Name)\"\r\n                              ValueField=\"@(( item ) => item.Iso)\"\r\n                              SelectionMode=\"AutocompleteSelectionMode.Multiple\"\r\n                              Placeholder=\"Select countries\"\r\n                              @bind-SelectedValues=\"@model.CountryIsos\">\r\n                    <Feedback>\r\n                        <ValidationError />\r\n                    </Feedback>\r\n                </Autocomplete>\r\n            </FieldBody>\r\n        </Field>\r\n    </Validation>\r\n</Validations>\r\n\r\n@code {\r\n    [Inject]\r\n    public CountryData CountryData { get; set; }\r\n\r\n    public IEnumerable<Country> Countries;\r\n\r\n    AutocompleteValidationModel model = new AutocompleteValidationModel();\r\n\r\n    protected override async Task OnInitializedAsync()\r\n    {\r\n        Countries = await CountryData.GetDataAsync();\r\n        await base.OnInitializedAsync();\r\n    }\r\n\r\n    public class AutocompleteValidationModel\r\n    {\r\n        [Required( ErrorMessage = \"Please select a country.\" )]\r\n        public string CountryIso { get; set; }\r\n\r\n        [MinLength( 1, ErrorMessage = \"Please select at least one country.\" )]\r\n        public List<string> CountryIsos { get; set; } = new List<string>();\r\n    }\r\n}",
           "title": "Validation (data annotations)",
-          "description": "Use ValidationMode.Auto with a model decorated with data annotations to validate single and multiple selections."
+          "description": "Use ValidationMode.Auto with a model decorated with data annotations to validate single and multiple selections. Note: When both Value and Text are bound then validation will work on the Value binding."
         },
         {
           "code": "AutocompleteReadDataExample",

Source/Blazorise/Components/Dropdown/DropdownItem.razor.cs

@@ -133,13 +133,18 @@ protected async Task CheckedChangedHandler( bool isChecked )
     /// <summary>
     /// Gets the tabindex value for keyboard navigation.
     /// </summary>
-    protected int ComputedTabIndex => Disabled ? -1 : 0;
+    protected int ComputedTabIndex => Disabled ? -1 : TabIndex ?? 0;
 
     /// <summary>
     /// Holds the item value.
     /// </summary>
     [Parameter] public object Value { get; set; }
 
+    /// <summary>
+    /// Gets or sets the tabindex value for keyboard navigation.
+    /// </summary>
+    [Parameter] public int? TabIndex { get; set; }
+
     /// <summary>
     /// Indicate the currently active item.
     /// </summary>

Source/Extensions/Blazorise.Components/Autocomplete.razor

@@ -79,15 +79,15 @@
         {
             var notFoundContext = GetNotFoundItemContext();
 
-            <DropdownItem Disabled CloseParentDropdowns="@CloseParentDropdowns" Class="@DropdownItemClassNames( notFoundContext )" Style="@DropdownItemStyleNames( notFoundContext )">
+            <DropdownItem Disabled TabIndex="-1" CloseParentDropdowns="@CloseParentDropdowns" Class="@DropdownItemClassNames( notFoundContext )" Style="@DropdownItemStyleNames( notFoundContext )">
                 @NotFoundTemplate( Search )
             </DropdownItem>
         }
         else if ( FreeTypingNotFoundVisible )
         {
             var notFoundContext = GetNotFoundItemContext();
 
-            <DropdownItem Disabled CloseParentDropdowns="@CloseParentDropdowns" Class="@DropdownItemClassNames( notFoundContext )" Style="@DropdownItemStyleNames( notFoundContext )">
+            <DropdownItem Disabled TabIndex="-1" CloseParentDropdowns="@CloseParentDropdowns" Class="@DropdownItemClassNames( notFoundContext )" Style="@DropdownItemStyleNames( notFoundContext )">
                 @FreeTypingNotFoundTemplate( Search )
             </DropdownItem>
         }
@@ -108,7 +108,7 @@
         var value = GetItemValue( item );
         var itemContext = CreateItemContext( item, value, text, itemIndex, isActiveItem, isFocusedItem, disabled );
 
-        <DropdownItem @key="@item" ElementId="@DropdownItemId( itemIndex )" Active="@isActiveItem" Checked=@isActiveItem ShowCheckbox=@isCheckbox Class="@DropdownItemClassNames( itemContext )" Style="@DropdownItemStyleNames( itemContext )" Value="@value"
+        <DropdownItem @key="@item" ElementId="@DropdownItemId( itemIndex )" Active="@isActiveItem" Checked=@isActiveItem ShowCheckbox=@isCheckbox TabIndex="-1" Class="@DropdownItemClassNames( itemContext )" Style="@DropdownItemStyleNames( itemContext )" Value="@value"
                       Disabled="@disabled"
                       CloseParentDropdowns="@CloseParentDropdowns"
                       @onmousedown="@(() => clickFromCheck = true)"

Source/Extensions/Blazorise.Components/Autocomplete.razor.cs

@@ -101,6 +101,11 @@ public partial class Autocomplete<TItem, TValue>
     /// </summary>
     protected ComponentParameterInfo<string> paramSelectedText;
 
+    /// <summary>
+    /// Captured SelectedTextExpression parameter snapshot.
+    /// </summary>
+    protected ComponentParameterInfo<Expression<Func<string>>> paramSelectedTextExpression;
+
     /// <summary>
     /// Captured SelectedValues parameter snapshot.
     /// </summary>
@@ -111,6 +116,11 @@ public partial class Autocomplete<TItem, TValue>
     /// </summary>
     protected ComponentParameterInfo<IEnumerable<string>> paramSelectedTexts;
 
+    /// <summary>
+    /// Captured SelectedTextExpression parameter snapshot.
+    /// </summary>
+    protected ComponentParameterInfo<Expression<Func<List<string>>>> paramSelectedTextsExpression;
+
     /// <summary>
     /// Captured Data parameter snapshot.
     /// </summary>
@@ -153,6 +163,8 @@ protected override void CaptureParameters( ParameterView parameters )
         parameters.TryGetParameter( Data, value => data.IsEqual( value ), out paramData );
         parameters.TryGetParameter( SelectedValueExpression, out paramSelectedValueExpression );
         parameters.TryGetParameter( SelectedValuesExpression, out paramSelectedValuesExpression );
+        parameters.TryGetParameter( SelectedTextExpression, out paramSelectedTextExpression );
+        parameters.TryGetParameter( SelectedTextsExpression, out paramSelectedTextsExpression );
     }
 
     /// <inheritdoc/>
@@ -230,6 +242,10 @@ protected override async Task OnAfterSetParametersAsync( ParameterView parameter
                 {
                     await ParentValidation.InitializeInputExpression( paramSelectedValuesExpression.Value );
                 }
+                else if ( paramSelectedTextsExpression.Defined )
+                {
+                    await ParentValidation.InitializeInputExpression( paramSelectedTextsExpression.Value );
+                }
             }
             else
             {
@@ -241,6 +257,10 @@ protected override async Task OnAfterSetParametersAsync( ParameterView parameter
                 {
                     await ParentValidation.InitializeInputExpression( paramSelectedValueExpression.Value );
                 }
+                else if ( paramSelectedTextExpression.Defined )
+                {
+                    await ParentValidation.InitializeInputExpression( paramSelectedTextExpression.Value );
+                }
             }
 
             await InitializeValidation();
@@ -510,8 +530,35 @@ public async Task ScrollItemIntoView( int index )
     /// <returns>Returns awaitable task</returns>
     protected async Task OnTextKeyDownHandler( KeyboardEventArgs eventArgs )
     {
+        bool isPlainTabNavigation = eventArgs.Code == "Tab" && !eventArgs.AltKey && !eventArgs.CtrlKey && !eventArgs.MetaKey;
+
         await OnKeyDownHandler( eventArgs );
 
+        if ( isPlainTabNavigation )
+        {
+            if ( IsConfirmKey( eventArgs ) )
+            {
+                if ( IsMultiple && FreeTyping && !string.IsNullOrEmpty( Search ) && ActiveItemIndex < 0 )
+                {
+                    await AddMultipleText( Search );
+
+                    if ( CloseOnSelection )
+                    {
+                        await ResetCurrentSearch();
+                    }
+                }
+                else if ( SelectionMode != AutocompleteSelectionMode.Checkbox )
+                {
+                    await SelectedOrResetOnCommit();
+                }
+            }
+
+            TextFocused = false;
+            await Close();
+            await SearchKeyDown.InvokeAsync( eventArgs );
+            return;
+        }
+
         if ( eventArgs.Code == "Escape" )
         {
             await Close();
@@ -1784,6 +1831,11 @@ public Expression<Func<TValue>> SelectedValueExpression
     [Parameter]
     public string SelectedText { get; set; }
 
+    /// <summary>
+    /// Gets or sets an expression that identifies the selected text.
+    /// </summary>
+    [Parameter] public Expression<Func<string>> SelectedTextExpression { get; set; }
+
     /// <summary>
     /// Gets or sets the currently selected item text.
     /// </summary>
@@ -1918,6 +1970,12 @@ public List<string> SelectedTexts
         set => selectedTextsParam = ( value == null ? null : new( value ) );
     }
 
+    /// <summary>
+    /// Gets or sets an expression that identifies the selected texts.
+    /// Used when multiple selection is set.
+    /// </summary>
+    [Parameter] public Expression<Func<List<string>>> SelectedTextsExpression { get; set; }
+
     /// <summary>
     /// Occurs after the selected texts have changed.
     /// Used when multiple selection is set.

Tests/BasicTestApp.Client/Autocomplete_5452Component.razor

@@ -0,0 +1,17 @@
+<Autocomplete TItem="string"
+              TValue="string"
+              Data="@items"
+              MinSearchLength="0"
+              TextField="@(( item ) => item)"
+              ValueField="@(( item ) => item)" />
+
+<Button ElementId="nextButton" Outline>Next</Button>
+
+@code {
+    private readonly List<string> items = new()
+    {
+        "Alpha",
+        "Beta",
+        "Gamma"
+    };
+}

Tests/Blazorise.E2E.Tests/Tests/Extensions/Autocomplete/Autocomplete_5452_Tests.cs

@@ -0,0 +1,27 @@
+namespace Blazorise.E2E.Tests.Tests.Extensions.Autocomplete;
+
+[Parallelizable( ParallelScope.Self )]
+[TestFixture]
+public class Autocomplete_5452_Tests : BlazorisePageTest
+{
+    [SetUp]
+    public async Task Init()
+    {
+        await SelectTestComponent<Autocomplete_5452Component>();
+    }
+
+    [Test]
+    public async Task TabbingOutWithOpenListFocusesNextElement()
+    {
+        var autocomplete = Page.Locator( ".b-is-autocomplete input[type=search]" );
+        var dropdownMenu = Page.Locator( ".dropdown-menu.show" );
+        var nextButton = Page.Locator( "#nextButton" );
+
+        await autocomplete.ClickAsync();
+        await dropdownMenu.WaitForAsync();
+
+        await autocomplete.PressAsync( "Tab" );
+
+        await Expect( nextButton ).ToBeFocusedAsync();
+    }
+}