ViewerConfig

ViewerConfig (namespace Doconut) mô tả giao diện và hành vi của trình xem trong trình duyệt. Nó không ảnh hưởng đến chất lượng hiển thị tài liệu; hãy sử dụng cấu hình định dạng cho mục đích đó. Lớp C# và widget JavaScript lâu đời có các giá trị mặc định khác nhau, vì vậy hãy ánh xạ các giá trị một cách rõ ràng.

Thuộc tính C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/doconut",
    ResPath = "/doconut-res/images",
    ShowHyperlinks = true
};

Ánh xạ C# sang JavaScript

Mặc định JavaScript

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

Các hàm callback

Giữ các callback ngắn gọn; gửi telemetry bất đồng bộ và không chặn việc render trang.

Các nhóm phương thức công khai

Tệp JavaScript còn chứa các hàm trợ giúp nội bộ. Chỉ coi các phương thức được tham chiếu trong UI tài liệu và các hướng dẫn tính năng là các điểm tích hợp ổn định.

Thử lại khi một trang phân tán vẫn đang được render

retryOn409 giữ nguyên tên lịch sử. Nó dùng cho việc sản xuất trang bất đồng bộ và sẽ thử lại phản hồi sẵn sàng 202 Accepted cũng như tín hiệu cũ 409 Conflict. Khi bật, widget sẽ thăm dò với các mặc định JavaScript sau:

Để nó tắt cho trình xem bình thường. Bật tính năng này không thể biến một render đồng bộ không được hỗ trợ thành bất đồng bộ.

Danh sách kiểm tra đường dẫn

• DoconutOptions.MiddlewarePath phải mô tả nhánh bạn thực sự ánh xạ.
• BasePath phải trỏ tới nhánh đó.
• DoconutOptions.ResourcesPath là đường dẫn tài nguyên nhúng.
• ResPath thường trỏ tới thư mục con /images.
• ExtractHyperlinks phải được bật trong cấu hình định dạng máy chủ trước khi showHyperlinks có thể hiển thị bất cứ thứ gì.