Comparison of Avalonia with WPF and UWP
Originally based on UWPvsWPF.md with Avalonia-specific changes. Licensed CC BY-SA 4.0
This section lists the main differences (primarily from a XAML viewpoint) between Avalonia, UWP and WPF.
Legend:
- ✔ Indicates the platform (defined by the Avalonia, WPF or UWP column) has the feature
- ✖ Indicates the feature is generally missing in the platform
- ⚡ Indicates the feature is only partially implemented compared to other platforms
Markup Extensions
| Item | Avalonia | WPF | UWP | Notes |
|---|---|---|---|---|
| x:Uid for localization | ✖ | ✖ | ✔ | x:uid is a powerful localization system similar to what exists in Windows Forms. WPF is sorely missing this type of localization support. This is a clear advantage of UWP. |
| x:Bind | ✖ | ✖ | ✔ | x:Bind has also become a powerful feature of UWP over WPF. Compiled bindings can be used for nearly anything and can replace other missing features like MultiBinding. Other advantages include debugging support as well as increased performance. |
| x:Array | ✖ | ✔ | ✖ | x:Array isn't supported in UWP. |
| x:Static | ✔ | ✔ | ⚡ | x:Static could be replaced with x:Bind |
| x:Type | ✔ | ✔ | ✖ | |
| Full Markup Extension | ✔ | ✔ | ✖ | UWP only implements a subset of the full markup extension support in WPF. This area needs to be expanded upon in the future. |
| Compiled Bindings | ✔ | ✖ | ✖ |
Binding
| Item | Avalonia | WPF | UWP | Notes |
|---|---|---|---|---|
| OneWayToSource BindingMode | ✔ | ✔ | ✖ | |
| Binding to ConverterParameter | ✔ | ✔ | ✖ | |
| MultiBinding / IMultiValueConverter | ✔ | ✔ | ✖ | Very useful feature in WPF for advanced binding scenarios no longer exists for UWP. UWP does have function binding with x:Bind though (Used to re-implement converter logic). |
| ICommand | ✔ | ✔ | ⚡ | While the interface technically exists, ICommand is nothing like what it was in WPF. The programmer is now responsible for doing every little part of the command. This was improved in Windows 10 version 1809 which added XamlUICommand and StandardUICommand. |
| RelativeSource / AncestorType | ✔ | ✔ | ⚡ | Not nearly as powerful in UWP, relative source only supports {RelativeSource Self} and {RelativeSource TemplatedParent} as compared to more powerful expressions in WPF like {RelativeSource PreviousData} or {Binding RelativeSource={RelativeSource Mode=PreviousData, AncestorType={x:Type TextBox}}. |
| StringFormat | ✔ | ✔ | ✖ | XAML such as {Binding DateValue, StringFormat=Date: {0:dddd yyyy-MM-dd}} isn't supported in UWP and requires custom converters. |
| Functions in binding | ✖ | ✖ | ✔ | x:Bind in UWP supports OneWay and TwoWay function binding that can replace converters. |
Styling
| Item | Avalonia | WPF | UWP | Notes |
|---|---|---|---|---|
| DataTriggers / PropertyTrigger / EventTrigger within Style.Triggers | ✖ | ✔ | ✖ | |
| VisualStateManager | ✖ | ⚡ | ✔ | A different concept from WPF that takes the place of DataTriggers, this is very verbose and more often than not increases complexity compared to data triggers. @Felix-Dev VisualStateManager does exist in WPF (it was added in .NET Framework 4.0). It's not as elegant as in UWP though, i.e. it has no VisuaStateManager.Setters property. That means you have to use Storyboards to set your values. |
| Implicit DataTemplate | ✔ | ✔ | ✖ | Set the DataType property of the DataTemplate to the corresponding type and the template is then applied automatically to all instances of that particular type |
| Binding in Style setter | ✔ | ✔ | ✖ | Any other than TemplateBinding isn't support in a template/style within UWP |
| BasedOn default Style | ✖ | ✔ | ⚡ | BasedOn={StaticResource {x:Type TextBlock} isn't supported in UWP but works in WPF. Instead, BasedOn requires the use of a key which is a problem as not all default styles define one. This is a specific example of the missing x:Type markup extension in UWP. |
Other
| Item | Avalonia | WPF | UWP | Notes |
|---|---|---|---|---|
| Coercion | ✔ | ✔ | ✖ | Coercion of Dependency Properties is not supported in UWP. |
| Data (Input) Validation | ✔ | ✔ | ✖ | The entire WPF data validation system including the classes/inferfaces: ValidationRule (and all standard implementations), Binding.ValidationRules, IDataErrorInfo, INotifyDataErrorInfo, Binding.ValidatesOnNotifyDataErrors, etc. is not implemented in UWP. This will be added in WinUI 3.0 but the story for using this within the UWP app model with WinUI 3.0 is less clear. |
| x:TypeArguments directive | ✔ | ✔ | ✖ | The TypeArguments directive isn't implemented in UWP which causes problems with generics. Missing this requires some work-arounds with classes and creating a non-generic class to use in XAML from a generic one. |
| UIElement.IsVisible / IsVisibleChanged | ✔ | ✔ | ✖ | UWP has no way of tracking which controls are actually visible on the display. WPF has the UIElement.IsVisible property and the IsVisibleChanged event. This hinders the ability to optimize controls for performance. |
| UIElement.Visibility / Visibility.Hidden | ⚡ | ✔ | ⚡ | UWP does not include the Visibility.Hidden enum value used for UIElement.Visibility. Hidden in WPF allowed a control to still be used in measure/layout but appear invisible when rendered for display. |
| UIElement.Clip | ✔ | ✔ | ⚡ | Both WPF and UWP have UIElement.Clip properties. However, WPF can take any Geometry allowing for non-rectangular clipping. UWP can only use a RectangleGeometry for clipping. WPF: public Geometry UIElement.Clip, UWP: public RectangleGeometry UIElement.Clip |
| UIElement.ClipToBounds | ✔ | ✔ | ✖ | In WPF it's possible to clip child contents to the parents bounds by setting ClipToBounds to True. UWP doesn't have this property at all. The work-around is to use UIElement.Clip which can only do rectangular clipping. |
| LayoutTransform | ✔ | ✔ | ✖ | Layout transform is needed to transform elements before layouting. This allows for easily changing textbox direction and then putting it in a table. RenderTransform, as it applies after layout, does not resize parent controls for transformed children. |
| VisualBrush / DrawingBrush | ✔ | ✔ | ✖ | VisualBrush is not a XAML brush in UWP. Instead, must fall back to composition brushes which are not 1:1 equivalent. DrawingBrush is not supported at all in UWP. |
| Supplemental Shapes: Arrow, Callout, Star, etc | ✔ | ✔ | ✖ | Several shapes present in WPF are missing in UWP. |
| Adorner | ✔ | ✔ | ✖ | Adorners overview |
| Thickness | ✔ | ✔ | ⚡ | The Thickness struct exposes fields for Top, Bottom, Left and Right instead of dependency properties as in WPF. This means you cannot Bind or asign resources to an individual thickness parameter. |
| Size / Rect / Point | ✔ | ✔ | ✔ | Size, Rect and Point are fully supported in both WPF and UWP. However, UWP uses single-precision float types for properties instead of double in WPF. This creates an incompatiblity when porting code. |
| ItemsControl.AlternationIndex / ItemsControl.AlternationCount | ✖ | ✔ | ✖ | WPF has an easy way to change the style of items in a list using ItemsControl.AlternationIndex and ItemsControl.AlternationCount. This allows, for example, to change the background color of a listed item for even/odd entries. UWP doesn't support this at all in any controls. The partial work-around in UWP is to create a new control deriving from the framework's implementation and override the PrepareContainerForItemOverride() method. |
| Custom Cursor at runtime | ✔ | ✔ | ✖ | |
| Sub-pixel anti-aliasing | ✔ | ✔ | ✖ | Anti-aliasing in UWP along with rendering in general is poor compared to WPF. It's assumed this is for performance reasons on mobile devices and the web (Silverlight). |
| Nested Types in XAML | ✔ | ✔ | ✖ | Nesting different types in XAML is generally not possible in UWP. Code such as <ListBox.ItemsSource><x:Array><s:string>foo<s/:string><x/:Array></ListBox.ItemsSource> works in WPF but not in UWP. |
| Event Tunneling / Event Bubbling / Routed Events | ✔ | ✔ | ⚡ | A lot more events are simply direct in UWP. Some cases of event bubbling such as ButtonBase.Click to parent are not supported in UWP. Event Tunneling, a concept fully supported in WPF, isn't support at all in UWP. |
| Window | ✔ | ✔ | ✖ | For some good reasons UWP has no concept of a window. This is fine for mobile devices but can be a problem for purely desktop applications. Without a window, there is no way to control an app's size or position. There are currently proposals to add this in the transition to WinUI 3.0. |
Controls
This section describes the differences in controls in vanilla WPF and UWP (with the WinUI 2.x library). It excludes some primitives and shapes (Ellipse, Rect, etc.)
| Avalonia | WPF | UWP | Notes |
|---|---|---|---|
| ✖ | ✖ | AppBarButton | |
| ✖ | ✖ | AppBarSeparator | |
| ✖ | ✖ | AppBarToggleButton | |
| AutoCompleteBox | ✖ | AutoSuggestBox | AutoCompleteBox doesn't support query events |
| Border | Border | Border | |
| BulletDecorator | ✖ | ||
| Button | Button | Button | |
| CalendarDatePicker | DatePicker | CalendarDatePicker | UWP DatePicker is different from WPF DatePicker. The WPF DatePicker is closer to the UWP CalendarDatePicker in functionality. |
| Calendar | Calendar | CalendarView | |
| Canvas | Canvas | Canvas | |
| ✖ | ✖ | CaptureElement | |
| CheckBox | CheckBox | CheckBox | |
| ✖ | ✖ | ColorPicker | |
| ComboBox | ComboBox | ComboBox | |
| ✖ | ToolBar | CommandBar | |
| ✖ | ✖ | CommandBarFlyout | First introduced in the Windows UI Library |
| ContentControl | ✖ | ContentControl | |
| ContentPresenter | ✖ | ContentPresenter | |
| DataGrid | DataGrid | ✖ | Available for UWP in the Windows Community Toolkit (albeit with many bugs) |
| DatePicker | ✖ | DatePicker | A picker to select a date without a calendar view does not exist in WPF. |
| DatePickerFlyout | ✖ | DatePickerFlyout | |
| DockPanel | DockPanel | ✖ | Available for UWP in the Windows Community Toolkit |
| ✖ | DocumentViewer | ✖ | |
| ✖ | ✖ | DropDownButton | First introduced in the Windows UI Library |
| Expander | Expander | ✖ | Available for UWP in the Windows Community Toolkit |
| Carousel | ✖ | FlipView | |
| ✖ | FlowDocumentPageViewer | ✖ | |
| ✖ | FlowDocumentReader | ✖ | |
| ✖ | FlowDocumentScrollViewer | ✖ | |
| ✖ | ✖ | Flyout | |
| ✖ | Frame | Frame | |
| Grid | Grid | Grid | |
| GridSplitter | GridSplitter | ✖ | Available for UWP in the Windows Community Toolkit |
| ✖ | ✖ | GridView | |
| ✖ | GroupBox | ✖ | |
| ✖ | ✖ | Hub | |
| ✖ | ✖ | HubSection | |
| ✖ | ✖ | HyperlinkButton | |
| Image | Image | Image | |
| ✖ | InkCanvas | ||
| ✖ | InkToolbar | ||
| ItemsControl | ✖ | ItemsControl | |
| ItemsPresenter | ✖ | ItemsPresenter | |
| ItemsRepeater | ✖ | ItemsRepeater | First introduced in the Windows UI Library |
| Label | Label | ✖ | For compatiblity with Windows Forms |
| ListBox | ListBox | ListBox | |
| ✖ | ListView | ListView | |
| ✖ | ✖ | MapControl | |
| ✖ | ✖ | MediaElement | |
| ✖ | ✖ | MediaTransportControls | |
| Menu | Menu | MenuBar | First introduced in the Windows Community Toolkit then Windows UI Library |
| ContextMenu | ContextMenu | MenuFlyout | |
| ✖ | ✖ | NavigationView | |
| Panel | Panel | ✖ | |
| ✖ | ✖ | ParallaxView | |
| TextBox (PasswordChar) | PasswordBox | PasswordBox | |
| ✖ | ✖ | PersonPicture | |
| TabControl | TabControl | Pivot | |
| TabItem | TabItem | PivotItem | |
| Popup | Popup | Popup | |
| ✖ | PrintDialog | ✖ | |
| ProgressBar | ProgressBar | ProgressBar | |
| ✖ | ✖ | ProgressRing | |
| ✖ | ✖ | PullToRefresh | |
| RadioButton | RadioButton | RadioButton | |
| ✖ | ✖ | RatingControl | |
| Rectangle | Rectangle | Rectangle | |
| ✖ | ✖ | RefreshContainer | First introduced in the Windows UI Library |
| RelativePanel | ✖ | RelativePanel | |
| RepeatButton | RepeatButton | RepeatButton | |
| ✖ | RichTextBox | RichEditBox | |
| ✖ | ✖ | RichTextBlock | |
| ✖ | ✖ | RichTextBlockOverflow | |
| ScrollBar | ScrollBar | ScrollBar | |
| ScrollContentPresenter | ✖ | ScrollContentPresenter | |
| ScrollViewer | ScrollViewer | ScrollViewer | |
| ✖ | ✖ | SemanticZoom | |
| Separator | Separator | ✖ | |
| Slider | Slider | Slider | |
| ✖ | ✖ | SplitButton | First introduced in the Windows UI Library |
| SplitView | SplitView | ||
| StackPanel | StackPanel | StackPanel | |
| ✖ | StatusBar | ✖ | No longer a UI convention |
| ✖ | ✖ | SwipeControl | First introduced in the Windows UI Library |
| ✖ | ✖ | TabView | First introduced in the Windows UI Library |
| ✖ | ✖ | TeachingTip | First introduced in the Windows UI Library |
| TextBlock | TextBlock | TextBlock | |
| TextBox | TextBox | TextBox | |
| TimePicker | ✖ | TimePicker | |
| TimePickerFlyout | ✖ | TimePickerFlyout | |
| ToggleButton | ToggleButton | ToggleButton | |
| ✖ | ✖ | ToggleSplitButton | First introduced in the Windows UI Library |
| ToggleSwitch | ✖ | ToggleSwitch | |
| ToolTip | ToolTip | ToolTip | |
| TreeView | TreeView | TreeView | |
| ✖ | ✖ | TwoPaneView | First introduced in the Windows UI Library |
| ✖ | ✖ | VariableSizedWrapGrid | |
| Viewbox | Viewbox | Viewbox | |
| ✖ | ✖ | WebView | |
| WrapPanel | WrapPanel | ✖ | Available for UWP in the Windows Community Toolkit |
| Window | Window | ✖ | There is no top-level window concept in UWP |
Quirks
- Several UWP controls have reentrancy issues. For example, changing the selected item while in a ComboBox SelectionChanged event is largely not possible and will result in a crash. This makes validation directly in the event handler nearly impossible.
- UWP controls are generally not as powerful as the WPF counterparts. For example, for several years the ComboBox in UWP was not editable. The UWP DatePicker also does not allow typing in a specific date.
- UWP has no support for data (input) validation. This is a large issue for line-of-business apps migrating from WPF to UWP that heavily use this feature in view models or binding.
- The UWP styling system is different enough from WPF to require extra effort during porting. UWP uses the VistualStateManger instead of concepts like DataTriggers or EventTriggers from WPF. Styling/Templating are one of the main differences.
- The ResourceDictionary XAML markup in UWP supports far fewer features than in WPF.
- UWP seems to follow only the XAML/2006 spec instead of XAML/2009 supported by WPF
- Several UWP controls are sealed and new controls cannot derive from them
- For advanced rendering, UWP has fewer features built in. This requires falling back to Win2D or composition more often.
- There are several namespaces differences in UWP and WPF. For example, WPF has System.Windows.Media.Colors while UWP moves this to Windows.UI.Colors.