Przesuń, aby odkryć
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zezwalanie użytkownikom na przesuwanie komponentu w celu wyświetlenia dodatkowych działań.
Komponent przesuń, aby wyświetlić umożliwia dodawanie dodatkowych działań do elementów i kart, zwłaszcza gdy pojawiają się one na listach. Ten komponent pozwala użytkownikom szybko wykonywać czynności bez opuszczania ekranu.
Użytkownicy mogą przesuwać elementy i karty w lewo, aby uzyskać dostęp do tych działań, a potem kliknąć działanie, aby je wykonać. Użytkownicy mogą też przesunąć elementy i karty w lewo, aby szybko wykonać główne działanie.
Komponent ma 2 miejsca na te działania:
- Główny
- Dodatkowy (opcjonalnie)
Anatomia
Odsłonięte działania
Deweloperzy mogą dostosowywać działania do swoich potrzeb. Zastanów się, jakie kolory i ikony chcesz użyć, aby użytkownicy wiedzieli, co oznaczają te działania.
Odkryte działania są widoczne po tej samej stronie we wszystkich językach.
- Główne działanie
- Dodatkowe działanie (opcjonalne)
Przejście do działania podstawowego
Aby wykonać główne działanie, użytkownik może kliknąć przycisk lub przesunąć palcem w lewo. W ten sposób przycisk zajmuje całą szerokość ekranu i wyświetla etykietę. Po wybraniu działanie znika.
Pierwszy przykład pokazuje opcję z jednym przyciskiem. Drugi przykład przedstawia opcję podwójnego przycisku.
Cofnij działanie
W przypadku działań, które mogą spowodować utratę danych, dodaj komponent cofnięcia, aby użytkownicy mogli je cofnąć. Dodaj do działania głównego możliwość cofnięcia.
Jeśli zostanie dodany, zamiast wykonanej czynności pojawi się przycisk cofnięcia.
Po chwili cofnięcie zniknie, a system wykona działanie.
Próg przesunięcia
Zachowanie komponentu Przesuń, aby wyświetlić, zależy od tego, jak daleko użytkownik przesuwa palcem po ekranie:
- Jeśli użytkownik przesunie palcem mniej niż połowę ekranu, komponent
powróci do pozycji wyjściowej i nie zostanie podjęta żadna czynność.
- Jeśli użytkownik przesunie palcem po ekranie w odległości od 50% do 75% jego szerokości, komponent pozostanie częściowo widoczny, a pojawią się powiązane z nim działania.
- Jeśli użytkownik przesunie palcem po ponad 75% ekranu, komponent zniknie, a system automatycznie wykona główne działanie.
Te komponenty oparte na temacie materiału implementują funkcję odsłonięcia przez przesunięcie:
Na kartach
Na tych zrzutach ekranu widać, jak wygląda komponent po przesunięciu palcem, gdy używasz klasy SwipeToRevealCard:
W przypadku układów
Na tych zrzutach ekranu widać, jak wygląda komponent po przesunięciu palcem, gdy używasz klasy SwipeToRevealChip:
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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:"]]
