Prohlížeč dokumentů může být technicky funkční a přesto se na úzké obrazovce cítit nepoužitelný. Husté nástrojové lišty, malé ovládací prvky, přemrštěné postranní panely a kontejnery s pevnými rozměry rychle promění jednoduchý náhled v frustrující zážitek.

Pro Windows‑based ASP.NET a .NET aplikace poskytuje Doconut vložený SDK pro prohlížení obchodních dokumentů, PDF souborů, CAD výkresů, e‑mailových souborů a obrázků. Vaše aplikace stále řídí okolní rozvržení, autentizaci, autorizaci, úložiště a workflow dokumentů.

Tento průvodce se zaměřuje na toto okolní prostředí: jak poskytnout vloženému prohlížeči dostatek místa, učinit ovládací prvky aplikace pohodlnými k použití, zvládat změny orientace a testovat realistické dokumenty bez spoléhaní se na neověřený zdrojový kód SDK.

Responzivní rozvržení prohlížení dokumentů připojené k .NET serverové komponentě

Responzivní design začíná mimo prohlížeč

Prohlížeč může využívat jen prostor, který mu poskytne nadřazené rozvržení. Pokud aplikace umístí prohlížeč do úzké karty, nastaví mu pevnou šířku pro desktop nebo jej obklopí několika trvalými panely, oblast dokumentu zůstane stísněná.

Začněte třemi otázkami:

Jaký je hlavní úkol na této stránce?
Které ovládací prvky aplikace musí zůstat viditelné během čtení?
Které sekundární panely lze sbalit nebo skrýt za tlačítko?

Pro dedikovanou stránku s dokumentem by měl být prohlížeč obvykle dominantním prvkem. Metadata, komentáře, schválení a workflow akce mohou zůstat dostupné, aniž by trvale zabíraly místo dokumentu.

Plánujte rozvržení podle dostupného prostoru

Responzivní chování by mělo vycházet z prostoru, který je komponentě k dispozici, nikoli z předpokladů o konkrétním názvu zařízení.

Široké rozvržení

Na širokém viewportu může stránka zobrazovat:

Náhledový panel nebo navigační panel dokumentů
Hlavní plátno dokumentu
Sekundární workflow panel pro komentáře nebo metadata
Kompletní sadu akcí aplikace

Když se sekundární panel změní na zásuvku, přidejte chování dialogu, správu zaměření a přístupné popisky požadované vaším designovým systémem.

Udělejte ovládací prvky aplikace dotykově přívětivé

Ovládací prvky kolem prohlížeče by měly být pohodlné k aktivaci bez přesného pohybu ukazatele.

Praktické pokyny zahrnují:

Dejte interaktivním prvkům cílovou oblast přibližně 44 × 44 CSS pixelů.
Nechte dostatek prostoru mezi destruktivními a často používanými akcemi.
Nespoléhejte se na hover pro odhalení podstatných informací.
Udržujte indikátory zaměření viditelné pro uživatele klávesnice.
Poskytněte přístupná jména pro tlačítka obsahující jen ikonu.
Vyhněte se umístění kritických ovládacích prvků blízko oblastí gest prohlížeče nebo systému.

Nepřepisujte interní styly Doconut pomocí hádaných selektorů nebo nedokumentovaných CSS proměnných. Používejte oficiální zdroje pro nainstalovanou verzi SDK a aplikujte své responzivní pravidla na kontejnery a ovládací prvky vlastněné aplikací.

Považujte postranní panely za volitelný pracovní prostor

Náhledy, výsledky vyhledávání, anotace, metadata a historie workflow jsou cenné, ale neměly by všechny najednou soupeřit s dokumentem.

Na kompaktních rozvrženích:

Otevřete postranní panel jen na požádání uživatele.
Po zavření vraťte zaměření na tlačítko, které panel otevřelo.
Zachyťte zaměření uvnitř modálních panelů, kde je to vhodné.
Dejte panelu jasný název a akci zavření.
Zachovejte aktuální pozici v dokumentu při otevření nebo zavření panelu.

Pokud prohlížeč poskytuje vlastní panely, otestujte jejich dokumentované responzivní chování, než přidáte druhý navigační systém na úrovni aplikace.

Udržujte pracovní prostor dokumentu rychlý

Responzivní design není jen vizuální. Velké dokumenty mohou odhalovat omezení paměti, šířky pásma a renderování, zejména když stránka zároveň obsahuje složité dashboardy nebo animace.

Snižte konkurenční práci

Pozastavte dekorativní animace během čtení, vyhněte se nákladným efektům kolem prohlížeče a odstraňte zbytečné pozorovatele nebo posluchače událostí.

Rezervujte prostor rozvržení

Dejte hostiteli prohlížeče stabilní výšku před načtením. To zabraňuje velkým posunům rozvržení a snižuje šanci, že uživatel omylem klepne na špatný prvek.

Načítejte sekundární funkce úmyslně

Komentáře, auditní historie a velké metadata panely nemusí být načteny spolu s první stránkou dokumentu. Odložte jejich načtení, dokud uživatel neotevře související panel, pokud to odpovídá vašemu workflow.

Testujte reprezentativní soubory

Používejte dlouhé PDF, široké tabulky, detailní CAD výkresy, velké obrázky a dokumenty s neobvyklými fonty. Malý ukázkový soubor nedokáže odhalit limity produkčního zážitku.

Udržujte řízení přístupu na serveru

Responzivní prezentace nemění bezpečnostní odpovědnosti aplikace. Každý požadavek na dokument by měl stále procházet autentizací a specifickou autorizací dokumentu.

Pro ASP.NET Core aplikace lze použít standardní mechanismy jako autentizační middleware, politiky, claimy, atribut [Authorize] a autorizaci založenou na zdrojích k ochraně serverové cesty, která dokument poskytuje.

Aplikace by měla:

Používat serverově generované identifikátory dokumentů.
Ověřit, že aktuální uživatel může přistupovat k požadovanému dokumentu.
Uchovávat přihlašovací údaje úložiště a neomezené cesty mimo klienta.
Očistit chyby zobrazované na stránce prohlížeče.
Použít explicitní pravidla uchovávání pro originální a dočasné soubory.
Vyhnout se logování obsahu dokumentů, tajemství nebo citlivých URL přístupu.

Skrytí akcí pro stažení, tisk nebo kontextové menu může podpořit zamýšlený workflow, ale nenahrazuje server‑side autorizaci a nemůže zabránit všem formám zachycení po zobrazení obsahu.

Integrace Doconut do responzivního zážitku

Doconut poskytuje vrstvu vloženého prohlížení dokumentů, zatímco aplikace dodává responzivní obal a obchodní workflow.

Rozumné pořadí implementace je:

Potvrďte požadované formáty a funkce prohlížeče.
Integraujte podporovaný balíček Doconut pro vaši .NET aplikaci.
Ochraňte rozlišení dokumentu server‑side autorizací.
Umístěte prohlížeč do fluidního, aplikací vlastněného hostitelského kontejneru.
Navrhněte kompaktní stavy pro nástrojové lišty aplikace a sekundární panely.
Testujte změny velikosti, orientaci, zaměření, načítání a chování při chybách.
Ověřte výsledek pomocí dokumentů podobných produkčnímu prostředí a souběžných relací.

Pro aktuální informace o produktu navštivte produktovou stránku Doconut Viewer. Pro instalaci a integraci podle verze použijte oficiální stránku ke stažení a dokumentaci místo kopírování nedokumentovaných SDK příkladů z třetích stran.

Kontrolní seznam prohlížeče v responzivním režimu

Rozvržení

Prohlížeč získává největší užitečný podíl stránky.
Pevné šířky nevyvolávají horizontální posouvání.
Sekundární panely se čistě sbalí.
Rozvržení zůstává použitelné, když je výška viewportu omezená.
Stavy načítání a chyb rezervují odpovídající místo.

Interakce

Ovládací prvky aplikace mají pohodlné cílové rozměry.
Základní akce nezávisí na hoveru.
Ovládací prvky jen s ikonou mají přístupná jména.
Zaměření zůstává viditelné a následuje logické pořadí.
Zásuvky a dialogy vracejí zaměření správně.

Dokumenty

Velké PDF zůstávají navigovatelné.
Široké tabulky lze prohlížet bez rozbití rozvržení stránky.
Detailní výkresy zachovávají použitelné zoom a posun.
Dlouhé názvy souborů a chybové zprávy nepřetečou.
Změna velikosti rozvržení neobnovuje dokument zbytečně.

Bezpečnost a provoz

Server autorizuje každý požadavek na dokument.
Detaily úložiště zůstávají soukromé.
Uchovávání souborů a dočasných dat je zdokumentováno.
Chyby a logy neobsahují citlivé informace.
Limity zdrojů a chování při souběžných relacích jsou otestovány.

Časté otázky

Měla by aplikace udržovat samostatné stránky pro prohlížeč na telefonech a desktopech?

Obvykle ne. Jedna responzivní stránka je snazší na údržbu. Rozvržení se mění podle dostupného prostoru a postupně odhaluje sekundární ovládací prvky.

Může aplikace přepsat interní CSS prohlížeče?

Vyhněte se nedokumentovaným selektorům a proměnným. Stylujte hostitelský kontejner a vlastní ovládací prvky aplikace. Používejte jen přizpůsobovací body dokumentované pro verzi Doconut, kterou nasazujete.

Měly by být tlačítka pro stažení a tisk skryta v kompaktních rozvrženích?

Jedná se o rozhodnutí produktu, nikoli o bezpečnostní hranici. Pokud je akce povolena, ale nepasuje, umístěte ji do přístupného přetékacího menu. Pokud není povolena, vynutěte tuto politiku na serveru.

Jak by měly být testovány velké dokumenty?

Vytvořte sanitizovanou testovací kolekci, která odráží skutečný počet stránek, velikosti souborů, fonty, výkresy a tabulky. Opakujte sadu testů po změnách SDK, .NET, Windows Server nebo rozvržení.

Závěr

Silný mobilní zážitek z dokumentu začíná fluidním kontejnerem, rozvržením zaměřeným na dokument, pohodlnými ovládacími prvky, volitelnými postranními panely, předvídatelným chováním při změně velikosti a server‑side autorizací.

Doconut může poskytnout schopnost prohlížení uvnitř vaší Windows‑based .NET aplikace. Váš tým se pak může soustředit na responzivní obal aplikace, bezpečnostní pravidla a workflow, které učiní prohlížeč přirozenou součástí produktu.