カード

カードベースのアドオンは、サイドバーのペインとして表示されます(モバイルでは別のペインとして表示されます)。 アクティビティ ウィンドウなど)を表示します。このアドオンの上部には アドオンを識別し、カード(基本的には「ページ」)を表示します 表示されます。Apps Script では、以下を使用してプロジェクト コード内のカードを表現します。 Card オブジェクト。

カードの構造

アドオンカードの例

カードは、デザインする UI 要素のグループです。カードは 次のセクション:

  • カードヘッダー。カードを識別します。タイトル テキストがあり、 オプションでサブタイトルとアイコンを設定できます。
  • 1 つ以上のカード セクション。カードの UI 領域の下位区分です。 セクションには、テキストのセクション ヘッダーを含めることもできます。 カードのセクションは、カード上で横線によって区切られています。 カード セクションが特に大きい場合は、 ユーザーが必要に応じて開閉できる折りたたみ可能なセクションです。 1 つのカードに含めることができるカード セクションは最大 100 個です。 パフォーマンスを高めるために 少数の値のみを割り当てる必要があります

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

特定のユーザー アクティビティやデータセットを中心にカードを設計する必要があります。対象 Google Workspace アドオンで 取得する場合、pull するシートごとに個別のカードが存在する場合があります。 抽出できます

複数のカードの使用

アドオンカードの例

アドオンは通常、複数のカードで構成されています。これらを構成するか 表示されるので、 複数のカードを使用した基本的なナビゲーション より複雑な設定を行うか、 ナビゲーション メソッド カード間を移動する方法を制御します。

アドオンで基本ナビゲーションを使用している場合、 最初に開いたときに Google Workspace アプリケーションは、 カードヘッダーのリストが作成され、ユーザーに提示されます。カードをクリックすると ヘッダーでカードが開きます。カードに戻るための戻る矢印も表示されます ヘッダーリスト。ヘッダーと戻る矢印をコーディングする必要がない これは、管理画面でカードを定義すると自動的に行われます。 できます。

アドオンを設計する場合は、 カードの数を制限する 複数のカードが共有する画面スペースの制限があるためです。 また、カードを不必要に複雑にしないことをおすすめします。