Prohlížeč dokumentů může být technicky funkční a přesto se na úzké obrazovce zdát nepoužitelný. Husté panely nástrojů, drobné 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 aplikace založené na Windows, ASP.NET a .NET 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 soustředí na právě 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žívání, zvládat změny orientace a testovat realistické dokumenty bez spoléhaní se na neověřený zdrojový kód SDK.

Responsivní rozvržení prohlížení dokumentů napojené na serverovou komponentu .NET

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

Prohlížeč může využívat jen prostor, který mu poskytne rodičovské rozvržení. Pokud aplikace umístí prohlížeč do úzké karty, nastaví mu pevnou šířku pro desktop nebo ho obklopí několika trvale viditelný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 v dokumentu.

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

Responsivní 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 dokumentu
Hlavní plátno dokumentu
Sekundární workflow panel pro komentáře nebo metadata
Úplnou 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 umisťová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é responsivní 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ý nadpis 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é responsivní chování, než přidáte druhý navigační systém na úrovni aplikace.

Udržujte pracovní prostor dokumentu rychlý

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

Snižte konkurenční zátěž

Pozastavte dekorativní animace, když uživatel čte, vyhněte se nákladným efektům kolem prohlížeče a odstraňte zbytečné pozorovatele či posluchače událostí.

Rezervujte prostor v rozvržení

Dejte hostiteli prohlížeče stabilní výšku ještě před načtením. Tím se zabrání velkým posunům rozvržení a sníží se šance, že uživatel omylem klepne na špatný prvek.

Načítejte sekundární funkce záměrně

Komentáře, historie auditu a rozsáhlé metadata nemusí být načteny spolu s první stránkou dokumentu. Odložte je, 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 prostředí.

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

Responsivní 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 aplikace ASP.NET Core lze použít standardní mechanismy jako autentizační middleware, politiky, nároky, atribut [Authorize] a autorizaci založenou na zdrojích k ochraně serverové cesty, která vrací dokument.

Aplikace by měla:

Používat serverově generované identifikátory dokumentů.
Ověřit, že aktuální uživatel má přístup k požadovanému dokumentu.
Uchovávat přihlašovací údaje k úložišti 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ů, tajných klíčů či 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 responsivního zážitku

Doconut poskytuje vrstvu vloženého prohlížení dokumentů, zatímco aplikace dodává responsivní skořápku a obchodní workflow.

Rozumné pořadí implementace je:

Potvrďte požadované formáty a funkce prohlížeče.
Integrajte podporovaný balíček Doconut pro vaši .NET aplikaci.
Chraň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 panely nástrojů 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 Produktová stránka Doconut Viewer. Pro instalaci a integraci podle konkrétní 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.

Checklist responsivního prohlížeče

Rozvržení

Prohlížeč získává největší užitečný podíl stránky.
Pevné šířky nevedou k horizontálnímu 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í prostor.

Interakce

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

Dokumenty

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

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.

Často kladené otázky

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

Obvykle ne. Jedna responsivní 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 zdokumentované 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 produktové rozhodnutí, nikoli o bezpečnostní hranici. Pokud je akce povolena, ale nepasuje do rozvržení, umístěte ji do přístupného přetékacího menu. Pokud není povolena, vynutí se to 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 Serveru 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 responsivní shell aplikace, bezpečnostní pravidla a workflow, které učiní prohlížeč přirozenou součástí produktu.