Thiệp

Tiện ích bổ sung dựa trên thẻ xuất hiện dưới dạng một ngăn trong thanh bên (hoặc trên thiết bị di động, dưới dạng một cửa sổ hoạt động khác thông qua trình đơn). Tiện ích bổ sung có thanh công cụ ở trên cùng giúp xác định tiện ích bổ sung và hiển thị một thẻ – về cơ bản là một "trang" trên giao diện người dùng của tiện ích bổ sung. Apps Script biểu thị các thẻ trong mã dự án bằng cách sử dụng đối tượng Card.

Cấu trúc thẻ

Thẻ tiện ích bổ sung mẫu

Thẻ là một nhóm các thành phần trên giao diện người dùng do bạn thiết kế. Thẻ bao gồm các phần sau:

  • Tiêu đề thẻ. Thao tác này sẽ xác định các thẻ. Tệp này có văn bản tiêu đề và có thể có tiêu đề phụ cũng như biểu tượng (không bắt buộc).
  • Một hoặc nhiều phần của thẻ. Đây là các phân mục con của khu vực giao diện người dùng của thẻ. Một phần có thể có tiêu đề của phần văn bản (không bắt buộc). Các phần thẻ được tách biệt với nhau trên thẻ bằng một quy tắc ngang. Nếu một phần thẻ đặc biệt lớn, phần đó sẽ tự động hiển thị dưới dạng một phần có thể thu gọn mà người dùng có thể mở rộng hoặc thu gọn khi cần. Một thẻ có thể có không quá 100 phần và chỉ nên có một vài phần để đạt được hiệu suất tốt hơn.

  • Mỗi phần thẻ chứa một hoặc nhiều tiện ích trên giao diện người dùng. Tiện ích cung cấp cho người dùng thông tin hoặc các chế độ điều khiển tương tác. Thẻ và phần thẻ là các tiện ích cấu trúc, vì vậy, bạn không thể thêm các tiện ích đó vào phần thẻ. Phần thẻ có thể có không quá 100 tiện ích và phải càng đơn giản càng tốt để đạt được hiệu suất tốt nhất.

Bạn nên thiết kế thẻ xoay quanh các hoạt động cụ thể của người dùng hoặc các tập dữ liệu. Ví dụ: Một tiện ích bổ sung của Google Workspace hiển thị dữ liệu lấy từ Google Trang tính có thể có một thẻ riêng cho mỗi trang tính mà tiện ích này lấy dữ liệu.

Sử dụng nhiều thẻ

Thẻ tiện ích bổ sung mẫu

Tiện ích bổ sung thường bao gồm nhiều thẻ. Bạn có thể định cấu hình các thẻ này dưới dạng một danh sách đơn giản cho thao tác cơ bản với nhiều thẻ hoặc định cấu hình các phương thức điều hướng phức tạp hơn để điều khiển cách người dùng di chuyển giữa các thẻ.

Nếu tiện ích bổ sung sử dụng cách thao tác cơ bản, thì khi tiện ích bổ sung được mở lần đầu tiên, ứng dụng Google Workspace sẽ mở rộng sẽ tạo danh sách tiêu đề thẻ và hiển thị các tiêu đề đó cho người dùng. Khi nhấp vào tiêu đề thẻ, thẻ đó sẽ mở ra. Mũi tên quay lại cũng được cung cấp để quay lại danh sách tiêu đề thẻ. Bạn không cần phải mã hoá chức năng mũi tên quay lại và tiêu đề. Việc này được thực hiện tự động khi bạn xác định các thẻ trong tiện ích bổ sung của mình.

Khi thiết kế tiện ích bổ sung, tốt nhất là bạn nên giới hạn số lượng thẻ mình hiển thị cùng một lúc, vì các thẻ phải dùng chung một lượng không gian màn hình hạn chế. Bạn cũng nên tránh tính phức tạp không cần thiết trong thẻ.