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

جلسه‌ی 2: اولین پنجره My First Window

اپ از ترمینال بیرون می‌آید و در یک پنجره‌ی گوشی دیده می‌شود: import app، عنوان با app.title، متن با app.text و دکمه با app.button. با زدن دکمه یک تابع اجرا می‌شود و متن را عوض می‌کند، و با global یک شمارنده می‌سازی.

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

درس

خداحافظ ترمینال، سلام گوشی! خط import app یک پنجره‌ی گوشی کنار ادیتور روشن می‌کند. app.title نوار بالای صفحه است و app.text یک خط متن. خط آخر همیشه app.run() است: «حالا اپ را نشان بده و منتظر کاربر بمان». اجرا کن و پنجره را ببین.

import app

app.title("My First App")
app.text("Hello! This is my first app.")
app.text("Made with Python.")
app.run()

حالا دکمه! app.button("Hello", say_hello) دکمه‌ای با برچسب Hello می‌سازد. هر بار کاربر آن را بزند، تابع say_hello اجرا می‌شود. note = app.text(...) متن را در جعبه‌ی note نگه می‌دارد تا بعدا با note.value = "..." عوضش کنیم. دکمه را بزن!

import app

def say_hello():
    note.value = "Hello, Reza!"

app.title("Hello App")
note = app.text("Press the button.")
app.button("Hello", say_hello)
app.run()

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

بدون پرانتز! در app.button("Hello", say_hello) اسم تابع را بدون () می‌دهیم. معنی‌اش این است: «این تابع را نگه دار و هر وقت دکمه را زدند اجرایش کن». اگر بنویسی say_hello()، تابع همان لحظه یک بار اجرا می‌شود و دکمه دیگر کاری نمی‌کند.

ترتیب برنامه: ۱) import app ۲) تابع‌ها ۳) صفحه از بالا به پایین: عنوان، متن‌ها، دکمه‌ها ۴) app.run(). تابع باید قبل از دکمه‌اش تعریف شده باشد، وگرنه پایتون اسمش را نمی‌شناسد و NameError می‌دهد.

شمارنده با global. متغیری که بیرون از تابع ساخته شده، مثل count، مال کل برنامه است. تابع می‌تواند آن را بخواند، ولی برای عوض کردنش باید اول بگوید global count: «همان count بیرونی را می‌خواهم، نه یکی تازه». بدون آن، پایتون خطای UnboundLocalError می‌دهد. چند بار Tap را بزن.

import app

count = 0

def tap():
    global count
    count = count + 1
    note.value = f"Taps: {count}"

app.title("Tap Counter")
note = app.text("Taps: 0")
app.button("Tap", tap)
app.run()

راه دیگر بدون global: عدد را داخل یک لیست بگذار، count = [0]. تابع خود لیست را عوض نمی‌کند، فقط خانه‌ی اولش را: count[0] = count[0] + 1. هر دو راه درست است؛ هر کدام راحت‌تری.

متن اپ می‌تواند فارسی هم باشد، چون متن فقط داده است. ولی در این دوره برچسب‌ها و متن‌ها را انگلیسی می‌نویسیم تا بررسی جواب‌ها ساده باشد. برای اپ خودت هر زبانی دوست داری!

import app

def salam():
    note.value = "سلام دوست من!"

app.title("اپ من")
note = app.text("دکمه را بزن.")
app.button("سلام", salam)
app.run()

اشتباه‌های رایج: app.run() را فراموش کنی (هیچ پنجره‌ای نمی‌آید)، چیزی را بعد از app.run() بنویسی (هیچ‌وقت به صفحه نمی‌رسد)، و برچسب دکمه را با کلمه‌ی دیگری بنویسی. برچسب همان کلمه‌ای است که کاربر می‌بیند و بررسی‌کننده با آن دکمه را پیدا می‌کند.

همین در HTML: در /learn/app-web دکمه‌ی <button onclick="sayHello()"> همان app.button("Hello", say_hello) است و textContent همان note.value. آنجا هم صفحه برای گوشی ساخته می‌شود، با meta viewport و دکمه‌های بزرگ.

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

چالش‌ها

  1. Why No Brackets? (آسان)
  2. Water App (آسان)
  3. Hello Button (آسان)
  4. Put the App in Order (متوسط)
  5. Glass Counter (متوسط)
  6. Morning and Night (متوسط)
  7. Score and Reset (سخت)
  8. Traffic Light (سخت)

بیشتر بخوان

← جلسه‌ی 1: اپ چیست؟ جلسه‌ی 3: ورودی →