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

جلسه‌ی 17: صفحه‌کلید Keyboard

فشردن یک کلید هم یک رویداد است. یاد می‌گیری کل صفحه به صفحه‌کلید گوش بدهد، با event.key بفهمی کدام کلید زده شد، و لامپ و در و تابلو را با کلیدها کنترل کنی.

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

درس

کلیک تنها رویداد نیست. فشردن یک کلید هم رویداد است و اسمش keydown است. کلید مال هیچ دکمه‌ای نیست، پس به کل صفحه می‌گوییم گوش بدهد: document.addEventListener("keydown", flip). اجرا کن، یک بار روی صفحه‌ی نتیجه کلیک کن تا صدای کلیدها را بشنود، و بعد هر کلیدی را بزن.

<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>
let lamp = document.getElementById("lamp");

function flip() {
  lamp.classList.toggle("on");
}

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

کدام کلید بود؟ بسته‌ی event این را هم می‌داند: event.key اسم کلید است. این برنامه اسم هر کلیدی را که بزنی نشان می‌دهد. امتحان کن: حرف‌ها (a)، عددها (7)، Enter، جهت‌ها و فاصله. می‌بینی که Enter می‌شود 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>
let line = document.getElementById("msg");

function show(event) {
  line.textContent = event.key;
}

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

حالا با if برای هر کلید کاری بکن. اینجا کلید o لامپ را روشن و کلید f آن را خاموش می‌کند. بقیه‌ی کلیدها هیچ کاری نمی‌کنند، چون هیچ‌کدام از شرط‌ها درست نمی‌شود. اسم کلید همیشه متن است، پس داخل گیومه می‌آید.

<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>
<p id="msg">o = on, f = off</p>

<script>
let lamp = document.getElementById("lamp");

function press(event) {
  if (event.key === "o") {
    lamp.classList.add("on");
  } else if (event.key === "f") {
    lamp.classList.remove("on");
  }
}

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

کلیدهای جهت برای کم و زیاد کردن عالی‌اند. اسمشان ArrowUp، ArrowDown، ArrowLeft و ArrowRight است. اینجا جهت بالا یکی به عدد تابلو اضافه می‌کند و جهت پایین یکی کم می‌کند، مثل دکمه‌های صدای تلویزیون.

<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; margin: 12px auto; padding: 10px; border-radius: 12px; background: #e2e8f0; }
</style>

<div id="board" class="board">0</div>

<script>
let board = document.getElementById("board");
let volume = 0;

function change(event) {
  if (event.key === "ArrowUp") {
    volume++;
  } else if (event.key === "ArrowDown") {
    volume--;
  }
  board.textContent = volume;
}

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

برای صفحه‌کلید، o و O دو کلید جدا هستند. اگر Caps Lock روشن باشد، event.key می‌شود "O" و شرط event.key === "o" درست نیست. راه ساده: هر دو را با || بپذیر. کلید فاصله هم اسم عجیبی دارد: یک گیومه با یک جای خالی داخلش، " ".

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
.door { font-size: 70px; width: 110px; margin: 12px auto; border-radius: 12px; background: #92400e; }
.door.open { background: #86efac; }
</style>

<div id="door" class="door">🚪</div>
<p id="msg">o = open, space = close</p>

<script>
let door = document.getElementById("door");

function press(event) {
  if (event.key === "o" || event.key === "O") {
    door.classList.add("open");
  } else if (event.key === " ") {
    door.classList.remove("open");
  }
}

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

اشتباه‌های رایج: اسم رویداد همه‌اش حروف کوچک است: "keydown"، نه "keyDown". اسم کلیدهای خاص با حرف بزرگ شروع می‌شود و باید کامل باشد: "ArrowUp"، نه "Up" یا "arrowup". اگر مطمئن نیستی اسم یک کلید چیست، برنامه‌ی کارت دوم را اجرا کن و کلید را بزن.

همین در پایتون: پایتونِ ساده به تک‌تک کلیدها گوش نمی‌دهد؛ input() صبر می‌کند تا Enter را بزنی و بعد همه‌ی متن را می‌دهد. ولی در کتابخانه‌های بازی‌سازی پایتون همین فکر هست: یک رویداد می‌رسد و با if می‌پرسی کدام کلید بود.

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

چالش‌ها

  1. Any Key (آسان)
  2. Show the Key (آسان)
  3. O and F (متوسط)
  4. Arrows Count (متوسط)
  5. Door Keys (سخت)
  6. Find the Bugs (سخت)

بیشتر بخوان

← جلسه‌ی 16: کدام دکمه؟ جلسه‌ی 18: تایپ و دیمر →