カード

カードベースのアドオンは、サイドバーのペインとして表示されます（モバイルの場合は、メニューからアクセスできる別のアクティビティ ウィンドウとして表示されます）。アドオンには、アドオンを識別し、カード（アドオンの UI の「ページ」）を表示する上部ツールバーがあります。Apps Script では、プロジェクト コードでカードを表現するために Card オブジェクトを使用します。

カードの構造

カードは、設計した UI 要素のグループです。カードは次のセクションで構成されています。

• カードのヘッダー。これにより、カードを識別できます。タイトル テキストがあり、必要に応じてサブタイトルとアイコンを設定できます。

• 1 つ以上のカード セクション。これらは、カードの UI 領域のサブディビジョンです。セクションには、必要に応じてテキスト セクション ヘッダーを含めることができます。カードのセクションは、カード上で横線で区切られています。カード セクションが特に大きい場合は、ユーザーが必要に応じて展開または閉じることができる、折りたたみ可能なセクションとして自動的にレンダリングされます。カードにはカードセクションを 100 個まで含めることができますが、パフォーマンスを高めるには数個に抑えることをおすすめします。

• 各カード セクションには、1 つ以上の UI ウィジェットが含まれています。ウィジェットは、ユーザーに情報やインタラクティブなコントロールを提供します。カードとカード セクションは構造的ウィジェットであるため、カード セクションに追加することはできません。カード セクションに配置できるウィジェットは 100 個までです。パフォーマンスを最大限に高めるには、できるだけシンプルにしてください。

カードは、特定のユーザー アクティビティやデータセットを中心に設計する必要があります。たとえば、Google スプレッドシートから取得したデータを表示する Google Workspace アドオンには、データを取得するシートごとに個別のカードが表示されます。

複数のカードを使用する

アドオンは通常、複数のカードで構成されます。これらのカードは、複数のカードを使用した基本的なナビゲーション用のシンプルなリストとして構成することも、より複雑なナビゲーション メソッドを構成して、ユーザーがカード間を移動する方法を制御することもできます。

アドオンが基本的なナビゲーションを使用する場合、アドオンが初めて開かれると、拡張する Google Workspace アプリケーションがカードヘッダーのリストを構築し、ユーザーに表示します。カードのヘッダーをクリックすると、そのカードが開きます。カードヘッダー リストに戻るための戻る矢印も用意されています。ヘッダーと戻る矢印の機能はコードで記述する必要はありません。アドオンでカードを定義すると、自動的に処理されます。

アドオンを設計する際は、カードは限られた画面スペースを共有する必要があるため、一度に表示するカードの数を制限することをおすすめします。また、カードを不必要に複雑にしないこともおすすめします。