ViewerConfig

ViewerConfig (namespace Doconut) описує зовнішній вигляд та поведінку переглядача в браузері. Це не впливає на якість відображення документу; для цього використовуйте конфігурацію формату. Клас C# та довготривалий JavaScript‑віджет мають різні типові значення, тому явно зіставляйте параметри.

Дві зміни на боці клієнта в цьому випуску не повідомляються. Функції‑обробники передаються як параметри — віджет більше не формує глобальні імена функцій з id контейнера — і ResPath має вказувати на префікс ресурсів, а не на корінь застосунку. Обидва залишають сервер працювати бездоганно і нічого не виводять у консоль браузера. Якщо ви переносите сторінку з попередньої бібліотеки, прочитайте Зворотні виклики та Контрольний список шляхів перед усім іншим.

Властивості C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // без початкового '/': переглядач додає його ("/doconut" стало б //doconut, інший хост)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Відображення C# у JavaScript

Не передавайте безпосередньо серіалізований ViewerConfig у docViewer(...). Більшість ключів віджета записані у camelCase, тоді як три встановлені ключі шляху/масштабу — у PascalCase.

JavaScript за замовчуванням

Віджет має старіші значення за замовчуванням, які відрізняються від класу C#. Наступні значення беруться з поточної реалізації docViewer.js.

Встановіть усі поведінково важливі значення замість того, щоб покладатися на будь‑який набір значень за замовчуванням:

<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
const objViewer = $('#div_ctlDoc').docViewer({
    showThumbs: true,
    autoLoad: false,
    autoFocus: true,
    autoPageFocus: true,
    pageZoom: 100,
    zoomStep: 10,
    maxZoom: 300,
    FitType: 'width',
    cacheEnabled: false,
    largeDoc: false,
    showHyperlinks: true,
    fixedZoom: true,
    fixedZoomPercent: 100,
    fixedZoomPercentMobile: 75,
    BasePath: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Зворотні виклики

Тримайте зворотні виклики швидкими; надсилайте телеметрію асинхронно і не блокуйте рендеринг сторінки.

Кожен з цих параметрів є властивістю у об’єкті ініціалізації. Попередній переглядач шукав глобальні функції, імена яких формувалися з ідентифікатора контейнера — на сторінці з <div id="div_ctlDoc"> доводилося лише оголосити function ctlDoc_OnViewerReady(). Такий пошук більше не використовується. Передайте функції явно:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... ваші існуючі параметри ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // було знайдено за іменем
    onViewerReady:    ctlDoc_OnViewerReady,     // було знайдено за іменем
    onCopy:           ctlDoc_Copy,              // було ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // було ctlDoc_AutoLoadStatus(page)
});

Старий пошук був обгорнутий порожнім catch, тому жодних повідомлень не надходило. У цьому випуску функції просто не виконуються: типовий симптом — індикатор завантаження, який ніколи не зникає, оскільки обробник, що його приховував, був onViewerReady. Документ за цим індикатором відображається коректно.

Зворотного виклику для кліку по посиланню немає — обробка гіперпосилань вбудована і керується параметром showHyperlinks.

Групи публічних методів

JavaScript‑файл також містить внутрішні допоміжні функції. Стабільними точками інтеграції вважаються лише методи, які використовуються референтним інтерфейсом і задокументовані тут або у посібниках із функціоналу.

Повторити, доки розподілена сторінка ще рендериться

retryOn409 зберігає свою історичну назву. Він призначений для асинхронного створення сторінок і повторює поточну відповідь готовності 202 Accepted, а також старіший сигнал 409 Conflict. Коли ввімкнено, віджет опитує сервер із такими JavaScript‑за замовчуванням:

Залиште його вимкненим для звичайного одно‑вузлового переглядача. Увімкнення не може зробити непідтримуваний синхронний рендер асинхронним.

Увімкніть його, коли сторінки подаються зі спільного сховища з FirstPagePriority, де пізніші сторінки законно відповідають 202 Accepted, доки не будуть записані. Клієнт, який не повторює запити, показуватиме пошкоджені плитки для сторінок, що ще рендеряться — див. Розподілені розгортання.

Перевірка шляху

• DoconutOptions.MiddlewarePath має описувати гілку, яку ви фактично мапите.
• BasePath має вказувати цю гілку без початкового / ('doconut', а не '/doconut': переглядач додає слеш, і //doconut/... — це запит до іншого хоста). Референтний застосунок зберігає історичну форму запиту DocImage.axd на гілці MapWhen і тому встановлює BasePath: '/'.
• DoconutOptions.ResourcesPath — це маршрут вбудованих ресурсів.
• ResPath зазвичай вказує на підпапку images без початкового / — 'doconut-res/images' з префіксом за замовчуванням. Порожній ResPath був правильним у попередній бібліотеці, де ресурси бралися з кореня застосунку; тут це некоректно і призводить до помилки без повідомлення.
• ExtractHyperlinks має бути ввімкнено у конфігурації формату сервера, перш ніж showHyperlinks зможе щось відобразити.