Nouveautés d'Avalonia 12¶
Ce qui change quand on vient d'Avalonia 11, et ce qui arrive de nouveau.
Plateformes¶
- .NET 8 minimum, .NET 10 recommandé. .NET Framework et .NET Standard ne sont plus supportés.
- Android et iOS : .NET 10 uniquement.
- Supprimés : Direct2D1, Tizen,
Avalonia.Browser.Blazor. - SkiaSharp 3.0.
Compiled bindings par défaut¶
{Binding} est maintenant compilé : le chemin est vérifié à la compilation, il faut donc indiquer le type de données avec x:DataType.
<Window xmlns:vm="using:MonApp.ViewModels"
x:DataType="vm:MainViewModel">
<TextBlock Text="{Binding Titre}" /> <!-- erreur de compilation si Titre n'existe pas -->
</Window>
Détails : Compiled bindings.
Renommages courants¶
| Avalonia 11 | Avalonia 12 |
|---|---|
TextBox.Watermark |
TextBox.PlaceholderText |
TextBox.UseFloatingWatermark |
TextBox.UseFloatingPlaceholder |
ToggleButton.Checked / Unchecked |
ToggleButton.IsCheckedChanged |
Popup.PlacementMode / ContextMenu.PlacementMode |
Placement |
GotFocusEventArgs |
FocusChangedEventArgs |
Gestures.Pinch="…" |
Pinch="…" |
Window.SystemDecorations |
Window.WindowDecorations |
RenderOptions.TextRenderingMode |
TextOptions.TextRenderingMode |
TextBlock.LetterSpacing |
TextElement.LetterSpacing |
CubicBezierEasing |
SplineEasing |
AttachDevTools() |
AttachDeveloperTools() |
<!-- v11 -->
<TextBox Watermark="Rechercher…" />
<!-- v12 -->
<TextBox PlaceholderText="Rechercher…" />
// v11
toggle.Checked += OnChecked;
// v12
toggle.IsCheckedChanged += (_, _) => Debug.WriteLine(toggle.IsChecked);
Presse-papiers et glisser-déposer¶
// v11
await clipboard.SetTextAsync("x");
var t = await clipboard.GetTextAsync();
// v12
await clipboard.SetTextAsync("x");
var t = await clipboard.TryGetTextAsync();
IDataObject → IAsyncDataTransfer, DataFormats → DataFormat, DragDrop.DoDragDrop → DoDragDropAsync,
DragEventArgs.Data → DragEventArgs.DataTransfer.
Voir Presse-papiers et Glisser-déposer.
Dialogues de fichiers¶
OpenFileDialog, SaveFileDialog et OpenFolderDialog sont supprimés. On passe par StorageProvider :
var fichiers = await TopLevel.GetTopLevel(this)!.StorageProvider
.OpenFilePickerAsync(new FilePickerOpenOptions { Title = "Ouvrir" });
Voir Fichiers et dossiers.
TopLevel¶
Ne castez plus la racine visuelle en Window : utilisez TopLevel.GetTopLevel(visual).
Fenêtres¶
WindowStaten'est plus une styled property : impossible de la définir dans un style.ExtendClientAreaChromeHintsest supprimé : utilisezWindowDecorations+ExtendClientAreaToDecorationsHint.- Les contrôles
TitleBar/CaptionButtonssont remplacés parWindowDrawnDecorations.
Nouvelles fonctionnalités¶
-
Navigation par pages
NavigationPage,ContentPage,TabbedPage,DrawerPage: pile de navigation façon mobile. Navigation -
Performances
Jusqu'à 3× plus rapide sur Android.
-
Focus
FocusManagerpublic, annulation des changements de focus, nouvelle API de parcours. -
Multi-dispatchers
Un
Dispatcherpar thread (Dispatcher.CurrentDispatcher). -
Tests headless
Support de xUnit v3 et NUnit 4.
-
WebView
Le contrôle WebView natif devient open source.
Validation des données¶
Le plugin DataAnnotations est désactivé par défaut. Les erreurs remontent via INotifyDataErrorInfo
(voir Validation).
Dispatcher¶
Dispatcher.UIThread fonctionne toujours. Attention : DispatcherTimer utilise désormais le dispatcher du thread courant.
Créez-le sur le thread UI.
Migration
Si votre projet v11 compile sans avertissement d'obsolescence, la migration est en général rapide. Liste complète : breaking changes officiels.