カード

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

カードベースのアドオンは、サイドバーにペインとして表示されます(モバイルでは、メニューを介して表示される別のアクティビティ ウィンドウとして表示されます)。アドオンには、アドオンを識別し、アドオンの UI の「ページ」(基本的には「ページ」)を表示する上部ツールバーがあります。Apps Script は、Card オブジェクトを使用してプロジェクト コードのカードを表します。

カードの構造

アドオンカードの例

カードとは、デザインする UI 要素のグループのことです。カードは次のセクションで構成されています。

  • カードヘッダー。カードを識別します。タイトル テキストがあり、必要に応じて字幕とアイコンを含めることができます。
  • 1 つ以上のカード セクションカードの UI 領域を細分化したものです。 セクションにテキスト セクション ヘッダーを指定することもできます。 カード セクションは、水平方向のルールによってカード上で互いに分離されています。カード セクションが特に大きい場合は、折りたたみ可能なセクションとして自動的にレンダリングされ、ユーザーは必要に応じて展開や折りたたみを行うことができます。カードに含めることができるカード セクションは 100 枚までです。パフォーマンスを高めるために、少数のセクションにする必要があります。

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

カードは、特定のユーザー アクティビティやデータセットに合わせてデザインする必要があります。たとえば、Google スプレッドシートから取得したデータを表示する Google Workspace アドオンでは、データを取得するシートごとに個別のカードを作成できます。

複数のカードを使用する

アドオンカードの例

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

基本的なナビゲーションを使用する場合、アドオンは最初に Google Workspace アプリケーションを開くと、カードヘッダーのリストが作成され、ユーザーに提示されます。カードヘッダーをクリックすると、そのカードが開きます。「戻る」矢印は、カードヘッダー リストに戻るためにも提供されます。ヘッダーと戻る矢印の機能をコーディングする必要はありません。これは、アドオンでカードを定義するときに自動的に行われます。

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