onStartTyping

类别

传感器

导出体积

772 B

上次更改

6 minutes ago

当用户在不可编辑的元素上开始输入时触发。用于当用户在页面任意位置开始输入时，自动聚焦输入框。

示例

源码playground (beta)

输入任何内容

用法

<script setup lang="ts">
import { onStartTyping } from '@vueuse/core'
import { useTemplateRef } from 'vue'

const input = useTemplateRef('input')

onStartTyping(() => {
  if (!input.value.active)
    input.value.focus()
})
</script>

<template>
  <input ref="input" type="text" placeholder="开始输入以聚焦">
</template>

工作原理

回调函数仅在以下情况触发：

• 没有可编辑元素（<input>、<textarea> 或 contenteditable）被聚焦
• 按下的键是字母数字键（A-Z，0-9）
• 未按下任何修饰键（Ctrl、Alt、Meta）

这允许用户在页面任意位置开始输入，而不会在使用快捷键或与表单字段交互时意外触发回调。

类型声明

/**
 * 用户在不可编辑的元素上开始输入时触发回调。
 *
 * @see https://vueuse.org/onStartTyping
 * @param callback
 * @param options
 */
export declare function onStartTyping(
  callback: (event: KeyboardEvent) => void,
  options?: ConfigurableDocument,
): void

源码

源码 • 演示 • 文档

贡献者

一纸忘忧

更新日志

没有最近的更新日志