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

جلسه‌ی 9: اپی که یادش می‌ماند Remember

بهترین امتیاز و حالت تاریک را ذخیره می‌کنی تا با بستن اپ از بین نروند.

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

درس

متغیرها در حافظه‌ی موقت هستند: تا صفحه را می‌بندی یا تازه می‌کنی، پاک می‌شوند. رکورد بازی که با یک رفرش بپرد به درد نمی‌خورد! برای همین به ذخیره‌سازی نیاز داریم؛ جایی در خود مرورگر که با بستن صفحه پاک نمی‌شود.

در این تمرین‌ها صفحه‌ی تو در یک جعبه‌ی امن اجرا می‌شود که به حافظه‌ی مرورگر دسترسی ندارد. پس از یاور salam استفاده می‌کنیم که همان کار را می‌کند:
salam.load یعنی «چیزی که با این اسم ذخیره شده بده؛ اگر نبود این مقدار را بده». salam.save یعنی «این را با این اسم نگه دار».

let best = salam.load("quiz.best", 0);   // بار اول 0
salam.save("quiz.best", 120);            // حالا 120 می‌ماند

در پروژه‌ی واقعی خودت (جلسه‌ی ۱۳ به بعد) salam نیست. آن‌جا همین کار با localStorage انجام می‌شود. فرقش این است که localStorage فقط متن نگه می‌دارد، پس با JSON.stringify به متن تبدیل می‌کنیم و با JSON.parse برمی‌گردانیم. پس در پوشه‌ی پروژه‌ات این دو تابع را می‌نویسی، همان‌طور که اپ نمونه دارد:

function load(key, fallback) {
  const value = localStorage.getItem(key);
  return value === null ? fallback : JSON.parse(value);
}

function save(key, value) {
  localStorage.setItem(key, JSON.stringify(value));
}

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

حالا پاداش جلسه‌ی ۳ را می‌گیریم! چون همه‌ی رنگ‌ها در متغیر هستند، حالت تاریک فقط یک قانون است: وقتی ریشه‌ی صفحه data-theme="dark" دارد، متغیرها مقدار تاریک می‌گیرند و همه‌چیز خودش عوض می‌شود.
در JavaScript آن را با document.documentElement.dataset.theme می‌نویسیم؛ documentElement همان تگ <html> است.

:root[data-theme="dark"] {
  --bg: #17112b;
  --card: #241b40;
}

واژه‌های این جلسه:
• ذخیره‌سازی | storage | نگه داشتن داده بعد از بستن صفحه
• حافظه‌ی مرورگر | localStorage | جای داده در مرورگر
• ذخیره کردن | save | نوشتن داده با یک اسم
• خواندن | load | برداشتن داده با همان اسم
• مقدار پیش‌فرض | fallback | مقدار جایگزین وقتی چیزی نیست
• رکورد | best score | بالاترین امتیاز تا الان
• حالت تاریک | dark mode | رنگ‌های تیره برای چشم
• پوسته | theme | مجموعه‌ی رنگ‌های اپ

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

چالش‌ها

  1. Best Score (متوسط)
  2. A New Record! (آسان)
  3. Dark Mode (متوسط)
  4. Remember the Theme (آسان)

بیشتر بخوان

← جلسه‌ی 8: زمان و نتیجه جلسه‌ی 10: دو زبان →