Tiện ích bổ sung dựa trên thẻ xuất hiện dưới dạng ngăn trong thanh bên (hoặc trên thiết bị di động, dưới dạng một tiện ích khác
cửa sổ hoạt động đã truy cập qua trình đơn). Tiện ích bổ sung này có thanh công cụ ở trên cùng
xác định tiện ích bổ sung và hiển thị một thẻ – về cơ bản là một "trang" của
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ẻ là một nhóm các thành phần trên giao diện người dùng mà bạn thiết kế. Thẻ bao gồm các phần sau:
- Tiêu đề thẻ. Mã này giúp xác định các thẻ. Kết quả này có văn bản tiêu đề và có thể có phụ đề và biểu tượng (không bắt buộc).
Một hoặc nhiều mục 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 đề phần văn bản (không bắt buộc). Các phần thẻ được tách riêng với nhau trên thẻ theo quy tắc ngang. Nếu phần thẻ đặc biệt lớn, phần thẻ sẽ tự động hiển thị dưới dạng mục 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ể không quá 100 mục, và chỉ nên thêm một vài URL để đạt được hiệu suất tốt hơn.
Mỗi phần thẻ chứa một hoặc nhiều giao diện người dùng tiện ích. 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à các phần thẻ tiện ích cấu trúc nên bạn không thể thêm các tiện ích đó vào phần thẻ. Một thẻ có thể có không quá 100 tiện ích, và nên đơn giản nhất có thể để có hiệu suất tốt nhất.
Bạn nên thiết kế thẻ dựa trên các hoạt động hoặc tập dữ liệu cụ thể của người dùng. Cho ví dụ: một Tiện ích bổ sung của Google Workspace hiển thị dữ liệu được lấy từ Google Trang tính có thể có một thẻ riêng cho mỗi trang tính mà nó lấy .
Sử dụng nhiều thẻ
Tiện ích bổ sung thường chứa nhiều thẻ. Bạn có thể định cấu hình là một danh sách đơn giản để thao tác cơ bản với nhiều thẻ, hoặc định cấu hình phức tạp hơn phương thức điều hướng để kiểm soát 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 di chuyển cơ bản, khi được mở lần đầu tiên Ứng dụng Google Workspace này mở rộng cấu trúc danh sách tiêu đề thẻ và hiển thị các tiêu đề đó cho người dùng. Nhấp vào thẻ tiêu đề sẽ mở thẻ đó. Mũi tên quay lại cũng được cung cấp để quay lại thẻ danh sách tiêu đề. Bạn không phải viết mã cho đầu trang và mũi tên quay lại 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.
Khi thiết kế tiện ích bổ sung, tốt nhất bạn nên giới hạn số lượng thẻ bạn hiển thị cùng một lúc vì các thẻ phải chia sẻ một lượng không gian màn hình hạn chế. Bạn cũng nên tránh sự phức tạp không cần thiết trong thẻ.