灏天阁

前端快速实现快捷键功能,超实用!

· Yin灏

如今,Web 应用越来越普及,人们使用它们来处理越来越多的任务。为了提高用户的效率和工作流程,许多 Web 应用都提供了键盘快捷键。通过使用键盘快捷键,用户可以快速地进行常见任务,而不需要通过鼠标导航和点击不同的按钮。在前端开发中,实现键盘快捷键功能需要编写大量的 JavaScript 代码。为了简化这个过程,出现了一些优秀的前端快捷键工具库。本文将介绍几个流行的前端快捷键工具库,帮助你快速实现键盘快捷键功能!

Mousetrap

Mousetrap 是一个 JavaScript 库,它提供了一种简单的方式来捕获键盘输入,用于创建键盘快捷键等交互式功能。它可以轻松地绑定键盘按键和组合键到回调函数,从而帮助开发者快速实现一些特定的功能,如全屏切换、复制粘贴数据等。Mousetrap 的使用非常方便,只需要引入相应的 JavaScript 文件并设置监听器即可。它支持键盘事件的无冲突处理,也可以在特定的区域禁用或启用监听器。

这个库与其他类似的库相比有以下几个不同之处:

  • 没有外部依赖,不需要使用其他框架。
  • 不仅支持 keydown 事件,还可以指定 keypresskeydownkeyup 事件,或者直接让 Mousetrap 自动选择。
  • 可以将键盘事件直接绑定到特殊键,如?或*,而无需指定 shift+/ 或 shift+8 等在所有键盘上都不一致的键。
  • 支持国际键盘布局。
  • 可以绑定类似 Gmail 的键序列,除了常规按键和键组合之外。
  • 可以使用 trigger() 方法编程触发键盘事件。
  • 支持计算机键盘上的数字键。
  • 代码有详细的文档和注释。

Mousetrap 可以通过 npm 安装使用。具体步骤如下:

  1. 打开终端或命令行工具,进入项目目录。运行以下命令来安装 Mousetrap:
npm install mousetrap
  1. 在 JavaScript 文件中引入 Mousetrap:
import Mousetrap from "mousetrap";
  1. 在需要监听键盘事件的地方,创建相应的监听器:
Mousetrap.bind("command+shift+s", function () {
  // 处理键盘事件的回调函数
});

这里绑定了一个组合键(命令键 + shift 键 + s 键)到回调函数,当用户按下该组合键时,会触发回调函数。

Github:github.com/ccampbell/m…

Hotkeys

Hotkeys 是一个用于在 Web 应用中设置和管理键盘快捷键的 JavaScript 库。它允许开发人员使用简单的语法,为应用程序中的各种操作绑定键盘快捷键。这个库可以用来添加、删除和禁用快捷键,还可以与其他 JavaScript 库集成使用。

在一些其他的快捷键库中,开发者可能需要编写大量的代码才能够实现一个简单的功能,而 Hotkeys 库则提供了简洁易用的 API 接口和丰富的事件处理选项。同时,Hotkeys 库具有轻量级、易于使用和灵活可扩展等特点。另外,在 Hotkeys 的官方文档中也提供了详细的文档说明和示例,方便开发人员快速上手使用。

Hotkeys 可以通过 npm 安装使用。具体步骤如下:

  1. 打开终端或命令行工具,进入项目目录。运行以下命令来安装 Hotkeys:
npm install hotkeys-js --save
  1. 在 JavaScript 文件中引入 Hotkeys:
import hotkeys from "hotkeys-js";
  1. 在需要监听键盘事件的地方,创建相应的监听器:
hotkeys("ctrl+a,ctrl+b,r,f", function (event, handler) {
  switch (handler.key) {
    case "ctrl+a":
      alert("you pressed ctrl+a!");
      break;
    case "ctrl+b":
      alert("you pressed ctrl+b!");
      break;
    case "r":
      alert("you pressed r!");
      break;
    case "f":
      alert("you pressed f!");
      break;
    default:
      alert(event);
  }
});

Github:github.com/jaywcjlove/…

Tinykeys

Tinykeys 是一个在 Web 应用中设置和管理键盘快捷键的 JavaScript 库,它比 Hotkeys 更加轻量级和易于使用。该库允许开发人员通过一行代码来为应用程序中的各种操作绑定键盘快捷键。与 Hotkeys 类似,Tinykeys 也具有添加、删除和禁用快捷键以及与其他 JavaScript 库集成使用的功能。

Tinykeys 可以通过 npm 安装使用。具体步骤如下:

  1. 打开终端或命令行工具,进入项目目录。运行以下命令来安装 Tinykeys:
npm install tinykeys
  1. 在需要使用 Tinykeys 的 JavaScript 文件中,通过 import 语句导入 Tinykeys 库:
import tinykeys from "tinykeys";
  1. 使用tinykeys()方法将键盘按键映射到需要执行的功能。例如:
tinykeys(window, {
  "Shift+Enter": (event) => {
    console.log("Shift+Enter has been pressed");
  },
});

Github:github.com/jamiebuilds…

useHotkeys

useHotkeys 是一个 React Hook,用于在 React 函数组件中设置和管理键盘快捷键。useHotkeys 支持大多数键盘和操作系统,并且与其他 React Hooks 和第三方库兼容。

可以通过以下步骤来安装和使用 useHotkeys:

  1. 在命令行中运行以下命令,使用 npm 安装 useHotkeys 库:
npm install react-hotkeys-hook
  1. 在需要使用 useHotkeys 的 React 函数组件中,通过 import 语句导入 useHotkeys 库:
import { useHotkeys } from "react-hotkeys-hook";
  1. 在组件内部调用 useHotkeys() Hook 方法来设置键盘快捷键的响应函数及相关配置:
export const ExampleComponent = () => {
  const [count, setCount] = useState(0);
  useHotkeys("ctrl+k", () => setCount(count + 1), [count]);

  return <p>Pressed {count} times.</p>;
};

Github:github.com/JohannesKla…

其他

很多应用支持使用 cmd(ctrl)+ k 来调出选择框,可以使用快捷键进行后续操作。

Cmdk

⌘K 是一个灵活的 React 组件,可以用于创建命令菜单或可访问的组合框。它支持自定义 API,可以通过组合其他组件或静态 JSX 来实现个性化需求。

使用方式如下:

  1. 安装 cmdk:
npm install cmdk
  1. 使用:
import { Command } from "cmdk";

const CommandMenu = () => {
  const [open, setOpen] = React.useState(false);

  // Toggle the menu when ⌘K is pressed
  React.useEffect(() => {
    const down = (e) => {
      if (e.key === "k" && e.metaKey) {
        setOpen((open) => !open);
      }
    };

    document.addEventListener("keydown", down);
    return () => document.removeEventListener("keydown", down);
  }, []);

  return (
    <Command.Dialog
      open={open}
      onOpenChange={setOpen}
      label="Global Command Menu"
    >
      <Command.Input />
      <Command.List>
        <Command.Empty>No results found.</Command.Empty>

        <Command.Group heading="Letters">
          <Command.Item>a</Command.Item>
          <Command.Item>b</Command.Item>
          <Command.Separator />
          <Command.Item>c</Command.Item>
        </Command.Group>

        <Command.Item>Apple</Command.Item>
      </Command.List>
    </Command.Dialog>
  );
};

Github:github.com/pacocoursey…

Ninja Keys

Ninja Keys 是一个可以集成到网站中的键盘快捷键 UI 组件,支持使用纯 JavaScript、Vue 和 React 来创建自定义的快捷键。在许多应用中,用户会按下 ⌘+k(或 ctrl+k) 打开搜索 UI 界面,Ninja Keys 类似于这一模式。

使用方式如下:

  1. 安装 Ninja Keys:
npm i ninja-keys
  1. 使用:
const ninja = document.querySelector("ninja-keys");
ninja.data = [
  {
    id: "Projects",
    title: "Open Projects",
    hotkey: "ctrl+N",
    icon: "apps",
    section: "Projects",
    handler: () => {
      // it's auto register above hotkey with this handler
      alert("Your logic to handle");
    },
  },
  {
    id: "Theme",
    title: "Change theme...",
    icon: "desktop_windows",
    children: ["Light Theme", "Dark Theme", "System Theme"],
    hotkey: "ctrl+T",
    handler: () => {
      // open menu if closed. Because you can open directly that menu from it's hotkey
      ninja.open({ parent: "Theme" });
      // if menu opened that prevent it from closing on select that action, no need if you don't have child actions
      return { keepOpen: true };
    },
  },
  {
    id: "Light Theme",
    title: "Change theme to Light",
    icon: "light_mode",
    parent: "Theme",
    handler: () => {
      // simple handler
      document.documentElement.classList.remove("dark");
    },
  },
  {
    id: "Dark Theme",
    title: "Change theme to Dark",
    icon: "dark_mode",
    parent: "Theme",
    handler: () => {
      document.documentElement.classList.add("dark");
    },
  },
];

Github:github.com/ssleptsov/n…

- Book Lists -