# OneHandedGesturePriority

Artifact: [androidx.wear.compose:compose-material3](https://developer.android.com/jetpack/androidx/releases/wear-compose) [View Source](https://cs.android.com/search?q=file:androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority.kt+class:androidx.wear.compose.material3.onehandedgesture.OneHandedGesturePriority) Added in [1.7.0](https://developer.android.com/jetpack/androidx/releases/wear-compose#1.7.0)


```
value class OneHandedGesturePriority
```

<br />

*** ** * ** ***

Defines the fixed precedence levels for one-handed gesture interception.

This priority system is used to resolve conflicts when multiple components in a UI hierarchy are eligible to handle a gesture action. Because the system cannot automatically determine intent in overlapping areas, developers should assign one of these predefined priority levels to their components to establish a functional gesture hierarchy.

For gestures with the same action, higher priority values take precedence over lower ones, so that `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority#Clickable()` takes priority over `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority#Scrollable()`. It is not recommended to register multiple gestures for the same action and priority (but if that is the case, all of them will be actioned)

## Summary

| ### Public companion properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority` | `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority#Clickable()` Priority for interactive components like buttons, switches, or chips. |
| `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority` | `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority#Scrollable()` Priority for general scrollable areas, such as lists, pagers or containers. |
| `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority` | `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority#Unspecified()` Default priority level. |

## Public companion properties

### Clickable

```
val Clickable: OneHandedGesturePriority
```

Priority for interactive components like buttons, switches, or chips.

This is the highest priority tier. It must be used on individual controls to ensure they capture gestures before their containing scrollable or pageable parents.

### Scrollable

```
val Scrollable: OneHandedGesturePriority
```

Priority for general scrollable areas, such as lists, pagers or containers.

This level but yields to `https://developer.android.com/reference/kotlin/androidx/wear/compose/material3/onehandedgesture/OneHandedGesturePriority#Clickable()` elements to ensure interactive controls remain accessible within a scrollable parent.

### Unspecified

```
val Unspecified: OneHandedGesturePriority
```

Default priority level.

Used when no specific priority is defined. This level typically yields to any other specified gesture priority.