0Pricing
TypeScript Academy · 课时

事件类型、自定义事件；收窄 HTMLElement 子类型

使用正确的类型处理 DOM 事件，创建带负载的 CustomEvent，并安全地收窄 HTMLElement 子类型。

事件类型、自定义事件；收窄 HTMLElement 子类型 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 2 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 3 节课。

简介

目标：添加带类型的事件监听器，安全地收窄元素，并使用带负载的 CustomEvent。

  • 事件类型（MouseEvent、KeyboardEvent、InputEvent）
  • 使用 instanceof 收窄 target/currentTarget
  • CustomEvent 的 detail 负载

带类型的监听器

监听器签名由事件名称决定类型：click → MouseEvent、keydown → KeyboardEvent。请添加明确的注解以提高可读性。

const btn = document.querySelector("#btn");
if (btn) {
  btn.addEventListener("click", (ev: MouseEvent) => {
    console.log("x=", ev.clientX, "y=", ev.clientY);
  });
}

window.addEventListener("keydown", (ev: KeyboardEvent) => {
  console.log("key=", ev.key);
});

target 与 currentTarget

target 是最初的来源，类型可能很多；currentTarget 是监听器的接收者。使用 instanceof 收窄后，再调用元素 API。

document.addEventListener("input", (ev: InputEvent) => {
  const t = ev.target;
  const c = ev.currentTarget; // here: Document
  if (t instanceof HTMLInputElement) {
    console.log("value=", t.value);
  }
});

CustomEvent 负载

CustomEvent<T> 携带带类型的 detail 负载。请使用匹配的泛型参数来分派和处理它。

type CounterDetail = { delta: number };

const inc = new CustomEvent<CounterDetail>("counter:change", {
  detail: { delta: 1 }
});

document.dispatchEvent(inc);

document.addEventListener("counter:change", (ev: CustomEvent<CounterDetail>) => {
  console.log("delta=", ev.detail.delta);
});

子类型收窄

使用 instanceof 将类型细化为特定的 HTML 元素类（例如 HTMLButtonElement、HTMLAnchorElement）。

document.addEventListener("click", (ev: MouseEvent) => {
  const el = ev.target;
  if (el instanceof HTMLButtonElement) {
    el.disabled = true; // safe: HTMLButtonElement API
  } else if (el instanceof HTMLAnchorElement) {
    console.log("href=", el.href);
  }
});

事件委托与守卫

事件委托：在较高层级（document）进行监听，然后查找匹配的元素，并在访问 API 前对其进行收窄。

document.addEventListener("click", (ev: MouseEvent) => {
  const el = ev.target as Element | null;
  if (!el) return;
  const btn = el.closest("button.btn-primary");
  if (btn instanceof HTMLButtonElement) {
    console.log("delegated click on:", btn.textContent);
  }
});

收窄检查

快速检查：在事件处理器中访问元素专属 API 的最安全方式是什么？

回顾

回顾：事件名称会暗示事件类型。使用 instanceof 收窄 target/currentTarget，并将数据放入 CustomEvent<T> 的 detail 中。

常见问题解答

「事件类型、自定义事件；收窄 HTMLElement 子类型」课时是免费的吗？

是的 — 「事件类型、自定义事件；收窄 HTMLElement 子类型」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 3 节课。

「事件类型、自定义事件；收窄 HTMLElement 子类型」这节课中我会学到什么？

使用正确的类型处理 DOM 事件，创建带负载的 CustomEvent，并安全地收窄 HTMLElement 子类型。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 3 节。

「事件类型、自定义事件；收窄 HTMLElement 子类型」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. lib DOM 类型与 querySelector（严格空值检查）
  2. 事件类型、自定义事件；收窄 HTMLElement 子类型
  3. 使用 FormData、URL 与 URLSearchParams
← 返回 TypeScript Academy