An Avalonia 12.1.2 UI component library with a rich collection of control themes and practical controls. Both the library and the demo app target .NET 8, .NET 9, and .NET 10. Applications using the library must use a compatible Avalonia 12 version. Building the multi-targeted projects requires the .NET 10 SDK or later.
Using WPF as well? Check out WPFDevelopers, which provides a rich collection of controls and practical examples for Windows desktop apps. The demo home page also includes a link to the WPF version.
dotnet add package WPFDevelopers.AvaloniaAdd the WD namespace and load the resources in App.axaml:
<Application xmlns="https://github.com/avaloniaui"
xmlns:wd="https://github.com/WPFDevelopersOrg/WPFDevelopers.Avalonia"
x:Class="YourApp.App">
<Application.Resources>
<wd:Resources/>
</Application.Resources>
</Application>ThemeMode supports System, Light, and Dark. Omit the Theme attribute to restore the saved mode, or follow the system when no mode has been saved. To set a mode explicitly, use Theme="System", Theme="Light", or Theme="Dark".
ThemeManager.Instance.Theme is the selected mode; ActualTheme is the applied Light or Dark theme. Listen to ThemeModeChanged for changes to the selection, and to ThemeChanged for changes to the applied theme. When migrating, replace ThemeType.Default with ThemeMode.System and ThemeType.Light/Dark with ThemeMode.Light/Dark.
The library includes Chinese (zh-CN), English (en-US), and Korean (ko-KR) resources. Change the UI culture at runtime and bind XAML text with the Language markup extension:
using System.Globalization;
using WPFDevelopers.Avalonia;
LanguageManager.Instance.ChangeLanguage(new CultureInfo("ko-KR"));<TextBlock Text="{wd:Language Key=OK}" />In the demo home page, Personalization β Language changes the display language for the samples and control library.
Dialog displays an in-window overlay and returns a result from ShowAsync. Its content must be a UserControl not attached to another container. The owner must be visible and provide an OverlayLayer; only one Dialog may be open per window.
var dialog = new Dialog
{
Owner = ownerWindow,
Title = "Edit",
Content = new EditUserControl(),
DialogWidth = 400
};
dialog.Closing += (_, e) =>
{
if (e.Reason == DialogCloseReason.Confirm && !CanSave())
e.Cancel = true;
};
DialogResult result = await dialog.ShowAsync();Use the two-way IsOpen property, IsConfirmEnabled, or Close to control the dialog. Confirmation updates binding sources and checks Avalonia data validation errors. Closing can cancel a close, and ClosedCommand receives the result. Closing the owner produces Canceled. Content cannot be replaced while the dialog is open. Button labels follow the current language unless ConfirmText or CancelText is set. Unlike WPF, this Avalonia implementation uses UserControl content and template buttons rather than WPF pages and routed commands. Owner-window KeyBindings can still fire while the dialog is open; gate those commands in CanExecute when necessary.
Carousel supports inline XAML content or image data bound through ItemsSource and DisplayMemberPath. Use AutoPlay and AutoPlayInterval to configure automatic playback, and handle clicks with ItemClick or ItemClickCommand.
<wd:Carousel Width="400"
Height="200"
AutoPlay="True"
AutoPlayInterval="0:0:3"
ShowArrows="True"
ShowDots="True"
ItemClick="OnCarouselItemClick">
<Border Background="#722ed1">
<TextBlock Text="Slide 1"
FontSize="24"
Foreground="White"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
</Border>
<Border Background="#1890ff">
<TextBlock Text="Slide 2"
FontSize="24"
Foreground="White"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
</Border>
</wd:Carousel>When binding image data, use DisplayMemberPath to specify the image path property. SelectedIndex and SelectedItem support two-way binding. You can also call GoToNext() or GoToPrevious() in code to change slides.
<wd:Carousel Width="400"
Height="200"
ItemsSource="{Binding ImageItems}"
DisplayMemberPath="URL"
AutoPlay="True"
AutoPlayInterval="0:0:3" />When ItemClick fires, read the current item from the control's SelectedItem. Alternatively, bind ItemClickCommand; its parameter is the clicked data item.
private void OnCarouselItemClick(object? sender, RoutedEventArgs e)
{
if (sender is Carousel carousel)
HandleItemClick(carousel.SelectedItem);
}When autoplay or the next arrow advances from the last slide, the first slide enters from the right and resets seamlessly when the animation finishes. It does not move backward through the intervening slides or jump abruptly. Repeated previous/next actions are ignored during an animation to prevent overlapping transitions.
On Windows, wd:Window uses the WD title bar and window buttons; on other platforms it falls back to Avalonia's native Window. TitleBarMode="High" uses a taller title bar, and TitleBarLayout places toolbar content between the title and window buttons. Set ShowTheme="True" to add a title-bar menu for following the system theme or choosing light or dark mode. The selection is persisted per application in local application data.
The theme menu uses the WPF version's vector icons: hover over the theme button to open it, then move into the menu to choose a mode. Leaving both the button and menu closes it after 150 ms. Clicking or using the keyboard also opens the menu; Up/Down navigates and Escape closes it.
Open Basic β Window in the demo for title-bar and modal window examples. A modal window can return a result through ShowDialog<bool>(owner) and Close(true) / Close(false).
<wd:Window xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:wd="https://github.com/WPFDevelopersOrg/WPFDevelopers.Avalonia"
x:Class="YourApp.MainWindow"
Title="My App"
Width="900"
Height="600"
ShowTheme="True"
TitleBarMode="High">
<wd:Window.TitleBarLayout>
<StackPanel Orientation="Horizontal" Spacing="8">
<Button Content="Save" />
<Button Content="Settings" />
</StackPanel>
</wd:Window.TitleBarLayout>
<Grid>
<TextBlock Text="Window content"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
</Grid>
</wd:Window>TitleBarMode="Normal" uses the standard title bar. Set it to None to hide the standard title bar and provide custom content through TitleBar. TitleHeight and TitleBackground set the title bar's height and background, respectively.
<wd:Window Title="Custom title bar"
Width="800"
Height="500"
TitleBarMode="None">
<wd:Window.TitleBar>
<Grid ColumnDefinitions="*,Auto" Height="40">
<TextBlock Margin="12,0"
VerticalAlignment="Center"
Text="Custom title" />
<Button Grid.Column="1" Content="Help" Margin="4" />
</Grid>
</wd:Window.TitleBar>
<Grid>
<TextBlock Text="Window content"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
</Grid>
</wd:Window>When the pointer enters a resizable edge of a column header, a 5 px theme-colored indicator appears and disappears when the pointer leaves. It uses WD.PrimaryBrush, follows theme and accent-color changes, and does not intercept pointer events or affect column resizing, sorting, or reordering. No indicator is shown on edges that cannot be resized.
The WD scrollbar uses a slim-thumb interaction: the thumb is 2 px thick by default, expands to 10 px within 0.1 seconds when the pointer enters the scrollbar area, stays expanded while dragging, and retracts when the pointer leaves. Both horizontal and vertical scrollbars retain a fixed 12 px hit area, and expansion does not shift content.
Only the thumb becomes 50% opaque while expanded or being dragged, keeping content visible beneath the overlay. The default slim thumb remains fully opaque for visibility. Content opacity and the scrollbar hit area are unchanged.
Both orientations use the dedicated WD.ScrollBarThumbBrush; hover and drag use WD.ScrollBarThumbPointerOverBrush instead of reusing text colors. The default thumb color is light gray (#C0C4CC) in light themes and #606266 in dark themes; the interaction color is #909399 in both. Colors follow theme changes. Override WD.ScrollBarSize, WD.ScrollBarThumbSize, and WD.ScrollBarThumbExpandedSize to adjust the hit area and thumb thickness.
<WrapPanel>
<!-- Primary button -->
<Button Content="Primary" />
<!-- Round button -->
<Button Content="Primary" wd:ElementHelper.IsRound="True" Theme="{StaticResource wd-primary}" />
<!-- Default outlined button -->
<Button Content="Default" Theme="{StaticResource wd-default}" />
<!-- Borderless button -->
<Button Content="Normal" Theme="{StaticResource wd-normal}" />
<!-- Success / warning / danger (outlined) -->
<Button Content="Success" Theme="{StaticResource wd-success}" />
<Button Content="Warning" Theme="{StaticResource wd-warning}" />
<Button Content="Danger" Theme="{StaticResource wd-danger}" />
<!-- Success / warning / danger (filled) -->
<Button Content="Filled Success" Theme="{StaticResource wd-success-filled}" />
<Button Content="Filled Warning" Theme="{StaticResource wd-warning-filled}" />
<Button Content="Filled Danger" Theme="{StaticResource wd-danger-filled}" />
</WrapPanel><!-- Built-in PathIconEx icons -->
<wd:PathIconEx Kind="Home" Width="24" Height="24" Foreground="{DynamicResource WD.PrimaryBrush}" />
<wd:PathIconEx Kind="CheckMark" Width="24" Height="24" Foreground="{DynamicResource WD.SuccessBrush}" />
<wd:PathIconEx Kind="Warning" Width="24" Height="24" Foreground="{DynamicResource WD.WarningBrush}" />
<wd:PathIconEx Kind="Error" Width="24" Height="24" Foreground="{DynamicResource WD.DangerBrush}" />
<wd:PathIconEx Kind="Star" Width="24" Height="24" />
<wd:PathIconEx Kind="Add" Width="24" Height="24" />
<wd:PathIconEx Kind="Time" Width="24" Height="24" />
<wd:PathIconEx Kind="Copy" Width="24" Height="24" />
<wd:PathIconEx Kind="Filter" Width="24" Height="24" />
<!-- Use built-in geometry resources -->
<PathIcon Data="{StaticResource WD.CheckMarkGeometry}" Foreground="{DynamicResource WD.SuccessBrush}" Width="24" Height="24" /><!-- TextBox -->
<TextBox PlaceholderText="Enter text here..." />
<TextBox PlaceholderText="Clear text" Classes="IsClear" />
<TextBox PlaceholderText="Enter password here..." PasswordChar="β" RevealPassword="False" />
<!-- CheckBox -->
<CheckBox Content="CheckBox (checked)" IsChecked="True" />
<CheckBox Content="CheckBox (unchecked)" />
<CheckBox Content="CheckBox (indeterminate)" IsThreeState="True" IsChecked="{x:Null}" />
<!-- RadioButton -->
<RadioButton Content="Option A" GroupName="demo" IsChecked="True" />
<RadioButton Content="Option B" GroupName="demo" />
<!-- ToggleButton -->
<ToggleButton Content="Toggle Off" />
<ToggleButton Content="Toggle On" IsChecked="True" />
<!-- Switch style -->
<ToggleButton Theme="{StaticResource wd-switch}" IsChecked="True" />
<ToggleButton Theme="{StaticResource wd-switch}" />SwitchButton inherits from ToggleButton and uses the same UncheckedContent / CheckedContent API as the WPF version. It displays UncheckedContent when unchecked and CheckedContent when checked. Both properties support text, Image, SVG controls, and composite layouts. SVG rendering is handled by the application, so the control library does not depend on an SVG package. Both states share the inherited ContentTemplate; the control does not overwrite Content or its binding.
<wd:SwitchButton UncheckedContent="Off"
CheckedContent="On"
IsChecked="{Binding IsEnabled, Mode=TwoWay}" />
<wd:SwitchButton AutomationProperties.Name="Favorite">
<wd:SwitchButton.UncheckedContent>
<wd:PathIconEx Kind="Star" Width="20" Height="20" />
</wd:SwitchButton.UncheckedContent>
<wd:SwitchButton.CheckedContent>
<wd:PathIconEx Kind="Star" Width="20" Height="20"
Foreground="{DynamicResource WD.WarningBrush}" />
</wd:SwitchButton.CheckedContent>
</wd:SwitchButton>The default appearance follows WPF: no persistent background, with visual feedback on hover and press. Keyboard focus, the Space key, commands, and the disabled state are supported. Extend its styling with the WD.SwitchButton theme. Keep IsThreeState="False" in most cases; when three-state mode is enabled, IsChecked="{x:Null}" displays UncheckedContent, just like the unchecked state. Set AutomationProperties.Name on icon-only buttons.
Unlike the wd-switch toggle-switch style, SwitchButton toggles between two content views. Use a multi-option selector for multiple accent colors or a "follow system" option.
Password is a string of node indices (0β8) in the order they were selected. Validate it through the Completed event or CompletedCommand, then set State to display success or error feedback.
<wd:GestureUnlock Width="300"
Height="300"
Completed="GestureUnlock_Completed" />private void GestureUnlock_Completed(object? sender, RoutedEventArgs e)
{
if (sender is GestureUnlock unlock)
unlock.State = unlock.Password == "0426" ? ControlState.Success : ControlState.Error;
}The control supports numeric input, automatic focus advance, arrow-key navigation, Backspace, and Ctrl+V paste. Value is two-way by default and contains the complete code only when every box is filled; otherwise, it is an empty string.
Validate completed input with the Completed event or CompletedCommand. Set State to OtpBoxState.Success or OtpBoxState.Error to show feedback. The state resets after 1.5 seconds; an error also clears the input.
<wd:OtpBox Length="6"
Value="{Binding VerificationCode, Mode=TwoWay}"
CompletedCommand="{Binding VerifyCommand}"
BoxWidth="36"
BoxHeight="44"
Spacing="6" />Supports vertical and horizontal timelines. Mode can be Start (content on the right/bottom), Alternate, or End (content on the left/top). Reverse reverses the displayed order without changing the source collection. ItemSpacing, LineBrush, and LineThickness configure spacing and connector lines.
<wd:Timeline Mode="Alternate" ItemSpacing="20">
<wd:TimelineItem Label="09:00" Content="Create service" />
<wd:TimelineItem Label="10:00" Content="Testing complete"
DotBrush="{DynamicResource WD.SuccessBrush}" />
<wd:TimelineItem Label="11:00" Content="Deploying" IsLoading="True" />
</wd:Timeline>Set Orientation="Horizontal" for a horizontal layout. Items support Label / LabelTemplate, Dot / DotTemplate, and ContentTemplate. Set an item's Position to "Start" or "End" to override its position. IsLoading displays a rotating dot and renders adjacent connector lines as dashed.
To display a data collection with ItemsSource and ItemTemplate, use a Style Selector="wd|TimelineItem" in Timeline.Styles to bind properties such as Label, DotBrush, and IsLoading on generated items.
DisplayMode="Inline" (the default) displays the color palette inline. Popup displays a swatch that opens the palette when clicked. SelectedColor is two-way by default, and the palette supports RGB, HSL, and HEX input formats.
<wd:ColorPicker SelectedColor="{Binding SelectedColor, Mode=TwoWay}" />
<wd:ColorPicker DisplayMode="Popup"
ShowColorText="True"
SelectedColor="{Binding SelectedColor, Mode=TwoWay}" />
<wd:ColorPickerButton ShowColorText="True"
SelectedColor="{Binding SelectedColor, Mode=TwoWay}" />ShowColorText controls whether the popup swatch displays its HEX value. SwatchSize sets the swatch size, and ColorType sets the palette's initial format. ColorPickerButton remains available for compatibility; new code should use ColorPicker DisplayMode="Popup".
The popup is aligned with the trigger's left edge by default, preventing it from shifting as the HEX text width changes during color selection. Avalonia adjusts its position near screen edges.
The main button raises Click, and the dropdown items come from ItemsSource. Selecting a dropdown item updates the button content and raises SelectionChanged.
<wd:SplitButton Content="Save"
ItemsSource="{Binding MenuItems}"
Theme="{StaticResource WD.SplitButtonPrimary}"
Click="OnMainClick"
SelectionChanged="OnSelectionChanged" />The SelectionChanged event args provide OldValue and NewValue. Available themes include WD.SplitButtonPrimary, WD.SplitButtonSuccess, WD.SplitButtonWarning, WD.SplitButtonDanger, and the corresponding SuccessPrimary, WarningPrimary, and DangerPrimary variants.
Supports search, multiple selection, select-all, and displaying selected items as delimited text or tags. Use DisplayMemberPath to specify which property to display for each item.
<wd:MultiSelectComboBox Width="320"
ItemsSource="{Binding TeamMembers}"
SelectedItemsExt="{Binding SelectedMembers}"
DisplayMemberPath="Name"
PlaceholderText="Select team members"
SearchWatermark="Search members"
SelectionMode="Multiple"
SelectAllContent="Select All"
Delimiter=", " />Bind SelectedItemsExt to an IList in your view model to synchronize the selected items. Set ShowType="Tag" to display selections as tags, or IsSearch="False" to disable search.
A single-selection segmented control that can be arranged horizontally or vertically. Read its selection using inherited ListBox properties such as SelectedIndex and SelectedItem.
<wd:Segmented SelectedIndex="0">
<wd:SegmentedItem Content="Custom" />
<wd:SegmentedItem Content="Basic controls" />
</wd:Segmented>Set Orientation="Vertical" for a vertical layout. AnimationDuration controls the selection indicator's animation duration.
The pagination control supports page navigation, a total-count display, page-size selection, quick jump, and simple mode. Current and PageSize support two-way binding. Use PageChanged to get the current page and page size after user interaction.
<wd:Pagination Current="1" PageSize="10" Total="85"
ShowTotal="True"
ShowSizeChanger="True"
ShowQuickJumper="True"
PageChanged="OnPageChanged" />
<wd:Pagination Current="1" Total="85" Simple="True" />The PageChanged event args, PaginationChangedEventArgs, provide the updated Current and PageSize, which you can use to load the corresponding data page. Set PageSizeOptions to customize the available page sizes, or Disabled="True" to disable pagination.
<wd:GroupBox Header="Group Title" Width="500">
<TextBlock Text="This is the content of the GroupBox." Margin="4" />
</wd:GroupBox>
<!-- The header can contain arbitrary content -->
<wd:GroupBox Width="500">
<wd:GroupBox.Header>
<StackPanel Orientation="Horizontal" Spacing="8">
<wd:PathIconEx Kind="Home" Width="16" Height="16" />
<TextBlock Text="Header with Icon" />
</StackPanel>
</wd:GroupBox.Header>
<TextBlock Text="Content here" Margin="4" />
</wd:GroupBox><wd:Tag Content="Default Tag" />
<wd:Tag Content="Non-closable" IsClose="False" />
<!-- Two-part badge in GitHub README / Shields style -->
<wd:Tag Classes="badge" Label="version" Content="12.1.2" Background="#E05D44" />
<wd:Tag Classes="badge" Label="stars" Content="1,234" Background="#DFB317" />
<wd:Tag Classes="badge" Label="downloads" Content="12,345" Background="#007EC6" />Classes="badge" uses a compact two-part layout with a label on the left and content on the right, without a close button. It is still a Tag control: Label, LabelBackground, and LabelForeground configure the left side, while Content, Background, and Foreground configure the right. Bindings, content templates, font size, padding, and corner radius are supported. This README badge differs from control-attached badges provided by properties such as wd:Badge.BadgeText; the appearance and close behavior of regular tags are unchanged.
<Label Content="Label Mask" Background="{StaticResource WD.DangerBrush}"
Width="100" Height="100"
wd:Mask.IsShow="True"/><Label Content="Label Loading" Background="{StaticResource WD.PrimaryBrush}"
Width="100" Height="100"
wd:Loading.IsShow="True"/>wd:Loading.IsShow displays a loading overlay on a control. To show a standalone spinner instead, use DefaultLoading and control its animation with IsActive:
<wd:DefaultLoading IsActive="True"
StrokeBrush="{DynamicResource WD.PrimaryBrush}"
ArcThickness="2" /><!-- Text badge -->
<Button wd:Badge.BadgeText="5" Content="Messages" Theme="{StaticResource wd-default}" />
<Button wd:Badge.BadgeText="99+" Content="Notifications" Theme="{StaticResource wd-default}" />
<!-- Dot badge -->
<Button wd:Badge.IsDot="True" Content="Dot Badge" Theme="{StaticResource wd-default}" /><!-- Horizontal progress bar -->
<ProgressBar Value="60" Width="400" ShowProgressText="True"/>
<ProgressBar IsIndeterminate="True" Value="20" Width="400" />
<!-- Vertical progress bar -->
<ProgressBar Value="20" Height="300" Orientation="Vertical" ShowProgressText="True"/>
<!-- Slider -->
<Slider Width="400" Minimum="0" Maximum="100" Value="40" />
<Slider Width="400" Orientation="Vertical" Minimum="0" Maximum="100" Value="40" /><wd:Step StepIndex="1">
<wd:StepItem Content="Account" />
<wd:StepItem Content="Profile" />
<wd:StepItem Content="Confirmation" />
</wd:Step>StepIndex is zero-based; preceding steps are shown as completed. Set Orientation="Vertical" for a vertical layout.
<wd:Drawer Position="Left" IsOpen="{Binding IsDrawerOpen}" HeaderWidth="280">
<wd:Drawer.Header>
<StackPanel Width="280" Spacing="8">
<TextBlock FontSize="18" Text="Drawer" />
<TextBlock Text="Click the shaded area to close." />
</StackPanel>
</wd:Drawer.Header>
<TextBlock Text="Drawer content" />
</wd:Drawer>Position supports Left, Top, Right, and Bottom. Click the overlay to close the drawer. HeaderWidth limits the width of left and right drawers; if unset, the maximum width defaults to two-thirds of the control's width.
On initial layout, the drawer immediately reflects IsOpen without an animation. Animations play when IsOpen changes afterward.
<!-- Expand down -->
<Expander Header="Expander">
<Rectangle Width="400" Height="300" Fill="{DynamicResource WD.DangerBrush}" />
</Expander>
<!-- Expand up (expanded by default) -->
<Expander ExpandDirection="Up" FlowDirection="RightToLeft" Header="Expander1" IsExpanded="True">
<Rectangle Width="400" Height="300" Fill="{DynamicResource WD.LightBrush}" />
</Expander>
<!-- Expand right -->
<Expander ExpandDirection="Right" Header="Expander">
<Rectangle Width="400" Height="300" Fill="{DynamicResource WD.SuccessMouseOverBrush}" />
</Expander>
<!-- Expand left (expanded by default) -->
<Expander ExpandDirection="Left" IsExpanded="True" Header="Expander">
<Rectangle Width="400" Height="300" Fill="{DynamicResource WD.PrimaryBrush}" />
</Expander><ComboBox Width="200" SelectedIndex="0">
<ComboBoxItem Content="Option 1" />
<ComboBoxItem Content="Option 2" />
<ComboBoxItem Content="Option 3" />
</ComboBox><DataGrid Name="DemoDataGrid" Width="500" Height="200" x:DataType="local:DemoItem">
<DataGrid.Columns>
<DataGridTextColumn Header="Name" Binding="{Binding Name}" Width="150" />
<DataGridTextColumn Header="Age" Binding="{Binding Age}" Width="80" />
<DataGridCheckBoxColumn Header="Active" Binding="{Binding IsActive}" Width="80" />
<DataGridTextColumn Header="Role" Binding="{Binding Role}" Width="*" />
</DataGrid.Columns>
</DataGrid><!-- Date controls -->
<DatePicker Width="200" />
<Calendar />
<CalendarDatePicker Width="200"/>
<!-- Time pickers -->
<TimePicker Width="200" />
<TimePicker Width="200" UseSeconds="True"/>
<TimePicker Width="200" ClockIdentifier="12HourClock"/><ListBox Width="200" Height="150" SelectionMode="Single">
<ListBoxItem Content="Item One" />
<ListBoxItem Content="Item Two" IsSelected="True" />
<ListBoxItem Content="Item Three" />
</ListBox><Menu>
<MenuItem Header="File">
<MenuItem Header="New" />
<MenuItem Header="Open" />
<Separator />
<MenuItem Header="Exit" />
</MenuItem>
<MenuItem Header="Edit">
<MenuItem Header="Cut" />
<MenuItem Header="Copy" />
</MenuItem>
</Menu><TabControl Width="400" Height="150">
<TabItem Header="General">
<TextBlock Text="General settings content" Margin="8" />
</TabItem>
<TabItem Header="Advanced">
<TextBlock Text="Advanced settings content" Margin="8" />
</TabItem>
</TabControl><TreeView Width="250" Height="200">
<TreeViewItem Header="Root">
<TreeViewItem Header="Child 1">
<TreeViewItem Header="Grandchild 1.1" />
<TreeViewItem Header="Grandchild 1.2" />
</TreeViewItem>
<TreeViewItem Header="Child 2" />
<TreeViewItem Header="Child 3" IsExpanded="True">
<TreeViewItem Header="Grandchild 3.1" />
</TreeViewItem>
</TreeViewItem>
</TreeView><RepeatButton Content="-" Width="40" Height="40" />
<RepeatButton Width="40" Height="40">
<wd:PathIconEx Kind="Add" />
</RepeatButton><Label Content="Primary Label" Foreground="{DynamicResource WD.PrimaryBrush}" />
<Label Content="Regular label" />
<!-- Hyperlink label -->
<Label Content="HyperlinkButton">
<Label.ContentTemplate>
<DataTemplate>
<HyperlinkButton Content="{Binding}" NavigateUri="https://github.com/WPFDevelopersOrg/WPFDevelopers.Avalonia" />
</DataTemplate>
</Label.ContentTemplate>
</Label>
<Separator Margin="0,12" /><NumericUpDown Width="200" Value="42" Minimum="0" Maximum="1000" /><AutoCompleteBox Width="200" FilterMode="Contains" PlaceholderText="Search..." /><SplitView IsPaneOpen="True" OpenPaneLength="200"
Width="400" Height="250"
DisplayMode="CompactOverlay">
<SplitView.Pane>
<StackPanel Background="{DynamicResource WD.BaseMoveBrush}">
<TextBlock Text="Pane" FontWeight="SemiBold" Margin="8,0" />
<Button Content="Home" Theme="{StaticResource wd-normal}" Margin="0,2" />
<Button Content="Settings" Theme="{StaticResource wd-normal}" Margin="0,2" />
</StackPanel>
</SplitView.Pane>
<Border Background="{DynamicResource WD.LightBrush}" Padding="16">
<TextBlock Text="Main Content" VerticalAlignment="Center" HorizontalAlignment="Center" />
</Border>
</SplitView>Reserve an Auto-sized row or column for the splitter in the Grid. Drag it to resize adjacent rows or columns. Set ResizeDirection to match the splitter's row or column, use ResizeBehavior to choose which definitions to resize, and enable ShowsPreview to show a preview while dragging.
<StackPanel Spacing="16">
<!-- Vertical splitter: resize the left and right columns -->
<Grid Height="180" ColumnDefinitions="*,Auto,*">
<Border Grid.Column="0" MinWidth="60" Background="{DynamicResource WD.PrimaryMouseOverBrush}">
<TextBlock Text="Left pane" HorizontalAlignment="Center" VerticalAlignment="Center" />
</Border>
<GridSplitter Grid.Column="1"
Width="5"
Margin="2,0"
ResizeBehavior="PreviousAndNext"
ResizeDirection="Columns"
ShowsPreview="True" />
<Border Grid.Column="2" MinWidth="60" Background="{DynamicResource WD.PrimaryMouseOverBrush}">
<TextBlock Text="Right pane" HorizontalAlignment="Center" VerticalAlignment="Center" />
</Border>
</Grid>
<!-- Horizontal splitter: resize the top and bottom rows -->
<Grid Height="240" RowDefinitions="*,Auto,*">
<Border Grid.Row="0" MinHeight="40" Background="{DynamicResource WD.PrimaryMouseOverBrush}">
<TextBlock Text="Top pane" HorizontalAlignment="Center" VerticalAlignment="Center" />
</Border>
<GridSplitter Grid.Row="1"
Height="5"
Margin="0,2"
ResizeBehavior="PreviousAndNext"
ResizeDirection="Rows"
ShowsPreview="False" />
<Border Grid.Row="2" MinHeight="40" Background="{DynamicResource WD.PrimaryMouseOverBrush}">
<TextBlock Text="Bottom pane" HorizontalAlignment="Center" VerticalAlignment="Center" />
</Border>
</Grid>
</StackPanel><Button Content="Right-click me for ContextMenu" Theme="{StaticResource wd-default}">
<Button.ContextMenu>
<ContextMenu>
<MenuItem Header="Copy" />
<MenuItem Header="Paste" />
<MenuItem Header="Cut" />
<Separator />
<MenuItem Header="Select All" />
</ContextMenu>
</Button.ContextMenu>
</Button><Button Content="Info" Theme="{StaticResource wd-primary}" Name="ToastInfoBtn" />
<Button Content="Success" Theme="{StaticResource wd-success}" Name="ToastSuccessBtn" />
<Button Content="Warning" Theme="{StaticResource wd-warning}" Name="ToastWarningBtn" />
<Button Content="Error" Theme="{StaticResource wd-danger}" Name="ToastErrorBtn" />
<Button Content="Clear" Theme="{StaticResource wd-normal}" Name="ToastClearBtn" /><Button Content="Info" Theme="{StaticResource wd-primary}" Name="MsgBoxInfoBtn" />
<Button Content="Warning" Theme="{StaticResource wd-warning}" Name="MsgBoxWarningBtn" />
<Button Content="Error" Theme="{StaticResource wd-danger}" Name="MsgBoxErrorBtn" />
<Button Content="Question" Theme="{StaticResource wd-success}" Name="MsgBoxQuestionBtn" />
<Button Content="YesNoCancel" Theme="{StaticResource wd-default}" Name="MsgBoxYesNoCancelBtn" />// Initialize in App.OnFrameworkInitializationCompleted or a Window constructor
if (Application.Current is { } app)
{
var trayIcons = TrayIcon.GetIcons(app);
if (trayIcons == null || trayIcons.Count == 0)
{
var tray = new TrayIcon
{
Icon = new WindowIcon(AssetLoader.Open(new Uri("avares://YourApp/Assets/App.ico"))),
Menu = new NativeMenu
{
new NativeMenuItem("Show"),
new NativeMenuItemSeparator(),
new NativeMenuItem("Exit")
}
};
TrayIcon.SetIcons(app, [tray]);
}
}
// Bind menu item click handlers in the Window code
private void TrayShow_Click(object? sender, EventArgs e)
{
Show();
WindowState = WindowState.Normal;
Activate();
}
private void TrayExit_Click(object? sender, EventArgs e)
{
Environment.Exit(0);
}Note: Avalonia's
TrayIconcannot be configured using XAML properties. Initialize it in code withTrayIcon.SetIcons(). TheTipproperty is unavailable in the current version.
ThemeManager.Instance.PrimaryColor = Color.Parse("#6366F1");<wd:Resources Theme="Light"/>
<ResourceDictionary>
<Color x:Key="WD.PrimaryColor">#6366F1</Color>
</ResourceDictionary>| Key | Type | Description |
|---|---|---|
WD.PrimaryBrush |
Brush |
Accent brush |
WD.BackgroundBrush |
Brush |
Background brush |
WD.PrimaryTextBrush |
Brush |
Primary text brush |
WD.RegularTextBrush |
Brush |
Regular text brush |
WD.SuccessBrush |
Brush |
Success color |
WD.WarningBrush |
Brush |
Warning color |
WD.DangerBrush |
Brush |
Danger color |
WD.CornerRadius |
CornerRadius |
Default corner radius |
WD.ScrollBarSize |
double |
Scrollbar size |
WD.Padding |
Thickness |
Default padding |
