Scorri per vedere
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Consenti agli utenti di far scorrere un componente per visualizzare azioni aggiuntive.
Il componente Scorri per visualizzare ti consente di aggiungere ulteriori azioni a chip e schede, nello specifico quando appaiono negli elenchi. Questo componente consente agli utenti di svolgere rapidamente le attività senza uscire dallo schermo.
Gli utenti possono far scorrere parzialmente chip e schede verso sinistra per accedere a queste azioni, quindi toccare un'azione per completarla. Gli utenti possono anche far scorrere completamente i chip e le schede verso sinistra per eseguire rapidamente l'azione principale.
Il componente è dotato di due slot per queste azioni:
- Principale
- Secondario (facoltativo)
Anatomia
Azioni visualizzate
Gli sviluppatori possono personalizzare le azioni per i loro casi d'uso specifici. Considera il colore e l'iconografia utilizzati in queste azioni per aiutare gli utenti a capire cosa significano.
Le azioni mostrate vengono visualizzate sullo stesso lato per tutte le impostazioni internazionali delle lingue.
- Azione principale
- Azione secondaria (facoltativa)
Impegno in un'azione principale
Per eseguire il commit dell'azione principale, l'utente può toccare il pulsante o continuare a scorrere verso sinistra. In questo modo il pulsante si estende per tutta la larghezza dello schermo e visualizza un'etichetta. L'azione scompare dopo che è stata selezionata.
Il primo esempio mostra un'opzione con pulsante singolo. Il secondo esempio mostra un'opzione con pulsante doppio.
Annulla azione
Nel caso di azioni distruttive, aggiungi un componente Annulla per consentire agli utenti di annullarle. Aggiungi la funzionalità di annullamento all'azione principale.
Se viene aggiunta, viene visualizzato un pulsante di annullamento del chip al posto dell'azione impegnata.
Dopo un breve periodo di tempo, l'azione di annullamento scompare e il sistema completa l'azione impegnata.
Soglie di scorrimento
Lo scorrimento per visualizzare il comportamento del componente dipende da quanto l'utente fa scorrere lo schermo:
- Se l'utente scorre meno del 50% dello schermo, il componente torna alla posizione iniziale e non viene intrapresa alcuna azione.
- Se l'utente scorre sullo schermo dal 50% al 75% dell'intera larghezza, il componente rimane parzialmente visibile e vengono visualizzate le azioni associate al componente.
- Se l'utente scorre oltre il 75% dello schermo, il componente scompare e il sistema esegue automaticamente l'azione principale.
I seguenti componenti a tema materiale implementano lo scorrimento per rivelare il comportamento:
Nelle carte
I seguenti screenshot mostrano lo scorrimento per mostrare l'aspetto del componente quando si utilizza la classe SwipeToRevealCard:
Sui chip
I seguenti screenshot mostrano lo scorrimento per mostrare l'aspetto del componente quando si utilizza la classe SwipeToRevealChip:
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[null,null,["Ultimo aggiornamento 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:"]]
