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

جلسه‌ی 3: ورودی Input

اپ از کاربر چیزی می‌گیرد: کادر متن با app.input و کادر عدد با app.number. یاد می‌گیری .value همیشه متن است، با int() عددش کنی، با .strip() فاصله‌ها را برداری و ورودی خراب (خالی یا abc) را با try / except ValueError و یک app.toast مهربان جواب بدهی.

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

درس

تقریبا هر اپی از کاربر چیزی می‌گیرد: کار تازه، خرج تازه، اسم. box = app.input("Name") یک کادر با برچسب Name می‌سازد. در تابع دکمه، box.value همان متنی است که کاربر نوشته. اسمت را بنویس و Greet را بزن.

import app

def greet():
    answer.value = f"Hello, {box.value}!"

app.title("Greeter")
box = app.input("Name")
app.button("Greet", greet)
answer = app.text("")
app.run()

.value را در تابع بخوان. کد بالای app.run() فقط یک بار اجرا می‌شود، وقتی کادر هنوز خالی است. اگر بیرون از تابع بنویسی name = box.value، همیشه متن خالی می‌گیری! متن کادر را وقتی دکمه زده شد بخوان، یعنی داخل تابع.

کادر عدد. app.number("Age") روی گوشی صفحه‌کلید عددی باز می‌کند. ولی .value باز هم متن است! "3" + "4" می‌شود "34"، نه 7. برای حساب با int() (عدد صحیح) یا float() (عدد اعشاری) آن را عدد کن. ۷ بنویس و Double را بزن.

import app

def double():
    n = int(box.value)
    answer.value = f"Answer: {n * 2}"

app.title("Doubler")
box = app.number("Number")
app.button("Double", double)
answer = app.text("")
app.run()

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

import app

def add():
    task = box.value.strip()
    if task == "":
        app.toast("Write a task first")
        return
    result.value = f"Added: {task}"
    box.value = ""

app.title("Tasks")
box = app.input("Task")
app.button("Add", add)
result = app.text("Nothing added yet.")
app.run()

ورودی خراب. اگر کاربر به‌جای عدد بنویسد abc، int("abc") خطای ValueError می‌دهد و اپ از کار می‌افتد. try یعنی «این را امتحان کن» و except ValueError یعنی «اگر عدد نبود، به‌جای خراب شدن این کار را بکن». کادر خالی هم برای int() خراب است. اول ۳ و بعد abc را امتحان کن.

import app

def calc():
    try:
        cups = int(box.value)
    except ValueError:
        app.toast("Please type a number")
        return
    answer.value = f"That is {cups * 250} ml"

app.title("Water")
box = app.number("Cups")
app.button("Convert", calc)
answer = app.text("")
app.run()

بازی «کاربر خراب‌کار»: یک نفر برنامه‌نویس است و یک نفر کاربری که همه‌چیز را خراب وارد می‌کند: کادر خالی، abc، -5، 12.5، فقط فاصله. برنامه‌نویس برای هر کدام باید یک جواب مهربان داشته باشد، نه یک اپ خراب. جواب‌های بررسی‌کننده هم همیشه چند ورودی خراب امتحان می‌کنند.

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

همین در HTML: در /learn/app-web کادر با <input type="number"> ساخته می‌شود، value آنجا هم متن است و با Number() عدد می‌شود. به‌جای if text == "": آنجا کلمه‌ی required جلوی کادر خالی را می‌گیرد.

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

چالش‌ها

  1. What Is in the Box? (آسان)
  2. Greeter (آسان)
  3. Text Plus Text (آسان)
  4. Doubler (متوسط)
  5. No Empty Tasks (متوسط)
  6. Will int() Work? (متوسط)
  7. Cups to Millilitres (سخت)
  8. Adding Machine (سخت)

بیشتر بخوان

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