Vitvov.Maui.PDFView 1.8.4

<img src="icon.png" width="32" /> Maui.PDFView

Library for display PDF files in .NET MAUI on Android, iOS, MacOS and Windows

https://github.com/vitalii-vov/Maui.PDFView/assets/71486507/4977ede8-c8db-454f-930d-ba2ec704f16d

 <br>

Installation

Install-Package Vitvov.Maui.PDFView

 <br>

Usage

Add .UseMauiPdfView() to MauiProgram

using Maui.PDFView;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UseMauiPdfView();   // <- Write this

        return builder.Build();
    }
}

 <br> Add PdfView to XAML

<ContentPage
    x:Class="Example.Business.UI.Pages.MainPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:pdf="clr-namespace:Maui.PDFView;assembly=Maui.PDFView">

    
    <pdf:PdfView
        IsHorizontal="{Binding IsHorizontal}"
        Uri="{Binding PdfSource}"
        MaxZoom="4"
        PageIndex="{Binding PageInex}"
        PageChangedCommand="{Binding PageChangedCommand}">
    </pdf:PdfView>

</ContentPage>

 <br> Set PdfSource in ViewModel

internal partial class MainPageViewModel : ObservableObject
{
    [ObservableProperty] private string? _pdfSource;

    [RelayCommand] private void ChangeUri()
    {
        try 
        {
            //  See the example project to understand how to work with paths.
            PdfSource = "/path/to/file.pdf";

            //  You can set the Uri property to null to clear the component.
            //PdfSource = null;
        }
        catch(Exception ex)
        {
             // handle exceptions
        }
    }
}

 <br>

Personalization

You can customize the way pages are displayed by modifying the PageAppearance property in the PdfView component.

<pdf:PdfView Uri="{Binding PdfSource}">

    
    <pdf:PdfView.PageAppearance>
        <pdf:PageAppearance 
            Margin="16,8" 
            ShadowEnabled="True"
            Crop="64,32"/>
    </pdf:PdfView.PageAppearance>

</pdf:PdfView>

 <br>

Helper classes implementing IPdfSource

The PdfView component works only with file paths. This is because the native platform components primarily operate with file paths, and handling different PDF data sources directly inside the component would significantly complicate the code.

Therefore, you must always provide a file path regardless of the form your PDF data takes—whether it’s a byte array, a stream, an asset, or a URL.

To simplify working with these data sources, the component includes helper classes that implement the IPdfSource interface:

• AssetPdfSource
• ByteArrayPdfSource
• FilePdfSource
• HttpPdfSource

Example of using PdfSource

[RelayCommand] private async Task UploadUri()
{      
    var source = new HttpPdfSource("https://www.adobe.com/support/products/enterprise/knowledgecenter/media/c4611_sample_explain.pdf");
    PdfSource = await source.GetFilePathAsync();
}

[RelayCommand] private async Task UploadAsset()
{
    var source = new AssetPdfSource("Example.Resources.PDF.pdf2.pdf");
    PdfSource = await source.GetFilePathAsync();
}

You can also create your own implementation of the IPdfSource interface to address your specific needs.