ViewerConfig

ViewerConfig (namespace Doconut) tarayıcı görüntüleyicisinin görünüm ve davranışını tanımlar. Belge render kalitesini etkilemez; bunun için bir format yapılandırması kullanın. C# sınıfı ve uzun süredir var olan JavaScript widget farklı varsayılanlara sahiptir, bu yüzden değerleri açıkça eşleyin.

Bu sürümde iki istemci tarafı değişikliği sessizce başarısız olur. İşleyici fonksiyonları seçenek olarak geçirilir — widget artık konteyner kimliğinden global fonksiyon adları türetmez — ve ResPath uygulama kökü yerine kaynak önekine işaret etmelidir. İkisi de sunucunun sorunsuz çalışmasını sağlar ve tarayıcı konsolunda hiçbir şey raporlamaz. Önceki kütüphaneden bir sayfayı taşıyorsanız, her şeyden önce Geri Çağrılar ve Yol kontrol listesi bölümlerini okuyun.

C# özellikleri

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // başında '/' yok: görüntüleyici ekler ("/doconut" //doconut olur, başka bir host)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

C#'den JavaScript'e eşleme

JavaScript varsayılanları

Widget, C# sınıfından farklı eski varsayılanlara sahiptir. Aşağıdaki değerler mevcut docViewer.js uygulamasından gelmektedir.

Davranışsal olarak önemli tüm değerleri ayarlayın, varsayılanlardan birine güvenmek yerine:

<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>

Geri Çağrılar

Geri çağrıları hızlı tutun; telemetrileri asenkron gönderin ve sayfa renderını engellemeyin.

Bunların her biri init nesnesindeki bir seçenektir. Önceki görüntüleyici, adını kapsayıcı kimliğinden türeten global fonksiyonları arıyordu — <div id="div_ctlDoc"> içeren bir sayfa sadece function ctlDoc_OnViewerReady() tanımlamalıydı. Bu arama artık yok. Fonksiyonu açıkça geçirin:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... mevcut seçenekleriniz ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // isimle bulunmuştu
    onViewerReady:    ctlDoc_OnViewerReady,     // isimle bulunmuştu
    onCopy:           ctlDoc_Copy,              // ctlDoc_Copy(text) idi
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // ctlDoc_AutoLoadStatus(page) idi
});

Eski arama boş bir catch içinde sarılmıştı, bu yüzden hiçbir şey raporlanmadı. Bu sürümde fonksiyonlar basitçe hiç çalışmıyor: yaygın belirti, onViewerReady tarafından gizlenen işleyici olduğu için asla durmayan bir meşgul döndürme göstergesidir. Ardındaki belge doğru şekilde renderlanıyor.

Bağlantı tıklama geri çağrısı yoktur — hiperlink işleme dahili olarak bulunur ve showHyperlinks tarafından yönlendirilir.

Genel yöntem grupları

JavaScript dosyası ayrıca dahili yardımcılar içerir. Yalnızca referans UI tarafından kullanılan ve burada ya da özellik kılavuzlarında belgelenen yöntemleri kararlı bütünleşme noktaları olarak değerlendirin.

Dağıtılmış bir sayfa hâlâ işlenirken yeniden deneme

retryOn409 tarihsel adını korur. Asenkron sayfa üretimi içindir ve mevcut 202 Accepted hazır olma yanıtını ve eski 409 Conflict sinyalini yeniden dener. Etkinleştirildiğinde, widget aşağıdaki JavaScript varsayılanlarıyla periyodik istek yapar:

Normal tek düğüm görüntüleyici için devre dışı bırakın. Etkinleştirmek, desteklenmeyen senkron bir renderı asenkron hâle getiremez.

Sayfalar FirstPagePriority ile paylaşımlı depolamadan sunulduğunda, daha sonraki sayfalar 202 Accepted yanıtını yazılana kadar geçerli bir şekilde verir; bu durumda etkinleştirin. Yeniden denemeyen bir istemci, hâlâ işlenen sayfalar için kırık döşemeler gösterir — bkz. Dağıtık Dağıtımlar.

Yol kontrol listesi

• DoconutOptions.MiddlewarePath gerçekten eşlediğiniz dalı tanımlamalıdır.
• BasePath o dalı hedeflemeli, başında / olmadan yazılmalıdır ('doconut', '/doconut' değil: görüntüleyici eğik çizgiyi ekler ve //doconut/... başka bir ana bilgisayara istek olur). Referans uygulama, MapWhen dalında tarihsel DocImage.axd istek biçimini korur ve bu nedenle BasePath: '/' ayarlar.
• DoconutOptions.ResourcesPath gömülü kaynak yoludur.
• ResPath normalde images alt klasörünü hedefler, başında / olmadan — varsayılan önekle 'doconut-res/images'. Boş bir ResPath, kaynakların uygulama kökünden geldiği önceki kitaplıkta doğruydu; burada doğru değildir ve hata vermeden başarısız olur.
• ExtractHyperlinks, showHyperlinks bir şey görüntüleyebilmeden önce sunucu format yapılandırmasında etkinleştirilmelidir.