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

جلسه‌ی 6: افزودن Adding

کادر، دکمه و لیست را به هم وصل می‌کنی: کاربر کار تازه می‌نویسد و Add را می‌زند. اپ متن را تمیز می‌کند، کار خالی یا تکراری را با یک پیام مهربان رد می‌کند و کادر را خالی می‌کند.

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

درس

حالا کاربر خودش کار اضافه می‌کند. box.value متنی است که در کادر نوشته شده. تابع add آن را به داده اضافه می‌کند و طبق قانون طلایی show_list() را صدا می‌زند. یادت باشد در app.button("Add", add) اسم تابع بدون پرانتز می‌آید.

import app

todos = []

def show_list():
    items.clear()
    for t in todos:
        items.add(t)

def add():
    todos.append(box.value)
    show_list()

app.title("My Tasks")
box = app.input("New task")
app.button("Add", add)
items = app.list()
show_list()
app.run()

بعد از افزودن، متن قبلی هنوز در کادر است و کاربر باید خودش پاکش کند. اپ خوب این کار را خودش می‌کند: box.value = "". ولی دقت کن: بعد از append! اگر اول کادر را خالی کنی، یک کار خالی به لیست می‌رود.

اگر کاربر هیچ چیز ننویسد یا فقط چند فاصله بزند چه؟ یک خط خالی به لیست می‌آید! strip() فاصله‌های اول و آخر متن را برمی‌دارد: " Read ".strip() می‌شود "Read" و " ".strip() می‌شود "". اگر متن خالی شد، با app.toast بگو چرا و با return از تابع بیرون برو.

import app

todos = []

def show_list():
    items.clear()
    for t in todos:
        items.add(t)

def add():
    text = box.value.strip()
    if text == "":
        app.toast("Write a task first")
        return
    todos.append(text)
    box.value = ""
    show_list()

app.title("My Tasks")
box = app.input("New task")
app.button("Add", add)
items = app.list()
show_list()
app.run()

کار تکراری هم بی‌فایده است. in می‌پرسد چیزی در لیست هست یا نه: "Read" in todos یعنی True یا False. پس قبل از append بنویس if text in todos: و با یک پیام برگرد. تعداد کارها را هم در show_list بگذار، تا بعد از هر تغییر خودش درست شود: count.value = f"Tasks: {len(todos)}".

این فلوچارت همه‌ی کار دکمه‌ی Add است. قبل از نوشتن کد با انگشت رویش راه برو: یک بار با Milk، یک بار با سه فاصله و یک بار با Milk برای بار دوم.

کاربر و برنامه‌نویس: با بغل‌دستی‌ات بازی کن. یکی کاربرِ خراب‌کار است: هیچ چیز نمی‌نویسد، فقط فاصله می‌زند، یک کار را دو بار می‌نویسد، صد کار پشت هم. دیگری برای هر کدام می‌گوید اپ چه می‌کند و چه پیام دوستانه‌ای نشان می‌دهد، نه یک خطای ترسناک.

همین در HTML: در /learn/app-web کادر و دکمه داخل یک <form> هستند، todos.push(...) همان append است و text.trim() همان strip(). کادر هم با box.value = "" خالی می‌شود، درست مثل این‌جا.

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

چالش‌ها

  1. Add a Task (آسان)
  2. Empty the Box (آسان)
  3. What Does strip Give? (آسان)
  4. No Empty Tasks (متوسط)
  5. How Many? (متوسط)
  6. Add or Refuse? (متوسط)
  7. Not Twice (سخت)
  8. Five Is Enough (سخت)

بیشتر بخوان

← جلسه‌ی 5: لیست روی صفحه جلسه‌ی 7: حذف و تیک →