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

جلسه‌ی 5: لیست Lists

داده‌ی اپ را در یک آرایه نگه می‌داری و با تابع render() آن را روی صفحه می‌کشی: لیست کارهایت روی صفحه می‌آید.

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

درس

هر اپ لیست‌دار (کارهای روزانه، خرید، دفتر لغت) دو بخش دارد: داده و صفحه. داده یک آرایه است و هر خانه‌اش یک شیء است: یک بسته با چند برچسب. { text: "Feed the cat", done: false } یعنی متن کار و اینکه انجام شده یا نه.

<p id="out"></p>
<script>
let todos = [
  { text: "Feed the cat", done: false },
  { text: "Read a book", done: true },
];
document.getElementById("out").textContent =
  todos.length + " tasks. The second one is: " + todos[1].text;
</script>

برای ساختن یک تکه‌ی تازه از صفحه سه کار می‌کنیم: document.createElement("li") یک li تازه می‌سازد، textContent متنش را می‌گذارد، و appendChild آن را داخل لیست می‌چسباند. مثل ساختن یک کارت، نوشتن روی آن و چسباندنش به تخته.

<ul id="list"></ul>
<script>
let li = document.createElement("li");
li.textContent = "Feed the cat";
document.getElementById("list").appendChild(li);
</script>

حالا همین را با یک for برای همه‌ی کارها انجام می‌دهیم و اسمش را render() می‌گذاریم: «لیست را بکش». خط اول render لیست را پاک می‌کند (list.textContent = "")، بعد همه را از اول می‌کشد. اگر پاک نکند، هر بار کارها دوتا دوتا می‌شوند!

<ul id="list"></ul>
<button onclick="render()">Draw again</button>
<script>
let todos = [
  { text: "Feed the cat", done: false },
  { text: "Read a book", done: false },
];
function render() {
  let list = document.getElementById("list");
  list.textContent = "";
  for (let i = 0; i < todos.length; i++) {
    let li = document.createElement("li");
    li.textContent = todos[i].text;
    list.appendChild(li);
  }
}
render();
</script>

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

<p id="a"></p>
<p id="b"></p>
<script>
let typed = "<b>Hi</b> <i>there</i>";
document.getElementById("a").innerHTML = typed;
document.getElementById("b").textContent = typed;
</script>

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

<style>.done { text-decoration: line-through; color: gray; }</style>
<ul id="list"></ul>
<button onclick="todos[0].done = true; render()">Finish the first task</button>
<script>
let todos = [
  { text: "Feed the cat", done: false },
  { text: "Read a book", done: false },
];
function render() {
  let list = document.getElementById("list");
  list.textContent = "";
  for (let i = 0; i < todos.length; i++) {
    let li = document.createElement("li");
    li.textContent = todos[i].text;
    if (todos[i].done) li.classList.add("done");
    list.appendChild(li);
  }
}
render();
</script>

کاربر و برنامه‌نویس: با بغل‌دستی‌ات بازی کن. یکی کاربر است و کارهای عجیب پیشنهاد می‌دهد: متن خیلی بلند، <b>، شکلک 🐱. دیگری باید بگوید لیستش با textContent چه نشان می‌دهد.

همین در پایتون: در پایتون هم لیستی از دیکشنری‌ها داری: todos = [{"text": "Feed the cat", "done": False}] و «کشیدن» آن یعنی for t in todos: print(t["text"]).

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

چالش‌ها

  1. Draw the List (آسان)
  2. Shopping List (آسان)
  3. Clear Before Drawing (آسان)
  4. Mark Done Items (متوسط)
  5. Data First (متوسط)
  6. Safe Text (متوسط)
  7. Empty Message (سخت)
  8. Two Lists (سخت)

بیشتر بخوان

← جلسه‌ی 4: پروژه: اپ «درباره‌ی من» جلسه‌ی 6: افزودن →