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şiklik sessizce başarısız olur. seçenek olarak iletilir — widget artık konteyner kimliğinden global fonksiyon adları türetmez — ve ResPath kaynak önekine, uygulama köküne değil, işaret etmelidir. Her ikisi de sunucunun mükemmel çalışmasını sağlar ve tarayıcı konsolunda hiçbir şey raporlamaz. Eğer önceki kütüphaneden bir sayfayı taşıyorsanız, okuyun

Geri Çağrılar ve Yol Kontrol Listesi önce başka bir şey yapmadan önce.

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, başka bir sunucu olur)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

C#'tan JavaScript'e eşleme

Doğrudan serileştirilmiş bir ViewerConfig'ı docViewer(...)'a geçirmeyin. Çoğu widget anahtarı camelCase iken, üç yerleşik yol/fit anahtarı PascalCase'dir.

JavaScript varsayılanları

Widget, C# sınıfından farklı eski varsayıllara 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.

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

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... mevcut seçenekleriniz ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // adıyla bulundu
    onViewerReady:    ctlDoc_OnViewerReady,     // adıyla bulundu
    onCopy:           ctlDoc_Copy,              // idi ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // idi ctlDoc_AutoLoadStatus(page)
});

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ışmaz: yaygın semptom, hiç durmayan meşgul dönen göstergedir, çünkü onu gizleyen işleyici onViewerReady idi. Arkasındaki belge doğru şekilde renderlanıyor.

Bağlantı tıklama geri çağrısı yok — hiperlink işleme yerleşiktir ve showHyperlinks tarafından yönlendirilir.

Genel yöntem grupları

JavaScript dosyası ayrıca dahili yardımcılar da içerir. Yalnızca referans UI tarafından kullanılan ve burada ya da özellik kılavuzlarında belgelenen yöntemleri, kararlı entegrasyon noktaları olarak ele alın.

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ırlık yanıtını ve ayrıca eski 409 Conflict sinyalini yeniden dener. Etkinleştirildiğinde, widget bu JavaScript varsayılanlarıyla sorgular:

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.

FirstPagePriority ile paylaşımlı depolamadan sunulan sayfalar olduğunda bunu etkinleştirin; bu durumda sonraki sayfalar, yazılana kadar 202 Accepted yanıtını meşru olarak verir. Yeniden denemeyen bir istemci, hâlâ işlenen sayfalar için bozuk döşemeler gösterir — bkz. Dağıtılmış Dağıtımlar.

Yol kontrol listesi

• DoconutOptions.MiddlewarePath, gerçekte eşlediğiniz dalı tanımlamalıdır.
• BasePath, o dalı hedeflemelidir; başında / olmadan yazılmış olmalıdır ('doconut', '/doconut' değil: görüntüleyici eğik çizgiyi ekler ve //doconut/... başka bir ana bilgisayara istek demektir). Referans uygulama, tarihi DocImage.axd istek biçimini bir MapWhen dalında tutar ve bu nedenle BasePath: '/' ayarlar.
• DoconutOptions.ResourcesPath, gömülü kaynak yoludur.
• ResPath genellikle 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 kütüphanede 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.