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

جلسه‌ی 32: فهرست را بکش Drawing a List

یاد می‌گیری حقیقت را در یک آرایه نگه داری و صفحه را از روی آن بکشی. یک تابع render می‌نویسی که فهرست را خالی می‌کند و از نو می‌کشد، و می‌فهمی چرا متن کاربر را باید با textContent نوشت.

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

درس

جلسه‌ی قبل liها را یکی‌یکی به صفحه اضافه کردی. ولی برنامه خودش نمی‌دانست چه چیزهایی در فهرست هست؛ فقط صفحه می‌دانست. راه بهتر: فهرست را در یک آرایه نگه دار و صفحه را از روی آرایه بکش. این برنامه سه چیز در آرایه دارد و تابع render آن‌ها را می‌کشد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
ul { list-style: none; padding: 0; max-width: 260px; margin: 12px auto; }
li { padding: 8px; margin: 4px 0; border-radius: 8px; background: #e2e8f0; overflow-wrap: anywhere; }
li.done { background: #86efac; text-decoration: line-through; }
</style>

<ul id="list"></ul>

<script>
let items = ["Milk", "Bread", "Eggs"];
let list = document.getElementById("list");

function render() {
  list.textContent = "";
  for (let item of items) {
    let li = document.createElement("li");
    li.textContent = item;
    list.append(li);
  }
}

render();
</script>

render یعنی «بکش». دو کار می‌کند. اول list.textContent = ""; فهرست روی صفحه را خالی می‌کند. بعد حلقه برای هر چیزِ آرایه یک li می‌سازد و در فهرست می‌گذارد. چرا اول خالی می‌کنیم؟ چون render بارها صدا زده می‌شود. اگر خالی نکنی، بار دوم همه چیز دو بار دیده می‌شود.

حالا قانون طلایی: اول آرایه را عوض کن، بعد render() را صدا بزن. برای اضافه کردن، دیگر خودت li نمی‌سازی؛ فقط items.push(...) و بعد render(). برای برداشتن آخری هم items.pop() و بعد render(). صفحه همیشه عکسِ آرایه است.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
ul { list-style: none; padding: 0; max-width: 260px; margin: 12px auto; }
li { padding: 8px; margin: 4px 0; border-radius: 8px; background: #e2e8f0; overflow-wrap: anywhere; }
li.done { background: #86efac; text-decoration: line-through; }
</style>

<input id="item" aria-label="Item" placeholder="Milk">
<button id="add" onclick="addItem()">Add</button>
<button id="undo" onclick="undo()">Undo</button>
<ul id="list"></ul>
<p id="msg"></p>

<script>
let items = ["Milk"];
let list = document.getElementById("list");
let box = document.getElementById("item");

function render() {
  list.textContent = "";
  for (let item of items) {
    let li = document.createElement("li");
    li.textContent = item;
    list.append(li);
  }
}

function addItem() {
  items.push(box.value);
  box.value = "";
  render();
}

function undo() {
  items.pop();
  render();
}

render();
</script>

چون همه چیز در آرایه است، render می‌تواند چیزهای دیگر را هم بنویسد. مثلاً تعداد: items.length. این خط را ته render بگذار و دیگر لازم نیست جای دیگری به آن فکر کنی. هر بار که فهرست کشیده می‌شود، عدد هم درست می‌شود.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
ul { list-style: none; padding: 0; max-width: 260px; margin: 12px auto; }
li { padding: 8px; margin: 4px 0; border-radius: 8px; background: #e2e8f0; overflow-wrap: anywhere; }
li.done { background: #86efac; text-decoration: line-through; }
</style>

<ul id="list"></ul>
<button id="more" onclick="addTea()">Add Tea</button>
<p id="msg"></p>

<script>
let items = ["Milk", "Bread"];
let list = document.getElementById("list");
let line = document.getElementById("msg");

function render() {
  list.textContent = "";
  for (let item of items) {
    let li = document.createElement("li");
    li.textContent = item;
    list.append(li);
  }
  line.textContent = "Items: " + items.length;
}

function addTea() {
  items.push("Tea");
  render();
}

render();
</script>

آرایه می‌تواند پر از شیء باشد. اینجا هر کار یک text و یک done دارد. render به کارهای انجام‌شده کلاس done می‌دهد تا سبز و خط‌خورده شوند. کلیک روی هر کار done همان شیء را برعکس می‌کند و بعد... بله، render(). روی کارها کلیک کن.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
ul { list-style: none; padding: 0; max-width: 260px; margin: 12px auto; }
li { padding: 8px; margin: 4px 0; border-radius: 8px; background: #e2e8f0; overflow-wrap: anywhere; }
li.done { background: #86efac; text-decoration: line-through; }
</style>

<ul id="list"></ul>

<script>
let tasks = [
  { text: "Homework", done: true },
  { text: "Feed the cat", done: false }
];
let list = document.getElementById("list");

function render() {
  list.textContent = "";
  for (let task of tasks) {
    let li = document.createElement("li");
    li.textContent = task.text;
    if (task.done) {
      li.classList.add("done");
    }
    li.addEventListener("click", () => {
      task.done = !task.done;
      render();
    });
    list.append(li);
  }
}

render();
</script>

چرا textContent؟ یک چیز دیگر هم هست به اسم innerHTML. فرقشان مهم است. textContent هر چه بدهی را مثل متن نشان می‌دهد. innerHTML آن را مثل HTML می‌خواند. اگر کاربری در کادر بنویسد <h1>Hi</h1>، با innerHTML یک تگ واقعی وارد صفحه‌ی تو می‌شود. یک آدم بدجنس می‌تواند این‌طوری صفحه را به هم بریزد یا کد خودش را در صفحه‌ی تو اجرا کند. پس قانون: متنی که از کاربر آمده همیشه با textContent. در این کادر یک تگ بنویس و ببین فقط متنش دیده می‌شود.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
ul { list-style: none; padding: 0; max-width: 260px; margin: 12px auto; }
li { padding: 8px; margin: 4px 0; border-radius: 8px; background: #e2e8f0; overflow-wrap: anywhere; }
li.done { background: #86efac; text-decoration: line-through; }
</style>

<input id="item" aria-label="Item" placeholder="Milk">
<button id="add" onclick="addItem()">Add</button>
<ul id="list"></ul>

<script>
let items = ["<h1>Hi</h1>"];
let list = document.getElementById("list");
let box = document.getElementById("item");

function render() {
  list.textContent = "";
  for (let item of items) {
    let li = document.createElement("li");
    li.textContent = item;
    list.append(li);
  }
}

function addItem() {
  items.push(box.value);
  box.value = "";
  render();
}

render();
</script>

اشتباه رایج: آرایه را عوض می‌کنی ولی render() را صدا نمی‌زنی. آرایه درست است، ولی صفحه هنوز عکس قدیمی را نشان می‌دهد و فکر می‌کنی دکمه خراب است. هر جا push، pop یا عوض کردن یک خانه دیدی، خط بعدش باید render(); باشد.

همین در پایتون: آنجا هم فهرست را در یک لیست نگه می‌داشتی و با یک حلقه چاپش می‌کردی: for item in items: و زیرش print(item). بعد از هر تغییر، دوباره همان حلقه را اجرا می‌کردی. render همان حلقه‌ی چاپ است، فقط به جای print روی صفحه می‌کشد.

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

چالش‌ها

  1. Draw the List (آسان)
  2. Empty First (آسان)
  3. Add from the Box (متوسط)
  4. Count and Undo (متوسط)
  5. Done Tasks (سخت)
  6. Find the Bugs (سخت)

بیشتر بخوان

← جلسه‌ی 31: چیز تازه بساز جلسه‌ی 33: کمی بعد →