یکپارچه‌سازی نمایش بی‌وقفه اسناد در برنامه‌های Blazor شما با Doconut

Blazor توسعه وب .NET را متحول کرده است و با استفاده از C# امکان ساخت رابط‌های کاربری غنی و تعاملی را هم در سمت سرور و هم در سمت کلاینت (WebAssembly) فراهم می‌کند. هنگام ساخت برنامه‌های پیشرفته Blazor، اغلب نیاز به نمایش اسناد – گزارش‌ها، بارگذاری‌های کاربر، مطالب مرجع – مستقیم در رابط کاربری پیش می‌آید. تکیه بر لینک‌های دانلود حس صفحه‌ تک‌صفحه‌ای روانی که Blazor به خوبی ارائه می‌دهد را مختل می‌کند.

در همین جا است که Doconut وارد می‌شود — یک نمایشگر سند کاملاً مدیریت‌شده و فوق‌العاده سریع که مخصوص توسعه‌دهندگان .NET ساخته شده است. چه از Blazor Server و چه از WebAssembly استفاده کنید، Doconut کاربران شما را درگیر می‌کند و اسناد را به‌صورت ایمن در داخل برنامه‌تان نگه می‌دارد.

🧠 چرا از Doconut در Blazor استفاده کنیم؟

• حفظ جریان SPA: Doconut اسناد را مستقیماً در صفحات شما رندر می‌کند. بدون تب‌های جدید، بدون مشاهده‌کننده‌های خارجی.
• بومی برای .NET: برای یکپارچه‌سازی بی‌وقفه در ASP.NET Core و Blazor طراحی شده است. یک استک یکسان.
• پشتیبانی از چندین فرمت: امکان مشاهده PDF، DOCX، XLSX، PPTX، HTML، تصاویر، ایمیل‌ها و حتی CAD — بدون نیاز به پلاگین‌های شخص ثالث.
• رابط کاربری واکنش‌گرا: تجربه مشاهده‌ی مناسب برای موبایل که با ظاهر و حس برنامه شما سازگار است.

می‌توانید دربارهٔ انواع فایل‌های پشتیبانی‌شده بیشتر در doconut.com بیاموزید.

🧩 نحوه یکپارچه‌سازی Doconut در Blazor

چه در حال ساخت برنامهٔ Blazor Server باشید و چه WebAssembly، Doconut تجربه‌ای سازگار با .NET Standard ارائه می‌دهد که اطمینان می‌دهد بر روی هر دو پلتفرم به‌خوبی کار می‌کند.

چطور: نصب و استفاده از Doconut از NuGet.org

یکپارچه‌سازی Doconut در پروژهٔ .NET شما آسان است به‌دلیل در دسترس بودن آن در NuGet.org.

۱. یافتن بسته در NuGet

به پروفایل رسمی Doconut مراجعه کنید: 👉 https://www.nuget.org/profiles/doconut.com

در آنجا بسته‌های موجود را خواهید یافت.

۲. نصب از طریق کنسول NuGet یا CLI

در Visual Studio یا با استفاده از .NET CLI، بسته اصلی را نصب کنید.

Install-Package Doconut.Blazor

یا

dotnet add package Doconut.Blazor

۳. افزودن سرویس‌ها به DI

در برنامهٔ Blazor Server یا WebAssembly، سرویس‌های Doconut را به‌صورت زیر به محل تزریق وابستگی (DI) اضافه کنید:

// Program.cs
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDoconutViewer();   // ثبت سرویس‌های مورد نیاز

۴. استفاده از کامپوننت OnlineDocumentViewer

در هر صفحهٔ Razor می‌توانید این کامپوننت را برای نمایش اسناد به کار ببرید:

@page "/viewdoc"
@using Doconut.Blazor

<OnlineDocumentViewer
    Source="https://example.com/files/report.pdf"
    Height="800px"
    Toolbar="true"
    Download="true" />

توضیح پارامترها

پارامتر	توضیح
Source	آدرس فایل (PDF, DOCX, …) که باید نمایش داده شود
Height	ارتفاع کامپوننت (مثلاً 800px یا 100%)
Toolbar	نمایش یا عدم نمایش نوار ابزار (true/false)
Download	امکان دانلود فایل توسط کاربر (true/false)
Print	امکان چاپ سند (true/false)

۵. پیکربندی پیشرفته

می‌توانید گزینه‌های پیش‌فرض را در appsettings.json یا به‌صورت برنامه‌نویسی تنظیم کنید:

builder.Services.Configure<DoconutViewerOptions>(options =>
{
    options.DefaultToolbar = true;
    options.EnablePrint = true;
    options.Theme = "dark";
});

۶. نمونه کامل

Program.cs

using Doconut.Blazor;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();
builder.Services.AddDoconutViewer();   // ثبت سرویس‌های Doconut

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

Pages/DocumentViewer.razor

@page "/documents"
@using Doconut.Blazor

<h3>نمایش سند</h3>

<OnlineDocumentViewer
    Source="files/sample.docx"
    Height="700px"
    Toolbar="true"
    Download="true"
    Print="true" />

۷. نتیجه‌گیری

با افزودن Doconut به برنامهٔ Blazor خود، می‌توانید اسناد را به‌صورت بومی و بدون خروج از SPA نمایش دهید، تجربهٔ کاربری بهتری فراهم کنید و نیازی به استفاده از ویورهای خارجی نداشته باشید. این یک راه‌حل کامل، سریع و کاملاً یکپارچه برای نمایش انواع فایل‌ها در برنامه‌های .NET شماست.