Cấu hình Viewer

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 việc đó. Lớp C# và widget JavaScript lâu đời 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.

Hai thay đổi phía máy khách trong bản phát hành này bị lỗi im lặng. Các hàm xử lý được truyền dưới dạng tùy chọn — widget không còn suy ra tên hàm toàn cục từ id của container — và ResPath phải trỏ tới tiền tố tài nguyên thay vì gốc ứng dụng. Cả hai đều để máy chủ hoạt động hoàn hảo và không báo gì trong console của trình duyệt. Nếu bạn đang chuyển một trang từ thư viện trước, hãy đọc Callbacks và Path checklist trước bất kỳ thứ gì khác.

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 host 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 của widget sử dụng camelCase, trong khi ba khóa đường dẫn/điều chỉnh đã được thiết lập sử dụng PascalCase.

Mặc định JavaScript

Widget này 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.

Mỗi mục trong số này là một tùy chọn trong đối tượng khởi tạo. Trình xem trước đây tìm kiếm các hàm toàn cục dựa trên tên được suy ra từ id của container — một trang có <div id="div_ctlDoc"> chỉ cần khai báo function ctlDoc_OnViewerReady(). Việc tìm kiếm này đã bị loại bỏ. Hãy truyền hàm một cách rõ ràng:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... các tùy chọn hiện có của bạn ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // đã được tìm bằng tên
    onViewerReady:    ctlDoc_OnViewerReady,     // đã được tìm bằng tên
    onCopy:           ctlDoc_Copy,              // đã là ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // đã là ctlDoc_AutoLoadStatus(page)
});

Việc tìm kiếm cũ được bao bọc trong một catch rỗng, vì vậy không có gì được báo cáo. Trong phiên bản này các hàm đơn giản không bao giờ chạy: triệu chứng thường gặp là biểu tượng quay đang bận không bao giờ dừng, vì trình xử lý ẩn nó là onViewerReady. Tài liệu phía sau đang được render đúng cách.

Không có callback khi nhấp liên kết — việc xử lý siêu liên kết đã được tích hợp sẵn và được điều khiển bởi showHyperlinks.

Nhóm phương thức công cộng

Tệp JavaScript cũng chứa các trợ giúp nội bộ. Chỉ xem các phương thức được UI tham chiếu sử dụng 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 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 cũng như tín hiệu cũ 409 Conflict.
Khi được bật, widget sẽ thăm dò với các giá trị mặc định JavaScript sau:

Để nó tắt cho viewer đơn node bình thường. Bật nó không thể làm cho một render đồng bộ không được hỗ trợ trở thành bất đồng bộ.

Bật nó khi các trang được phục vụ từ lưu trữ chung với FirstPagePriority, nơi các trang sau hợp pháp trả về 202 Accepted cho đến khi chúng được ghi. Một client không
thử lại sẽ hiển thị các ô gạch vỡ cho các trang vẫn đang render — xem
Triển khai Phân tán.

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 nhắm tới nhánh đó, viết mà không có dấu / đầu ('doconut', không phải '/doconut': viewer 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). Ứng dụng tham chiếu giữ dạng yêu cầu lịch sử
  DocImage.axd trên một nhánh MapWhen và do đó đặt BasePath: '/'.
• DoconutOptions.ResourcesPath là tuyến đường tài nguyên nhúng.
• ResPath thường nhắm tới thư mục con images của nó, không có dấu / đầu — 'doconut-res/images' với
  tiền tố mặc định. Một ResPath rỗng đã đúng trong thư viện trước, nơi tài nguyên
  đến từ gốc ứng dụng; nó không đúng ở đây, và sẽ thất bại mà không có lỗi.
• 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ì.