جلسهی 3: ورودی Input
اپ از کاربر چیزی میگیرد: کادر متن با app.input و کادر عدد با app.number. یاد میگیری .value همیشه متن است، با int() عددش کنی، با .strip() فاصلهها را برداری و ورودی خراب (خالی یا abc) را با try / except ValueError و یک app.toast مهربان جواب بدهی.
در این جلسه یاد میگیری
- میتوانی با
app.inputوapp.numberکادر بسازی و در تابع دکمهbox.valueرا بخوانی. - میدانی
.valueهمیشه متن است و برای حساب بایدint()یاfloat()بزنی. - میتوانی با
.strip()وif text == "":کادر خالی را بگیری. - میتوانی با
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 جلوی کادر خالی را میگیرد.
مثالهای این جلسه
- مثال تابع (اپ با پایتون): def greet():
- مثال تابع (اپ با پایتون): def double():
- مثال تابع (اپ با پایتون): def add():
- مثال مدیریت خطا با try (اپ با پایتون): try:
چالشها
- What Is in the Box? (آسان)
- Greeter (آسان)
- Text Plus Text (آسان)
- Doubler (متوسط)
- No Empty Tasks (متوسط)
- Will int() Work? (متوسط)
- Cups to Millilitres (سخت)
- Adding Machine (سخت)