카드 기반 부가기능은 사이드바에 (또는 모바일의 경우 메뉴를 통해 도달한 다른 활동 창으로) 창으로 표시됩니다. 부가기능에는 부가기능을 식별하고 카드(기본적으로 부가기능 UI의 '페이지')를 표시하는 상단 툴바가 있습니다. Apps Script는 Card 객체를 사용하여 프로젝트 코드의 카드를 나타냅니다.
카드 분석
카드는 디자인하는 UI 요소의 그룹입니다. 카드는 다음 섹션으로 구성됩니다.
- 카드 헤더. 그러면 카드가 식별됩니다. 제목 텍스트가 있으며, 선택적으로 자막과 아이콘을 포함할 수 있습니다.
하나 이상의 카드 섹션. 카드 UI 영역의 세부 영역입니다. 섹션은 선택사항으로 텍스트 섹션 헤더가 있을 수도 있습니다. 카드 섹션은 가로 규칙으로 카드에서 구분됩니다. 카드 섹션이 특히 크면 사용자가 필요에 따라 확장하거나 축소할 수 있는 접을 수 있는 섹션으로 자동 렌더링됩니다. 카드는 100개 이하의 카드 섹션을 포함할 수 있으며, 성능 향상을 위해 몇 개만 포함해야 합니다.
각 카드 섹션에는 하나 이상의 UI 위젯이 포함됩니다. 위젯은 사용자에게 정보 또는 상호작용 컨트롤을 제공합니다. 카드와 카드 섹션은 구조적 위젯이므로 카드 섹션에 추가할 수 없습니다. 카드 섹션에는 위젯이 100개 이하가 포함될 수 있으며, 최상의 성능을 위해 최대한 간결해야 합니다.
특정 사용자 활동이나 데이터 세트를 중심으로 카드를 디자인해야 합니다. 예를 들어 Google Sheets에서 가져온 데이터를 표시하는 Google Workspace 부가기능에는 데이터를 가져오는 시트마다 별도의 카드가 있을 수 있습니다.
여러 카드 사용
부가기능은 일반적으로 2개 이상의 카드로 구성됩니다. 이러한 카드는 여러 카드를 사용하는 기본 탐색을 위한 간단한 목록으로 구성하거나 좀 더 복잡한 탐색 방법을 구성하여 사용자가 카드 간에 이동하는 방식을 제어할 수 있습니다.
부가기능에서 기본 탐색을 사용하는 경우 부가기능이 처음 열리면 Google Workspace 애플리케이션이 확장되어 카드 헤더 목록이 생성되어 사용자에게 표시됩니다. 카드 헤더를 클릭하면 카드가 열립니다. 카드 헤더 목록으로 돌아갈 수 있는 뒤로 화살표도 제공됩니다. 헤더에서 카드를 정의할 때 헤더와 뒤로 화살표 기능을 자동으로 코딩할 필요가 없습니다.
카드는 제한된 화면 공간을 공유해야 하므로 부가기능을 설계할 때 동시에 표시되는 카드 수를 제한하는 것이 가장 좋습니다. 또한 카드가 불필요하게 복잡하지 않게 하는 것이 좋습니다.