KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #deepseek-harness #ai-agent #mcp #dsh-plugin

svelte-keydown

★ 44 Open GitHub ↗

Utility to listen for keyboard events

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# svelte-keydown

[![NPM][npm]][npm-url]

> Utility to listen for keyboard events.

Utility component leveraging the [svelte:body API](https://svelte.dev/docs#svelte_body) to listen for [keydown](https://developer.mozilla.org/en-US/docs/Web/API/Document/keydown_event) events.

[Try it in the Svelte REPL](https://svelte.dev/repl/f22827a1e3c94a018a685fec6346db6c).

**Use Cases**

- toggle modals
- capture a combination of keys (i.e., "Meta-s")

---

## Installation

**Yarn**

```bash
yarn add -D svelte-keydown
```

**NPM**

```bash
npm i -D svelte-keydown
```

**pnpm**

```bash
pnpm i -D svelte-keydown
```

## Usage

### Basic

```svelte
<script>
  import Keydown from "svelte-keydown";

let events = [];
</script>

<Keydown
  on:Enter={() => {
    events = [...events, "enter"];
  }}
/>

Press "enter": {events.join(", ")}
```

### Pause on input

Set `pauseOnInput` to prevent the utility from capturing keydown events on input events.

```svelte
<script>
  import Keydown from "svelte-keydown";

let evt = [];
</script>

<Keydown
  pauseOnInput
  on:key={(e) => {
    evt = [...evt, e.detail];
  }}
/>

{evt.join("")}
```

### Preventing the default behavior

This component forward the `on:keyup` and `on:keydown` events.

You can use `on:keydown` to prevent the default behavior for certain keys.

In the following example, pressing "Space" should not cause the browser page to scroll.

```svelte
<Keydown
  on:keydown={(e) => {
    if (e.key === " ") e.preventDefault();
  }}
  on:Space={(e) => {
    console.log("key", "Space");
  }}
/>
```

## Examples

### Escape to close a modal

In this use case, keydown events are paused if the modal is not open.

```svelte
<script>
  import Keydown from "svelte-keydown";

let showModal = true;
</script>

<Keydown paused={!showModal} on:Escape={() => (showModal = false)} />

<button on:click={() => (showModal = !showModal)}>Toggled? {showModal}</button>
```

### `on:combo`

Use the `combo` dispatched event to listen for a combination of keys.

```svelte
<script>
  import Keydown from "svelte-keydown";

let combo = [];
</script>

<Keydown on:combo={(e) => (combo = [...combo, e.detail])} />

{combo.join(", ")}
```

#### `separator`

Use the `separator` property to customize the separating key between multiple keys.

```svelte
<script>
  import Keydown from "svelte-keydown";

let combo = [];
</script>

<Keydown separator="+" on:combo={(e) => (combo = [...combo, e.detail])} />

{combo.join(", ")}
```

## API

### Forwarded events

- `on:keyup`
- `on:keydown`

### Dispatched events

#### `on:[Key]`

Example:

```svelte no-eval
<Keydown on:Enter />
<Keydown on:Escape />
<Keydown on:Space />
```

#### `on:key`

Alternative API to `on:[Key]`.

Example:

```svelte
<script>
  import Keydown from "svelte-keydown";

let keys = [];
</script>

<Keydown on:key={({ detail }) => (keys = [...keys, detail])} />

<pre>{JSON.stringify(keys, null, 2)}</pre>
```

#### `on:combo`

Triggered when a sequence of keys are pressed and cleared when a keyup event is fired.

Examples:

- "Shift-S"
- "Meta-c" (Copy)
- "Meta-v" (Paste)

```svelte
<script>
  import Keydown from "svelte-keydown";

let combos = [];
</script>

<Keydown on:combo={({ detail }) => (combos = [...combos, detail])} />

<pre>{JSON.stringify(combos, null, 2)}</pre>
```

## TypeScript

Svelte version 3.31 or greater is required to use this component with TypeScript.

TypeScript definitions are located in the [types folder](./types).

## Changelog

[CHANGELOG.md](CHANGELOG.md)

## License

[MIT](LICENSE)

[npm]: https://img.shields.io/npm/v/svelte-keydown.svg?color=%23ff3e00&style=for-the-badge
[npm-url]: https://npmjs.com/package/svelte-keydown

svelte-keydown

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README