Tiện ích bổ sung Google Workspace 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 có thể truy cập thông qua trình đơn). Tiện ích bổ sung này có một 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 tiện ích bổ sung. Google Apps Script biểu thị
các thẻ trong mã dự án bằng cách sử dụng Card
đối tượng.
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ẻ. Tiêu đề này xác định các thẻ. Tiêu đề thẻ 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. Các phần thẻ được phân tách với nhau trên thẻ bằng một đường kẻ ngang. Nếu một phần thẻ đặc biệt lớn, thì phần đó sẽ tự động được 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 thẻ, 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 UI widget. Tiện ích cung cấp cho người dùng thông tin hoặc các nút đ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 một phần thẻ. Một phần thẻ có thể có không quá 100 tiện ích, và nên ngắn gọn nhất có thể để đạt đượ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. Ví dụ: một tiện ích bổ sung Google Workspace hiển thị dữ liệu lấy từ Google Sheets có thể có một thẻ riêng cho mỗi trang tính mà tiện ích bổ sung này 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 một danh sách để điều hướng cơ bản 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ẻ. Để biết thông tin chi tiết, hãy xem phần điều hướng cơ bản bằng nhiều thẻ.
Nếu tiện ích bổ sung sử dụng tính năng điều hướng cơ bản, thì khi tiện ích bổ sung được mở lần đầu tiên, ứng dụng Google Workspace mà tiện ích bổ sung này mở rộng sẽ tạo một danh sách tiêu đề thẻ và hiển thị danh sách đó 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 viết mã cho chức năng tiêu đề và mũi tên quay lại – chức năng 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 là 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 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ẻ.
Vì lý do hiệu suất, bạn không thể thêm quá 100 tiện ích hoặc 100 phần thẻ vào một thẻ.