在 Jetpack Compose Glimmer 中處理間接指標輸入內容

適用的 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
瞭解 XR 裝置類型 →
音訊和螢幕眼鏡

瞭解 XR 裝置類型 →

onIndirectPointerGesture 修飾符可讓元件接收及回應高階間接指標事件，例如源自裝置觸控板的事件。使用這個修飾符擷取及處理來自觸控板或類似來源的手勢。

API 介面

應用程式可使用四個回呼來控管處理方式：

  • onClick：成功輕觸或點選，且沒有明顯的水平移動時觸發。
  • onSwipeForward：當水平滑動超過距離和速度門檻時，會觸發這個方法。
  • onSwipeBackward：水平滑動超過向後方向的距離和速度閾值時觸發。
  • Enabled：如果設為 false，系統會忽略修飾符，且不會叫用任何回呼。

滑動和捲動時的系統行為

系統會使用觸控斜率門檻來區分點擊和滑動。

  • 如果指標在按下狀態期間大幅移動，系統會取消 onClick。
  • 如果指標在移動期間大幅回溯，滑動手勢就會失效。

範例：設定元件的滑動和點擊處理方式

下列程式碼會設定可聚焦 Box 的滑動和點擊處理方式：

@Composable
@Sampled
fun OnIndirectPointerGestureSample() {
    Box(
        modifier =
            Modifier.fillMaxSize()
                .onIndirectPointerGesture(
                    enabled = true,
                    onSwipeForward = { /* onSwipeForward */ },
                    onSwipeBackward = { /* onSwipeBackward */ },
                    onClick = { /* onClick */ },
                )
                .focusTarget()
    ) {
        // App()
    }
}

程式碼重點

  • onIndirectPointerGesture 需要焦點，因此也會套用 focusTarget，讓 Box 可聚焦。您可以使用 focusTarget 或其他可啟用焦點的修飾符，例如 surface。如果沒有焦點，修飾符就無法對間接指標事件採取行動。
  • 這個範例會實作 onSwipeForward 和 onClick 回呼，因此系統偵測到的滑動和點擊手勢會遭到攔截並耗用，不會傳遞至外部的父項容器。不過，您也可以將特定回呼設為空值，將手勢傳遞至上層容器中的 onIndirectPointerGesture 修飾符。-