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