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

جلسه‌ی 14: چند صفحه Many Screens

اپ‌های واقعی چند صفحه دارند: خانه، لیست، تنظیمات. امروز با app.screen صفحه می‌سازی، با app.go بین صفحه‌ها جابه‌جا می‌شوی و یک داده را در دو صفحه نشان می‌دهی.

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

درس

به اپ‌های گوشی‌ات نگاه کن: با هر دکمه یک صفحه‌ی دیگر باز می‌شود، مثلاً «خانه»، «لیست»، «تنظیمات». در پایتون هر صفحه با app.screen("name") شروع می‌شود. هر ابزاری که بعد از آن بسازی، روی همان صفحه می‌رود، تا app.screen بعدی. اولین صفحه‌ای که بسازی، اول دیده می‌شود. این اپ دو صفحه دارد ولی هنوز راهی به صفحه‌ی دوم ندارد!

import app

app.screen("home")
app.title("Home")
app.text("Welcome to my app!")

app.screen("about")
app.title("About")
app.text("I made this app in Python.")

app.run()

app.go("about") صفحه‌ی about را نشان می‌دهد. آن را در تابع دکمه می‌نویسی، مثل open_about. برای کارهای یک‌خطی راه کوتاه‌تری هم هست: lambda: app.go("home"). lambda یک تابع کوچک یک‌خطی بی‌اسم است. چرا لازم است؟ چون app.button اسم یک تابع می‌خواهد که بعداً، موقع زدن دکمه، اجرا شود. اگر بنویسی app.button("Back", app.go("home"))، پایتون app.go را همان لحظه اجرا می‌کند و دکمه هیچ کاری نمی‌کند.

import app

def open_about():
    app.go("about")

app.screen("home")
app.title("Home")
app.text("Welcome to my app!")
app.button("About", open_about)

app.screen("about")
app.title("About")
app.text("I made this app in Python.")
app.button("Back", lambda: app.go("home"))

app.run()

این فلوچارت کاری است که app.go می‌کند. اسم صفحه باید دقیقاً همان اسمی باشد که به app.screen دادی: app.go("Settings") با app.screen("settings") کار نمی‌کند، چون حرف بزرگ و کوچک فرق دارند. آن وقت اپ خطای There is no screen "Settings" می‌دهد و اسم صفحه‌های واقعی را هم می‌گوید.

یک الگوی رایج: صفحه‌ی منو با یک دکمه برای هر صفحه، و در هر صفحه یک دکمه‌ی Back که به منو برمی‌گردد. منو را اول از همه بساز تا اپ با آن باز شود. هر صفحه هم عنوان خودش را دارد: app.title را بعد از app.screen همان صفحه بنویس.

import app

app.screen("menu")
app.title("Menu")
app.button("Games", lambda: app.go("games"))
app.button("Music", lambda: app.go("music"))

app.screen("games")
app.title("Games")
app.text("Chess, puzzles, quizzes")
app.button("Back", lambda: app.go("menu"))

app.screen("music")
app.title("Music")
app.text("My playlist")
app.button("Back", lambda: app.go("menu"))

app.run()

صفحه‌ها می‌توانند داده‌ی مشترک داشته باشند. لیست پایتونی words مال کل برنامه است، نه مال یک صفحه. در صفحه‌ی اول کلمه اضافه می‌کنی و در صفحه‌ی دوم آن را در لیست می‌بینی. تابع add می‌تواند لیست صفحه‌ی دیگر را هم عوض کند، حتی وقتی آن صفحه دیده نمی‌شود.

import app

words = []

def add():
    word = box.value.strip()
    if word == "":
        app.toast("Type a word first")
        return
    words.append(word)
    items.add(word)
    box.value = ""
    app.toast("Added!")

app.screen("add")
app.title("New Word")
box = app.input("Word")
app.button("Add", add)
app.button("See words", lambda: app.go("words"))

app.screen("words")
app.title("My Words")
items = app.list()
app.button("Back", lambda: app.go("add"))

app.run()

اشتباه‌های رایج: ۱) دکمه را بعد از app.screen اشتباهی ساختی، پس روی صفحه‌ی دیگری رفت. همیشه نگاه کن آخرین app.screen بالای آن کدام است. ۲) lambda را جا انداختی: app.button("Back", app.go("home")). ۳) اسم صفحه را در app.go با املای دیگری نوشتی. ۴) app.go را قبل از ساختن آن صفحه صدا زدی.

همین در HTML: در دوره‌ی «اپ با HTML» (/learn/app-web) هر صفحه یک section است و تابع show(name) همه را پنهان می‌کند و یکی را نشان می‌دهد. app.screen و app.go همان کار را برایت می‌کنند.

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

چالش‌ها

  1. What Does app.screen Do? (آسان)
  2. Open the About Screen (آسان)
  3. There and Back (آسان)
  4. Which Screen? (متوسط)
  5. A Menu Screen (متوسط)
  6. Add Here, See There (متوسط)
  7. Tap for Details (سخت)
  8. Remember the Last Screen (سخت)

بیشتر بخوان

← جلسه‌ی 13: پروژه: پول توجیبی جلسه‌ی 15: تنظیمات و خطاگیری کامل →