useHeldKeys

function useHeldKeys(): Ref<string[]>;

Defined in: useHeldKeys.ts:28

Vue composable that returns a reactive ref of currently held keyboard keys.

This composable subscribes to the global KeyStateTracker and updates whenever keys are pressed or released.

Returns#

Ref<string[]>

Reactive ref containing array of currently held key names

Example#

<script setup>
import { useHeldKeys } from '@tanstack/vue-hotkeys'

const heldKeys = useHeldKeys()
</script>

<template>
  <div>
    Currently pressed: {{ heldKeys.join(' + ') || 'None' }}
  </div>
</template>