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

جلسه‌ی 15: تنظیمات Settings

اپ تو صفحه‌ی تنظیمات می‌گیرد: حالت تیره با متغیرهای CSS، سلام با اسم کوچک کاربر، و تنظیماتی که بعد از بستن اپ یادش می‌ماند.

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

درس

شب که گوشی را باز می‌کنی، صفحه‌ی سفید چشمت را می‌زند. برای همین اپ‌ها «حالت تیره» دارند. اگر رنگ‌ها را در ده جای CSS نوشته باشی، باید ده جا را عوض کنی. راه زرنگ‌ها: رنگ‌ها را یک بار در متغیر CSS بنویس.

متغیر CSS با دو خط تیره شروع می‌شود: --bg. آن را در :root می‌نویسیم (یعنی کل صفحه) و هر جا لازم است با var(--bg) صدایش می‌زنیم. رنگ --bg را عوض کن و اجرا کن: همه‌جا با هم عوض می‌شود.

<style>
:root { --bg: #fff8e7; --text: #333333; }
body { background-color: var(--bg); color: var(--text); }
button { color: var(--text); }
</style>

<h1>My Diary</h1>
<button>Write</button>

جادوی اصلی: اگر body کلاس dark بگیرد، همان متغیرها مقدار تازه می‌گیرند. قاعده‌ی body.dark { --bg: #121212; } یعنی «وقتی body کلاس dark دارد، --bg تیره است». با classList.toggle("dark") کلاس می‌آید و دوباره که بزنی می‌رود.

<style>
:root { --bg: #ffffff; --text: #222222; }
body.dark { --bg: #121212; --text: #eeeeee; }
body { background-color: var(--bg); color: var(--text); }
</style>

<h1>Settings</h1>
<button onclick="document.body.classList.toggle('dark')">Dark mode</button>

در صفحه‌ی تنظیمات معمولاً یک تیک (checkbox) هست. .checked می‌گوید تیک خورده یا نه: true یا false. با onchange هر بار که تیک عوض شود تابع اجرا می‌شود.

<style>
body.dark { background-color: #121212; color: #eeeeee; }
</style>

<label><input type="checkbox" id="dark" onchange="setDark()"> Dark mode</label>

<script>
function setDark() {
  if (document.getElementById("dark").checked) {
    document.body.classList.add("dark");
  } else {
    document.body.classList.remove("dark");
  }
}
</script>

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

<h1 id="hello">Hello, friend!</h1>
<input id="name" placeholder="Sara">
<button onclick="setName()">OK</button>

<script>
function setName() {
  let name = document.getElementById("name").value.trim();
  if (name === "") {
    document.getElementById("hello").textContent = "Hello, friend!";
  } else {
    document.getElementById("hello").textContent = "Hello, " + name + "!";
  }
}
</script>

تنظیماتی که بعد از بستن اپ پاک شود به درد نمی‌خورد! همه را در یک شیء نگه دار و با salam.save ذخیره کن. وقتی اپ باز می‌شود، آن‌ها را با salam.load بخوان و دوباره به کار ببر. classList.toggle("dark", true) کلاس را می‌گذارد و با false برمی‌دارد. تیک بزن، بعد «شروع دوباره»: اپ یادش می‌ماند.

<style>
body.dark { background-color: #121212; color: #eeeeee; }
</style>

<label><input type="checkbox" id="dark" onchange="change()"> Dark mode</label>

<script>
let settings = salam.load("settings", { dark: false });

function apply() {
  document.body.classList.toggle("dark", settings.dark);
  document.getElementById("dark").checked = settings.dark;
}

function change() {
  settings.dark = document.getElementById("dark").checked;
  salam.save("settings", settings);
  apply();
}

apply();
</script>

اشتباه رایج: var(bg) یا var(-bg) کار نمی‌کند؛ اسم متغیر همیشه با دو خط تیره است: var(--bg). اشتباه دیگر: قاعده‌ی body.dark را بنویسی ولی رنگ body را مستقیم white گذاشته باشی، نه var(--bg)؛ آن وقت حالت تیره هیچ اثری ندارد.

همین در پایتون: تنظیمات یک دیکشنری است، مثل settings = {"dark": True, "name": "Sara"}، و با json.dump(settings, file) در یک فایل ذخیره می‌شود. True پایتون همان true جاوااسکریپت است.

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

چالش‌ها

  1. Colours in Variables (آسان)
  2. Dark Mode Button (آسان)
  3. Hello, Name (آسان)
  4. Dark Mode Switch (متوسط)
  5. Remember Dark Mode (متوسط)
  6. Remember My Name (متوسط)
  7. One Settings Object (سخت)
  8. Colour Themes (سخت)

بیشتر بخوان

← جلسه‌ی 14: چند صفحه جلسه‌ی 16: پروژه: آزمون‌ساز →