بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 32: رویدادها با نوع Events with Types

کلیک و کلید هر کدام نوع خودشان را دارند: MouseEvent و KeyboardEvent. می‌بینی تایپ‌اسکریپت از روی اسم رویداد نوعش را می‌فهمد، و چرا قبل از استفاده از event.target باید بپرسی «این دقیقاً چیست؟».

در این جلسه یاد می‌گیری

درس

رضا می‌خواست بداند کاربر چه کلیدی زده، ولی کدش را روی کلیک گذاشت. در جاوااسکریپت هیچ خطایی نمی‌آمد و صفحه می‌نوشت You pressed undefined. کلیکِ موس که کلید ندارد! این‌جا همان کد خط قرمز دارد. اجرا کن: چیزی به اسم key در رویداد کلیک نیست. (تایپ‌اسکریپت اسمش را PointerEvent می‌نویسد: همان MouseEvent است، به‌علاوه‌ی چند چیز برای انگشت و قلم.)

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
</style>

<button id="go">Press me</button>
<p id="msg"></p>

<script type="text/typescript">
const go = document.getElementById("go");
const msg = document.getElementById("msg");

if (go && msg) {
  go.addEventListener("click", (event) => {
    msg.textContent = "You pressed " + event.key;
  });
}
</script>

تایپ‌اسکریپت از کجا فهمید؟ از اسم رویداد. وقتی می‌نویسی addEventListener("click", ...)، می‌داند event یک MouseEvent است: رویدادِ موس. MouseEvent این‌ها را دارد: clientX و clientY (جای کلیک در صفحه). نوع event را ننوشته‌ایم، ولی تایپ‌اسکریپت خودش حدس زده است. روی جعبه‌ی خاکستری کلیک کن.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
.board { font-size: 40px; width: 200px; max-width: 100%; margin: 12px auto; padding: 10px; border-radius: 12px; background: #e2e8f0; }
</style>

<div id="pad" class="board">Click</div>
<p id="msg"></p>

<script type="text/typescript">
const pad = document.getElementById("pad");
const msg = document.getElementById("msg");

if (pad && msg) {
  pad.addEventListener("click", (event) => {
    msg.textContent = "Clicked at " + event.clientX + ", " + event.clientY;
  });
}
</script>

برای کلید، اسم رویداد "keydown" است و نوعش KeyboardEvent: رویدادِ صفحه‌کلید. KeyboardEvent چیزی دارد که MouseEvent ندارد: key، یعنی اسم کلید، مثل "a"، "Enter" یا "ArrowUp". اول یک بار روی صفحه کلیک کن، بعد یک کلید بزن.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
</style>

<p id="msg">Press a key</p>

<script type="text/typescript">
const msg = document.getElementById("msg");

document.addEventListener("keydown", (event) => {
  if (msg) {
    msg.textContent = "Key: " + event.key;
  }
});
</script>

گاهی تابعِ رویداد را جدا و با اسم می‌نویسی. آن‌وقت تایپ‌اسکریپت دیگر نمی‌تواند نوع ورودی را حدس بزند (جلسه‌ی ۶ یادت هست: ورودیِ بدون نوع، خط قرمز است). پس خودت می‌نویسی: function onKey(event: KeyboardEvent): void. بعد فقط اسم تابع را به addEventListener می‌دهی، بدون پرانتز. روی صفحه کلیک کن و Enter را بزن.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
.lamp { font-size: 80px; width: 130px; margin: 12px auto; border-radius: 24px; background: #334155; filter: grayscale(1); opacity: 0.5; }
.lamp.on { background: #fde047; filter: none; opacity: 1; }
</style>

<div id="lamp" class="lamp">💡</div>

<script type="text/typescript">
const lamp = document.getElementById("lamp");

function onKey(event: KeyboardEvent): void {
  if (lamp && event.key === "Enter") {
    lamp.classList.add("on");
  }
}

document.addEventListener("keydown", onKey);
</script>

حالا همان اشتباه رضا را با تابعِ اسم‌دار تکرار می‌کنیم: تابعی را که KeyboardEvent می‌خواهد، به رویداد "click" می‌دهیم. اجرا کن: خط قرمز! تایپ‌اسکریپت اسم رویداد را با نوع ورودیِ تابع مقایسه می‌کند. "click" رویداد موس می‌فرستد، ولی onKey رویداد صفحه‌کلید می‌خواهد. این دو با هم جور نیستند.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
.lamp { font-size: 80px; width: 130px; margin: 12px auto; border-radius: 24px; background: #334155; filter: grayscale(1); opacity: 0.5; }
.lamp.on { background: #fde047; filter: none; opacity: 1; }
</style>

<div id="lamp" class="lamp">💡</div>

<script type="text/typescript">
const lamp = document.getElementById("lamp");

function onKey(event: KeyboardEvent): void {
  if (lamp && event.key === "Enter") {
    lamp.classList.add("on");
  }
}

document.addEventListener("click", onKey);
</script>

event.target یعنی «رویداد روی چه چیزی اتفاق افتاد؟». در دوره‌ی جاوااسکریپت با آن یک تابع برای چند دکمه نوشتی. این‌جا خط قرمز می‌گیری. اجرا کن. چرا؟ چون کلیک ممکن است روی هر چیزی باشد: یک دکمه، یک عکس، جای خالیِ صفحه. برای همین نوع event.target خیلی کلی است: EventTarget | null. نه textContent دارد، نه value، و شاید اصلاً null باشد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#colors { padding: 16px; border-radius: 12px; background: #e2e8f0; }
</style>

<div id="colors">
  <button id="red">Red</button>
  <button id="green">Green</button>
  <button id="blue">Blue</button>
</div>
<p id="msg"></p>

<script type="text/typescript">
const msg = document.getElementById("msg");

document.addEventListener("click", (event) => {
  if (msg) {
    msg.textContent = "You chose " + event.target.textContent;
  }
});
</script>

راهش باریک کردن است، مثل typeof در جلسه‌ی ۱۶. برای چیزهای صفحه از instanceof استفاده می‌کنیم: target instanceof HTMLButtonElement می‌پرسد «این یک دکمه است؟». داخل آن if، تایپ‌اسکریپت می‌داند target یک دکمه است و textContent دارد. یک فایده‌ی دیگر: اگر روی جای خالیِ جعبه کلیک کنی، دیگر پیام عوض نمی‌شود. امتحان کن.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#colors { padding: 16px; border-radius: 12px; background: #e2e8f0; }
</style>

<div id="colors">
  <button id="red">Red</button>
  <button id="green">Green</button>
  <button id="blue">Blue</button>
</div>
<p id="msg"></p>

<script type="text/typescript">
const msg = document.getElementById("msg");

document.addEventListener("click", (event) => {
  const target = event.target;
  if (msg && target instanceof HTMLButtonElement) {
    msg.textContent = "You chose " + target.textContent;
  }
});
</script>

برای کادر متن هم همین است. رویداد "input" هر بار که چیزی نوشته می‌شود اتفاق می‌افتد. اگر بپرسی target instanceof HTMLInputElement، داخل if می‌توانی target.value را بخوانی. اشتباه رایج: به‌جای باریک کردن بنویسی event.target as HTMLInputElement. این یک قول است و اگر رویداد از جای دیگری بیاید، برنامه بی‌صدا غلط کار می‌کند. instanceof واقعاً بررسی می‌کند.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
</style>

<input id="name" type="text" placeholder="Type here">
<p id="msg"></p>

<script type="text/typescript">
const msg = document.getElementById("msg");

document.addEventListener("input", (event) => {
  const target = event.target;
  if (msg && target instanceof HTMLInputElement) {
    msg.textContent = "Hello, " + target.value;
  }
});
</script>

مثال‌های این جلسه

چالش‌ها

  1. The Wrong Event (آسان)
  2. Press Enter (آسان)
  3. Arrow Keys (متوسط)
  4. Which Button? (متوسط)
  5. Find the Red Lines (سخت)
  6. The Light Board (سخت)

بیشتر بخوان

← جلسه‌ی 31: صفحه هم نوع دارد جلسه‌ی 33: داده از بیرون →