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 truy cập được thông qua trình đơn). Tiện ích bổ sung có một 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" 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ế. Một thẻ bao gồm các phần sau:
- Tiêu đề thẻ. Mã này giúp xác định các thẻ. Thành phần 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 phần thẻ. Đây là các phần phụ 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 của thẻ được phân tách với nhau trên thẻ bằng một đường kẻ ngang. Nếu một mục thẻ đặc biệt lớn, thì mục đó sẽ tự động hiển thị dưới dạng một 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ể có không quá 100 mục thẻ và chỉ nên có một vài mục để đạt được hiệu suất tốt hơn.
Mỗi phần của 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 thẻ đó vào phần thẻ. Một phần thẻ có thể có không quá 100 tiện ích và phải đơn giản nhất có thể để đạt được hiệu suất tốt nhất.
Bạn nên thiết kế thẻ theo các hoạt động hoặc tập dữ liệu cụ thể của người dùng. 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 đó lấy dữ liệu.
Sử dụng nhiều thẻ
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 danh sách đơn giản để điều hướng cơ bản bằng 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 để 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 tính năng điều hướng cơ bản, thì khi mở tiện ích bổ sung lần đầu, ứng dụng Google Workspace sẽ mở rộng để tạo danh sách tiêu đề thẻ và hiển thị các tiêu đề đó cho người dùng. Khi bạn nhấp vào tiêu đề thẻ, thẻ đó sẽ mở ra. Một 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 lập trình chức năng tiêu đề và mũi tên quay lại. Việc này sẽ đượ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ẻ hiển thị cùng một lúc, vì các thẻ phải chia sẻ một không gian màn hình có giới hạn. Bạn cũng nên tránh làm cho thẻ trở nên phức tạp không cần thiết.