Blazor vous fournit un modèle de composants et une boucle de rendu qui ne se soucie guère du JavaScript tiers. Doconut fonctionne avec cela plutôt que contre : le rendu se fait côté serveur dans votre propre processus, et le widget s'installe dans un élément simple que vous contrôlez via le cycle de vie normal de l'interop.
Le problème
L'itinéraire côté client implique d'envoyer un moteur de rendu dans le navigateur. Dans Blazor WebAssembly, cela impacte directement la taille du téléchargement, et il ne couvre que le PDF — dès que quelqu'un téléverse un DOCX ou un XLSX, vous revenez à la case départ.
L'itinéraire iframe-vers-Office signifie que vos documents passent par l'infrastructure de quelqu'un d'autre, ce qui implique une discussion avec votre équipe de sécurité que vous ne voudriez probablement pas avoir deux fois.
Doconut prend la troisième voie. Le fichier est rasterisé en images de pages par votre propre serveur, et Blazor n'a qu'à héberger un div. Votre arbre de composants ne re-render jamais une visionneuse qu'il ne possède pas, et le moteur de diff n'a rien avec quoi se battre.
Capacités
Le rendu se fait côté serveur dans les deux cas. En Server, l'appel est direct ; en WebAssembly, vous exposez l'appel d'ouverture comme un point d'API minimal et transmettez le jeton retourné au widget. Les deux ne nécessitent que quelques lignes.
Initialisez le widget une fois, après le premier rendu, via le hook d'interop JS standard. Comme Blazor ne possède jamais le DOM interne du visionneur, les rendus ultérieurs le laissent intact.
Interactive Server, Interactive WebAssembly ou Auto. Le visionneur est piloté par un jeton opaque plutôt que par l'état du composant, ainsi changer le mode de rendu ne modifie pas l'intégration.
Le même composant ouvre PDF, DOCX, XLSX, PPTX, DWG, MSG et le reste du catalogue. Vous écrivez une page visionneur, pas une par famille de fichiers.
L'interface de navigation est fournie avec le widget. Vous configurez un visionneur, pas en construisez un à partir d'un canvas et d'un champ de numéro de page.
Rien n'est diffusé vers le navigateur sauf les images de pages rendues, ce qui compte davantage en WebAssembly que ce que l'on pense — le client est, après tout, entièrement inspectable.
Intégration
doconutHost.mount est quelques lignes de votre propre JavaScript qui appelle $('#div_ctlDoc').docViewer({ ... }) puis .View(token). Le garder en dehors de Blazor est délibéré — le DOM du widget ne doit pas être quelque chose que le moteur de rendu tente de concilier.
Plateformes prises en charge
// Program.cs — order matters
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession();
app.UseSession(); // before UseDoconut()
app.UseDoconutResources(); // before UseDoconut()
app.UseDoconut();
// Viewer.razor — open server-side, hand the token to the widget
@inject Doconut.Viewer Viewer
@inject IJSRuntime JS
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
@code {
protected override async Task OnAfterRenderAsync(bool firstRender)
{
if (!firstRender) return;
// Authorize first — the viewer renders whatever you hand it.
string token = await Viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
await JS.InvokeVoidAsync("doconutHost.mount", token);
}
}Détails
Les deux. Le rendu se fait toujours côté serveur, donc en WebAssembly vous ajoutez un point d'accès qui appelle OpenDocumentAsync et renvoie le jeton. Le client ne parse jamais un document, ce qui explique exactement pourquoi la charge WASM reste inchangée.
Non, à condition que vous montiez dans un élément que Blazor considère comme une feuille. Rendre un div vide et laisser le widget le remplir via l'interop — le moteur de diff n'a aucun enfant à concilier.
Non. Une page gère tout le catalogue. Le format est détecté à partir du document que vous ouvrez, pas sélectionné à l'avance par vous.
ASP.NET Core
S’enregistre comme DI ordinaire plus middleware. Hérite de l’authentification, de la journalisation et de l’hébergement que vous avez déjà.
ASP.NET CoreRendu PDF côté serveur en images de pages — l'utilisateur lit le document sans jamais recevoir le fichier.
PDFUne licence temporaire prend quelques minutes à demander et s'exécute entièrement sur votre propre machine. Les fichiers qui comptent sont ceux qui posent déjà problème à votre visionneuse actuelle.