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 cần á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",           // không có dấu '/' ở đầu: trình xem sẽ thêm vào ("/doconut" sẽ trở thành //doconut, một host khác)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Ánh xạ C# sang JavaScript

Không nên truyền một đối tượng ViewerConfig đã được tuần tự hoá trực tiếp vào docViewer(...). Hầu hết các khóa của widget sử dụng camelCase, trong khi ba khóa liên quan đến đường dẫn/kiểu vừa được định nghĩa bằng PascalCase.

Mặc định JavaScript

Widget có các mặc định cũ hơn khác với lớp C#. Các giá trị sau đây đến từ triển khai hiện tại của docViewer.js.

Đặt tất cả các giá trị quan trọng về hành vi thay vì dựa vào bất kỳ bộ mặc định nào:

<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 gọi lại

Giữ các hàm gọi lại nhanh; gửi dữ liệu telemetry một cách 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ũng chứa các trợ giúp nội bộ. Chỉ coi các phương thức được UI tham chiếu và được tài liệu ở đây hoặc trong 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ử của nó. Nó dùng cho việc tạo trang bất đồng bộ và thử lại phản hồi sẵn sàng 202 Accepted hiện tại cũng như tín hiệu 409 Conflict cũ hơn. Khi bật, widget sẽ thực hiện polling với các giá trị mặc định JavaScript sau:

Để nó tắt đối với trình xem bình thường. Bật nó không thể biến một việc 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 mà bạn thực sự ánh xạ.
• BasePath phải hướng tới nhánh đó, được viết mà không có dấu / ở đầu ('doconut', không phải '/doconut': trình xem sẽ thêm dấu gạch chéo, và //doconut/... là một yêu cầu tới máy chủ khác).
• DoconutOptions.ResourcesPath là đường dẫn tài nguyên nhúng.
• ResPath thường hướng tới thư mục con images của nó, cũng không có dấu / ở đầu ('doconut-res/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ì.