Tất cả ví dụ trong tập tài liệu về API Trình xem được nhúng đều có trong danh sách bên dưới để bạn tham khảo nhanh. Ngoài ra, một số bản minh hoạ khác cũng được đưa vào để minh hoạ các khái niệm nâng cao.
Ví dụ từ Hướng dẫn dành cho nhà phát triển
Những ví dụ cơ bản này xuất hiện trong Hướng dẫn dành cho nhà phát triển và bao gồm các cách sử dụng phổ biến nhất của API Trình xem được nhúng.
- book-simple
Ví dụ: "Hello, World" của API Trình xem được nhúng, ví dụ này cho biết cách tải API và thu hút người xem bằng một cuốn sách cụ thể. - book-language
Ví dụ này cho biết cách thay đổi ngôn ngữ giao diện của người xem, trong trường hợp này là tiếng Bồ Đào Nha (Brazil). - book-notfound
Hướng dẫn này cho biết cách thêm hàm callback được gọi khi người xem không thể tải cuốn sách đã chỉ định. Bạn có thể xây dựng dựa trên ví dụ này để xử lý linh hoạt các điều kiện đó. - book-success
Hướng dẫn này cho biết cách thêm hàm callback được gọi khi người xem đã khởi chạy thành công một cuốn sách và sẵn sàng để sử dụng một cách có lập trình. - book-animate
Để minh hoạ cách người dùng có thể kiểm soát theo phương thức lập trình bằng JavaScript, bản xem trước sẽ tự động chuyển sang trang tiếp theo sau mỗi 3 giây.
Khả năng kiểm soát có lập trình đối với người xem
Trình xem cho phép bạn thực hiện mã với hầu hết mọi việc người dùng có thể làm bằng cách tương tác với người xem. Các ví dụ bên dưới cho thấy lợi ích của tính năng này.
- book-interactions-controls
Ví dụ về cách hoạt động này liệt kê tất cả các phương thức tương tác mà người xem hỗ trợ, bao gồm các chức năng thu phóng, nextPage, goToPage và đánh dấu. - book-interactions-openatpage
Hướng dẫn cách tự động mở trình xem sách trên một trang cụ thể bằng cách sử dụng các lệnh gọi lại và hàm goToPage.
Kết hợp với API sách và liên kết động
Khi xây dựng ứng dụng nâng cao, bạn có thể thấy hữu ích khi kết hợp API trình xem được nhúng với tính năng API Sách hoặc Đường liên kết động. Ví dụ: bạn nên biết trước xem liệu có sẵn một bản xem trước cụ thể cho tính năng nhúng hay không (ví dụ: để xác định xem có cung cấp cho người dùng tuỳ chọn mở cửa sổ xem trước trên trang web hay không). Hoặc bạn có thể chưa biết giá trị nhận dạng cho một cuốn sách cụ thể và muốn "tìm kiếm" cuốn sách đó bằng API Sách. Ví dụ dưới đây cho thấy cách thực hiện các thao tác này.
- book-dynamiclinks-zippy
Ở đây, chúng tôi sẽ kiểm tra xem một cuốn sách có sẵn để nhúng hay không. Nếu và chỉ khi có sẵn, chúng tôi sẽ hiển thị "bản xem trước" mà khi nhấp vào sẽ hiển thị nội dung xem trước của sách cùng dòng. - booksapi-titlesearch
Ví dụ này cho phép bạn mở trình xem được nhúng bằng cách chỉ cần nhập truy vấn tìm kiếm cho một cuốn sách. Thao tác này sẽ tự động hiển thị kết quả có thể nhúng đầu tiên cho truy vấn mà bạn nhập. Thao tác này sẽ sử dụng định dạng đầu ra JSON của API Dữ liệu để truy cập kết quả tìm kiếm.