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

Ánh xạ C# sang JavaScript

Không truyền một ViewerConfig đã được tuần tự hoá trực tiếp vào docViewer(...). Hầu hết các khóa widget dùng dạng camelCase, trong khi ba khóa đường dẫn/điều chỉnh đã được thiết lập dùng dạng PascalCase.

Mặc định JavaScript

Widget có các mặc định cũ hơn so với lớp C#. Các giá trị sau được lấy 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 Callback

Giữ các callback 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 helper nội bộ. Chỉ coi các phương thức được UI tham chiếu sử dụng và được tài liệu hoá ở đâ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 sau HTTP 409

retryOn409 dùng cho việc tạo trang bất đồng bộ. Khi bật, widget sẽ thực hiện polling với các giá trị mặc định JavaScript sau:

Giữ nó tắt cho trình xem thông thường. Bật nó không thể làm cho một quá trình render đồng bộ không được hỗ trợ 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 trỏ tới nhánh đó, 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 trỏ 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 kỳ thứ gì.