Skip to content

[Docs] Clarify FluentSelect SelectedOptionsChanged not triggered with manual options (#3670 and #1207) #3680

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vnbaaij merged 1 commit into from
Apr 15, 2025
Merged

[Docs] Clarify FluentSelect SelectedOptionsChanged not triggered with manual options (#3670 and #1207) #3680

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions examples/Demo/Shared/Microsoft.FluentUI.AspNetCore.Components.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6131,6 +6131,13 @@
Gets or sets the maximum number of options that should be visible in the listbox scroll area.
</summary>
</member>
<member name="P:Microsoft.FluentUI.AspNetCore.Components.FluentListbox`1.SelectedOptionsChanged">
<summary>
Called whenever the selection changed.
⚠️ Only available when Multiple = true.
⚠️ When using manual options, the internal data structure cannot be updated reliably, because of this, the SelectedOptionsChanged event will not be triggered.
</summary>
</member>
<member name="P:Microsoft.FluentUI.AspNetCore.Components.FluentListbox`1.BorderStyle">
<summary />
</member>
Expand Down Expand Up @@ -6271,6 +6278,13 @@
Gets or sets the visual appearance. See <seealso cref="T:Microsoft.FluentUI.AspNetCore.Components.Appearance"/>
</summary>
</member>
<member name="P:Microsoft.FluentUI.AspNetCore.Components.FluentSelect`1.SelectedOptionsChanged">
<summary>
Called whenever the selection changed.
⚠️ Only available when Multiple = true.
⚠️ When using manual options, the internal data structure cannot be updated reliably, because of this, the SelectedOptionsChanged event will not be triggered.
</summary>
</member>
<member name="P:Microsoft.FluentUI.AspNetCore.Components.InternalListContext`1.Options">
<summary>
Gets the list of all select items inside of this select component.
Expand Down
8 changes: 8 additions & 0 deletions src/Core/Components/List/FluentListbox.razor.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,14 @@ public partial class FluentListbox<TOption> : ListComponentBase<TOption> where T
[Parameter]
public int Size { get; set; }

/// <summary>
/// Called whenever the selection changed.
/// ⚠️ Only available when Multiple = true.
/// ⚠️ When using manual options, the internal data structure cannot be updated reliably, because of this, the SelectedOptionsChanged event will not be triggered.
/// </summary>
[Parameter]
public override EventCallback<IEnumerable<TOption>?> SelectedOptionsChanged { get; set; }

/// <summary />
protected virtual StyleBuilder BorderStyle => new StyleBuilder()
.AddStyle("width", Width, when: !string.IsNullOrEmpty(Width))
Expand Down
8 changes: 8 additions & 0 deletions src/Core/Components/List/FluentSelect.razor.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,14 @@ public partial class FluentSelect<TOption> : ListComponentBase<TOption> where TO
[Parameter]
public Appearance? Appearance { get; set; }

/// <summary>
/// Called whenever the selection changed.
/// ⚠️ Only available when Multiple = true.
/// ⚠️ When using manual options, the internal data structure cannot be updated reliably, because of this, the SelectedOptionsChanged event will not be triggered.
/// </summary>
[Parameter]
public override EventCallback<IEnumerable<TOption>?> SelectedOptionsChanged { get; set; }

private string? GetAriaLabelWithRequired()
{
#pragma warning disable CS0618 // Type or member is obsolete
Expand Down
Loading