TanStack Hotkeys provides three Svelte functions for tracking live keyboard state: getHeldKeys, getHeldKeyCodesMap, and getIsKeyHeld.
<script lang="ts">
import { getHeldKeys } from '@tanstack/svelte-hotkeys'
const heldKeys = getHeldKeys()
</script>
<div>{heldKeys.keys.length > 0 ? heldKeys.keys.join(' + ') : 'No keys held'}</div>
<script lang="ts">
import { getHeldKeyCodesMap } from '@tanstack/svelte-hotkeys'
const heldCodes = getHeldKeyCodesMap()
</script>
<pre>{JSON.stringify(heldCodes.codes, null, 2)}</pre>
<script lang="ts">
import { getIsKeyHeld } from '@tanstack/svelte-hotkeys'
const isShiftHeld = getIsKeyHeld('Shift')
</script>
<span class:active={isShiftHeld.held}>Shift</span>
<script lang="ts">
import { getIsKeyHeld } from '@tanstack/svelte-hotkeys'
const isShiftHeld = getIsKeyHeld('Shift')
</script>
{#if isShiftHeld.held}
<button>Permanently Delete</button>
{:else}
<button>Move to Trash</button>
{/if}
<script lang="ts">
import {
formatForDisplay,
getHeldKeyCodesMap,
getHeldKeys,
type RegisterableHotkey,
} from '@tanstack/svelte-hotkeys'
const heldKeys = getHeldKeys()
const heldCodes = getHeldKeyCodesMap()
</script>
<div>
{#each heldKeys.keys as key}
<kbd>
{formatForDisplay(key as RegisterableHotkey, { useSymbols: true })}:
{heldCodes.codes[key] ?? 'unknown'}
</kbd>
{/each}
</div>
All three functions subscribe to the singleton KeyStateTracker:
import { getKeyStateTracker } from '@tanstack/svelte-hotkeys'
const tracker = getKeyStateTracker()
tracker.getHeldKeys()
tracker.isKeyHeld('Shift')