카드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
카드는 TV 앱의 기본 구성요소입니다.
리소스
하이라이트
- 카드를 사용하여 단일 주제에 관한 콘텐츠를 표시합니다.
- 카드에는 이미지부터 광고 제목에 이르기까지 텍스트, 버튼, 목록, 기타 UI 요소를 지원하는 모든 항목이 포함될 수 있습니다.
- 카드는 다른 카드와 병합하거나 여러 카드로 나눌 수 없습니다.
- 카드에는 표준, 클래식, 소형, 인셋, 와이드 표준, 와이드 클래식의 6가지 변형이 있습니다.
변형
5가지 유형의 카드가 있으며 각 유형의 카드는 사용 사례가 다릅니다.
- 표준
- 명작
- 작게
- 넓은 표준
- 와이드 클래식
콘텐츠 블록
카드의 콘텐츠는 고유한 블록으로 정렬됩니다. 강조를 포함한 카드의 시각적 디자인은 계층 구조를 나타냅니다. 카드 자체의 레이아웃은 카드에 포함된 콘텐츠 유형을 수용합니다.
분석
- 제목
- 부제
- 설명
- 추가 텍스트
사양

표준 카드
분석

- 이미지
- 콘텐츠 블록
상태

사양

클래식 카드
분석

- 이미지
- 콘텐츠 블록
상태

사양

압축 카드
분석

- 이미지
- 콘텐츠 블록
상태

사양

넓은 표준 카드
분석

- 이미지
- 콘텐츠 블록
상태

사양

넓은 클래식 카드
분석

- 이미지
- 콘텐츠 블록
상태

사양

사용
카드는 시각적으로 매력적이고 사용자 친화적인 방식으로 다양한 콘텐츠를 표시하는 데 사용할 수 있는 다목적 디자인 요소입니다. 다음 섹션에서는 카드의 디자인 고려사항을 살펴봅니다.
가로세로 비율
카드의 일반적인 가로세로 비율은 16:9, 1:1, 2:3의 3가지입니다.
각 가로세로 비율에는 고유한 장점이 있으므로 구체적인 요구사항에 따라 가장 적합한 것을 선택해야 합니다.
- 카드의 가장 일반적인 가로세로 비율은 16:9입니다. 이미지와 동영상을 표시하는 데 적합한 넓은 가로세로 비율입니다.
- 1:1은 정사각형 가로세로 비율입니다. 출연진과 제작진, 채널 로고, 팀 로고와 같이 시각적으로 균형을 유지해야 하는 카드에 적합합니다.
- 2:3은 가로 세로 비율이 더 높습니다. 그리드를 분할하여
강조를 강조하고 싶을 때 적합합니다
궁극적으로 카드의 가로세로 비율을 선택하는 가장 좋은 방법은 다양한 옵션을 실험하고 가장 잘 보이는 옵션을 확인하는 것입니다.

다음은 다양한 가로세로 비율의 사용 예입니다.
1:1
출연진 및 제작진
스포츠 팀 로고
2:3
인기 도서
16:9
영화 카드
레이아웃 및 간격
20dp 간격으로 적절한 피킹을 구현하면 화면에 표시되는 카드 수에 따라 카드 너비를 다양하게 변경할 수 있습니다.
카드 한 장 레이아웃
카드 너비: 844dp
2개 카드 레이아웃
카드 너비 — 412dp
3개 카드 레이아웃
카드 너비 — 268dp
4카드 레이아웃
카드 너비 — 196dp
5개 카드 레이아웃
카드 너비: 124dp
콘텐츠 블록
카드의 콘텐츠 블록 너비는 이미지 썸네일과 너비가 동일해야 합니다. 콘텐츠 블록에 더 많은 텍스트를 표시해야 한다면 다양한 카드 변형을 사용하세요.
check_circle
의견을 제시하지
넓은 카드를 사용하여 간단한 설명을 표시하세요. 단, 꼭 필요한 경우에만 사용하세요. 설명의 길이는 몇 단어로 되어 있어야 합니다.
cancel
부적절한 예
세로로 쌓인 카드에는 긴 설명을 표시하지 마세요.
압축 카드
콤팩트 카드는 간결하고 읽기 쉬워야 합니다. 배경 이미지 앞에 있는 콘텐츠는 간단명료해야 합니다. 긴 제목, 부제목, 설명은 사용하지 마세요. 이렇게 하면 카드가 시각적으로 더 매력적이고
더 쉽게 훑어볼 수 있습니다.
이미지의 텍스트를 더 쉽게 읽을 수 있도록 하려면 반투명 검은색 그라데이션 오버레이를 추가합니다. 이렇게 하면 이미지를 너무 가리지 않고 배경을 어둡게 하여
텍스트를 더 쉽게 볼 수 있습니다.
check_circle
의견을 제시하지
이미지 배경 위에 스크림을 사용하는 소형 카드입니다.
cancel
부적절한 예
배경 이미지 위에 스크림이 없는 소형 카드는 사용하지 마세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Cards are the basic building blocks of your TV app. \n\nResources\n---------\n\n| Type | Link | Status |\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|\n| Design | [Design source (Figma)](https://goo.gle/tv-desing-kit) | Available |\n| Implementation | [Jetpack Compose](/reference/kotlin/androidx/tv/material3/package-summary#Card(kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Function0,androidx.tv.material3.CardShape,androidx.tv.material3.CardColors,androidx.tv.material3.CardScale,androidx.tv.material3.CardBorder,androidx.tv.material3.CardGlow,androidx.compose.foundation.interaction.MutableInteractionSource,kotlin.Function1)) | Available |\n\nHighlights\n----------\n\n- Use a card to display content on a single topic.\n- A card can hold anything from images to headlines, supporting text, buttons, lists, and other UI elements.\n- A card cannot merge with another card or divide into multiple cards.\n- There are six variations of cards: standard, classic, compact, inset, wide standard, and wide classic.\n\nVariants\n--------\n\nThere are five types of cards, each with a different use case:\n\n1. Standard\n2. Classic\n3. Compact\n4. Wide standard\n5. Wide classic\n\nContent blocks\n--------------\n\nA card's contents are arranged in distinct blocks. The card visual design\nincluding emphasis denotes hierarchy. The layout of the cards themselves\naccommodates the types of content the cards contain.\n\n### Anatomy\n\n1. Title\n2. Subtitle\n3. Description\n4. Extra text\n\n### Specs\n\nStandard card\n-------------\n\n### Anatomy\n\n1. Image\n2. Content block\n\n### States\n\n### Specs\n\nClassic card\n------------\n\n### Anatomy\n\n1. Image\n2. Content block\n\n### States\n\n### Specs\n\nCompact card\n------------\n\n### Anatomy\n\n1. Image\n2. Content block\n\n### States\n\n### Specs\n\nWide standard card\n------------------\n\n### Anatomy\n\n1. Image\n2. Content block\n\n### States\n\n### Specs\n\nWide classic card\n-----------------\n\n### Anatomy\n\n1. Image\n2. Content block\n\n### States\n\n### Specs\n\nUsage\n-----\n\nCards are versatile design elements that can be used to display a variety\nof content in a visually appealing and user-friendly way. The following\nsections explore design considerations for cards.\n\n### Aspect ratio\n\nThere are three common aspect ratios for cards: 16:9, 1:1, and 2:3.\nEach aspect ratio has its strengths, so the best choice for\nyou depends on your specific needs.\n\n- 16:9 is the most common aspect ratio for cards. It is a wide aspect ratio that is well-suited for displaying images and videos.\n- 1:1 is a square aspect ratio. It is a good choice for cards that need to be visually balanced, such as cast and crew, channel logos, or team logos.\n- 2:3 is a taller aspect ratio. It is a good choice if you want to break up the grid and bring more emphasis.\n\nUltimately, the best way to choose an aspect ratio for your cards is to\nexperiment with different options and see what looks best.\n\nHere are some examples usages of different aspect ratios \n\n### 1:1\n\nCast and crew \n\nSports teams logos\n\n### 2:3\n\nTrending books\n\n### 16:9\n\nMovie cards\n\n### Layout and spacing\n\nVarying card widths based on the number of cards visible on the screen\ncan be achieved by implementing proper peaking with a spacing of 20dp. \n\n### 1-card layout\n\nWidth of the card --- 844dp\n\n### 2-card layout\n\nWidth of the card --- 412dp\n\n### 3-card layout\n\nWidth of the card --- 268dp\n\n### 4-card layout\n\nWidth of the card --- 196dp\n\n### 5-card layout\n\nWidth of the card --- 124dp\n\n### Content block\n\nThe width of the content block in a card should be the same width as the image\nthumbnail. If you need to display more text in the content block,\nuse a wide card variation. \ncheck_circle\n\n### Do\n\nUse wide cards to show short descriptions, but only if absolutely necessary. The length of the description should be only a few words. \ncancel\n\n### Don't\n\nAvoid long descriptions on vertically stacked cards.\n\n### Compact card\n\nCompact cards should be concise and easier to read. The content preceding the\nbackground image should be brief and to the point. Avoid long titles,\nsubtitles, or descriptions. This makes your cards more\nvisually appealing and easier to scan.\n\nTo make text more readable on an image, add a semi-transparent black\ngradient overlay. This darkens the background without obscuring\nthe image too much, making the text easier to see. \ncheck_circle\n\n### Do\n\nCompact card using scrim on top of image background. \ncancel\n\n### Don't\n\nDon't use compact cards without scrim on top of the background image."]]