Mvvm.CommonInteractions.Maui 1.0.68

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package Mvvm.CommonInteractions.Maui --version 1.0.68                

                    
                

            
NuGet\Install-Package Mvvm.CommonInteractions.Maui -Version 1.0.68
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Mvvm.CommonInteractions.Maui" Version="1.0.68" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Mvvm.CommonInteractions.Maui --version 1.0.68                

                    
                

            
#r "nuget: Mvvm.CommonInteractions.Maui, 1.0.68"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Mvvm.CommonInteractions.Maui as a Cake Addin
#addin nuget:?package=Mvvm.CommonInteractions.Maui&version=1.0.68

// Install Mvvm.CommonInteractions.Maui as a Cake Tool
#tool nuget:?package=Mvvm.CommonInteractions.Maui&version=1.0.68

Mvvm.CommonInteractions

Common MVVM Level Interactions(like open/save file) for WPF/UWP/WinUI/Uno/Avalonia/Maui platforms. Features:

  • Easy interactions with files, message boxes, web from MVVM level.
  • Enables drag-and-drop support at the ViewModel level.
  • Wide choice of platforms
  • Dependency injection friendly

NuGet

NuGet NuGet NuGet NuGet NuGet NuGet NuGet

Install-Package Mvvm.CommonInteractions.Core
Install-Package Mvvm.CommonInteractions.Wpf
Install-Package Mvvm.CommonInteractions.Uno
Install-Package Mvvm.CommonInteractions.Uwp
Install-Package Mvvm.CommonInteractions.WinUI
Install-Package Mvvm.CommonInteractions.Avalonia
Install-Package Mvvm.CommonInteractions.Maui

Usage

Add to your App constructors:


public sealed partial class App
{
    private IHost AppHost { get; }

    public App()
    {
        AppHost = Host
            .CreateDefaultBuilder()
            .ConfigureServices(static services =>
            {
                // Add all available interactions
                services.AddCommonInteractions();
                
                // or add only what you need
                services.AddSingleton<IFileInteractions, FileInteractions>();
                services.AddSingleton<IMessageInteractions, MessageInteractions>();
                services.AddSingleton<IWebInteractions, WebInteractions>();
            })
            .Build();

        // Optional. Displays unhandled exceptions using MessageInteractions.Exception.
        AppHost.Services.GetRequiredService<IMessageInteractions>().CatchUnhandledExceptions(this);

        // your code
    }
}

FileInteractions

// Open
var file = await FileInteractions.OpenFileAsync(new OpenFileArguments
{
    SuggestedFileName = "my.txt",
    Extensions = new[] { ".txt" },
    FilterName = "My txt files",
});
if (file == null)
{
    return;
}
var text = await file.ReadTextAsync().ConfigureAwait(true);

// Save (if you need to save file from previuos step)
await file.WriteTextAsync(text).ConfigureAwait(false);

// Save As
var file = await FileInteractions.SaveFileAsync(new SaveFileArguments(".txt")
{
    SuggestedFileName = "my.txt",
    FilterName = "My txt files",
});
if (file == null)
{
    return;
}
await file.WriteTextAsync(text).ConfigureAwait(false);

MessageInteractions

await MessageInteractions.ShowMessageAsync("Message");
await MessageInteractions.ShowWarningAsync("Warning");
await MessageInteractions.ShowExceptionAsync(new InvalidOperationException("Exception"));
bool question = await MessageInteractions.ShowQuestionAsync(new QuestionData("Are you sure?"));

WinUI requires a window to display the ContentDialog, so you'll need to set it explicitly in your App.OnLaunched:

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
#if HAS_WINUI
    var window = new Window();
    MessageInteractions.Window = window;
#endif
}

WebInteractions

await WebInteractions.OpenUrlAsync("https://www.google.com/");

DragAndDropExtensions

// WPF
xmlns:dragAndDrop="clr-namespace:Mvvm.CommonInteractions;assembly=Mvvm.CommonInteractions.Wpf" 
// UWP/Uno
xmlns:dragAndDrop="using:Mvvm.CommonInteractions"

<Element
    AllowDrop="True"
    dragAndDrop:DragAndDropExtensions.DragFilesEnterCommand="{Binding DragFilesEnter}"
    dragAndDrop:DragAndDropExtensions.DragTextEnterCommand="{Binding DragTextEnter}"
    dragAndDrop:DragAndDropExtensions.DragLeaveCommand="{Binding DragLeave}"
    dragAndDrop:DragAndDropExtensions.DropFilesCommand="{Binding DropFiles}"
    dragAndDrop:DragAndDropExtensions.DropTextCommand="{Binding DropText}"
    >

Command arguments: DragFilesEnterCommand - FileData[] - Array of files.
DragTextEnterCommand - string - Text.
DragLeaveCommand - null.
DropFilesCommand - FileData[] - Array of files.
DropTextCommand - string - Text.

Contacts

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-android34.0 is compatible.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-ios17.0 is compatible.  net8.0-maccatalyst was computed.  net8.0-maccatalyst17.0 is compatible.  net8.0-macos was computed.  net8.0-tizen8.0 is compatible.  net8.0-tvos was computed.  net8.0-windows was computed.  net8.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.68 203 12/18/2023
1.0.65 208 2/27/2023

⭐ Last 10 features:
- feat: Updated to net8.0. 2023-12-18
- feat: Updated packages. 2023-08-19
- feat: Updated NuGet packages. 2023-02-27
- feat: Added MAUI partial support. 2023-02-27
- feat: Added net7 targets. 2023-01-06
- feat: Updated NuGet packages. 2023-01-06
- feat: Added HostBuilder extensions. 2023-01-06
- feat: Removed ReactiveUI dependency. 2022-08-22
- feat: To IsExternalInit package. 2022-08-22
- feat: Updated NuGet packages. 2022-08-11

🐞 Last 10 bug fixes:
- fix: Fixed WebAssembly app. 2023-01-07
- fix: Fixed Uno projects. 2023-01-07
- fix: Fixed Avalonia dependencies. 2023-01-06
- fix: Fixed GetRequiredWindow exception message. 2022-08-22
- fix: To WinRT.Interop. 2022-07-14
- fix: Disabled linker. 2022-07-01
- fix: Fixed Uno targets. 2022-03-18
- fix: Fixed missing Warning ContentDialog. 2022-03-17
- fix(apps): Fixed Uno.WinUI webassembly app. 2022-01-19
- fix: Fixed package description. 2021-12-22