Released: Jan 23, 2026

25.2.2 中的更新

特性

• Bars
  • Added RibbonViewModel.SelectedItem property for the currently selected RibbonTabViewModel.
  • Added an InvocationFocusBehavior property to most bar controls that determines how focus should be handled following the primary invocation of the control.
  • Improved RibbonGallery keyboard navigation to better match Office behavior.
  • Improved UI Automation for BarComboBox.
  • Updated RibbonWindow to apply Window.Padding to the window content area. This, combined with new WindowTitleBar.CanConfigureWindowOffScreenMargin property, improves the window layout when maximized.
  • Updated RibbonViewModel to synchronize the SelectedItem property with the Tabs collection by always selecting the first tab when no selection is currently defined or the previous selection is removed.
• Docking
  • Updated DockSiteLayoutSerializer to support AOT trimming by providing a solution that does not use XmlSerializer.
• Fundamentals
  • Added SettingsExpander properties ExpanderIcon, ExpanderIconTemplate, IsExpanderIconVisible, and CanRotateExpanderIcon that can be used to customize the appearance of the expansion indicator.
  • Added SettingsExpander.CanToggleExpansion property that, when set to False, prevents the user from changing the expansion state without having to disable the entire control.
  • Added UserPromptBuilder.AfterInitializeOverlay callback that can be used to configure the WindowControl that is used to display the prompt as an overlay.
  • Updated user prompts that are displayed as overlays to remain centered while the host is resized as long as the user has not manually moved or resized the prompt.
  • Updated WindowControl default style to stop changing the border brush when active, which also affects any user prompt shown as an overlay.
  • Updated WindowControl to hide the inner border when resize is not supported or when minimized.
• Themes
  • Improved ImageProvider with an extension point for adapting unknown image formats.
  • Added a new .axaml Styles file that can be referenced by apps to stop Rider IDE from warning about unknown style classes that are defined in Actipro's dynamic themes.
  • Updated native control themes with changes in Avalonia through v11.3.11.
  • Updated the CheckBoxMenuIndicator and RadioButtonMenuIndicator control themes to no longer automatically apply, as they are deprecated in favor or built-in menu check state support in Avalonia.
• Shared Library
  • Added a SVG vector image adaptation example to the Dynamic Image sample.
  • Added WindowTitleBar.CanConfigureWindowOffScreenMargin property to automatically bind the containing window's Padding to the OffScreenMargin. This is on by default to improve layout for maximized windows.
  • Updated KeyboardNavigationHelper logic to only support navigation to input elements with tab stops.
  • Updated XmlSerializerBase to support AOT trimming by providing a solution that does not use XmlSerializer.
• All
  • Updated the minimum Avalonia UI dependency from v11.3.0 to v11.3.7.

修补程序

• Bars
  • Fixed an issue introduced in the previous build where XAML-defined ribbon gallery popups didn't render the implicit menu gallery correctly.
  • Fixed an issue where in-ribbon galleries that were updated when their parent tab was not selected may not invalidate measurement.
  • Fixed InvalidOperationException that might be thrown when using a background thread to change properties of the selected item in a BarComboBox.
  • Fixed a rare issue with a Ribbon using simplified layout where some non-Bars controls might not render in the ribbon if the RibbonGroup was collapsing.
  • Fixed an issue where clicking in the empty space of a Ribbon might unexpectedly move focus into the Ribbon.
• Docking
  • Fixed an issue with MVVM usage where docking window views could be recreated in certain scenarios.
  • Fixed an issue where a non-hosted floating preview window might not close properly after dragging a docking window to float.
  • Fixed an issue where AdvancedTabItem Header and HeaderTemplate properties were not able to be customized properly.
  • Fixed an issue where tool windows may not hide their title bar when requested to do so.
  • Fixed an issue where dragging a window on macOS with Avalonia v11.3.9 might cause the window to jump around while dragging.
• Fundamentals
  • Fixed an issue where UserPromptBuilder would not properly size a user prompt if the startup location was configured as CenterOwner and the owner could not be resolved.
  • Fixed an issue where MultiColumnPanel, at some high DPI settings, might not correctly arrange an item at the bottom of the tallest column and, instead, push it to the next column causing items in the last column to be arranged below the available panel height.
  • Fixed a rare exception that might be thrown from InfoBarPanel due to a negative calculated width of the center column.
• All
  • In WASM, disabled animations on several controls in scenarios where Avalonia doesn't sequence animations properly.