스와이프하여 표시
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자가 구성요소를 스와이프하여 추가 작업을 표시할 수 있습니다.

스와이프하여 표시 구성요소를 사용하면 칩과 카드에, 특히 목록에 표시될 때 추가 작업을 추가할 수 있습니다. 이 구성요소를 사용하면 사용자가 화면을 벗어나지 않고도 빠르게 작업을 완료할 수 있습니다.
사용자는 칩과 카드를 왼쪽으로 부분적으로 스와이프하여 이러한 작업에 액세스한 다음 작업을 탭하여 완료할 수 있습니다. 또한 칩과 카드를 왼쪽으로 완전히 스와이프하여 기본 작업을 빠르게 실행할 수도 있습니다.
구성요소에는 다음 작업을 위한 슬롯이 2개 있습니다.
- 기본
- 보조 (선택사항)
분석
공개된 작업
개발자는 고유한 사용 사례에 맞게 작업을 맞춤설정할 수 있습니다. 사용자가 작업의 의미를 쉽게 이해할 수 있도록 이러한 작업에 사용되는 색상과 아이콘을 고려하세요.
표시된 작업은 모든 언어에서 동일한 쪽에 표시됩니다.
- 기본 액션
- 보조 액션 (선택사항)
기본 작업 커밋
기본 작업을 커밋하려면 사용자는 버튼을 탭하거나 왼쪽으로 계속 스와이프하면 됩니다. 이렇게 하면 버튼이 화면 전체 너비까지 확장되고 라벨이 표시됩니다. 작업은 선택된 후 사라집니다.
첫 번째 예는 단일 버튼 옵션을 보여줍니다. 두 번째 예는 이중 버튼 옵션을 보여줍니다.
작업 실행취소
파괴적인 작업의 경우 사용자가 이러한 작업을 취소할 수 있도록 실행취소 구성요소를 추가하세요. 기본 작업에 실행취소 기능을 추가합니다.
추가하면 커밋된 작업 대신 실행취소 칩 버튼이 표시됩니다.
잠시 후 실행취소 작업이 사라지고 시스템이 커밋된 작업을 완료합니다.
스와이프 기준점
스와이프하여 구성요소의 동작은 사용자가 화면을 스와이프하는 정도에 따라 달라집니다.
- 사용자가 화면의 50% 미만을 스와이프하여 스와이프하면 구성요소가 시작 위치로 다시 돌아가고 아무 작업도 실행되지 않습니다.
- 사용자가 전체 너비의 50~75% 사이에서 화면을 스와이프하면 구성요소는 부분적으로 표시되고 구성요소와 관련된 작업이 표시됩니다.
- 사용자가 화면의 75% 이상을 스와이프하면 구성요소가 사라지고 시스템에서 자동으로 기본 작업을 실행합니다.
다음 머티리얼 테마 구성요소는 스와이프를 구현하여 동작을 표시합니다.
카드
다음 스크린샷은 SwipeToRevealCard
클래스를 사용할 때 스와이프하여 구성요소가 어떻게 표시되는지 보여줍니다.

온칩
다음 스크린샷은 SwipeToRevealChip
클래스를 사용할 때 스와이프하여 구성요소가 어떻게 표시되는지 보여줍니다.

이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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,["# Swipe to reveal\n\nAllow users to swipe a component to reveal extra actions.\n\nThe *swipe to reveal* component lets you add extra actions to\nchips and cards, specifically when they appear in lists. This component lets\nusers quickly get things done without leaving the screen.\n\nUsers can partially swipe chips and cards to the left to access these\nactions, then tap on an action to complete it. Users can also fully swipe\nchips and cards to the left to quickly commit to the primary action. \nThe component has 2 slots for these actions:\n\n1. **Primary**\n2. **Secondary (optional)**\n\nAnatomy\n-------\n\n### Revealed actions\n\nDevelopers can customize the actions for their unique use cases. Consider\nthe color and iconography used in these actions to help users understand\nwhat they mean.\n\nThe revealed actions appear on the same side for all language\nlocales.\n\n1. **Primary action**\n2. **Secondary action (optional)** \n\n### Commit to a primary action\n\nTo commit to the primary action, a user can either tap on the button or\ncontinue swiping to the left. In this way, the button extends to the entire\nwidth of the screen and displays a label. The action fades away after being\nselected.\n\nThe first example shows a **single button option** . The\nsecond example shows a **double button option**. \n\n### Undo action\n\nFor destructive actions, add an undo component to let users reverse these\nactions. Add the undo capability to the primary action.\n\nIf added, an undo chip button appears in place of the committed action.\nAfter a short period of time, the undo action fades away, and the system\ncompletes the committed action. \n\n### Swipe thresholds\n\nThe swipe to reveal component's behavior depends upon how far the user\nswipes across the screen:\n\n- If the user swipes across less than 50% of the screen, the component snaps back to its starting position, and no action is taken.\n- If the user swipes across the screen between 50% and 75% of the full width, the component remains partially visible, and the actions associated with the component appear.\n- If the user swipes across more than 75% of the screen, the component disappears, and the system automatically performs the primary action.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nRelated components\n------------------\n\nThe following material-themed components implement the swipe to reveal behavior:\n\n- [`SwipeToRevealCard`](/reference/kotlin/androidx/wear/compose/material/package-summary#SwipeToRevealCard(androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.foundation.RevealState,androidx.compose.ui.Modifier,androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.material.SwipeToRevealActionColors,androidx.compose.ui.graphics.Shape,kotlin.Function0))\n- [`SwipeToRevealChip`](/reference/kotlin/androidx/wear/compose/material/package-summary#SwipeToRevealChip(androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.foundation.RevealState,androidx.compose.ui.Modifier,androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.material.SwipeToRevealAction,androidx.wear.compose.material.SwipeToRevealActionColors,androidx.compose.ui.graphics.Shape,kotlin.Function0))\n\n### On cards\n\nThe following screenshots show the swipe to reveal component's appearance when\nusing the `SwipeToRevealCard` class:\n\n### On chips\n\nThe following screenshots show the swipe to reveal component's appearance when\nusing the `SwipeToRevealChip` class:"]]