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

جلسه‌ی 3: فرم خوب Good Forms

فرمی می‌سازی که درست ورودی می‌گیرد: برچسب برای هر کادر، کادر عدد و تاریخ، راهنمای داخل کادر، کادر اجباری، و ثبت فرم بدون اینکه صفحه از نو باز شود.

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

درس

تقریباً هر اپی یک فرم «افزودن» دارد: کار تازه، خرج تازه، سؤال تازه. فرم خوب یعنی کاربر بداند چه بنویسد، نتواند چیز خراب بنویسد و با یک Enter کارش تمام شود. در این جلسه قدم‌به‌قدم چنین فرمی می‌سازیم.

برچسب. هر کادر یک label لازم دارد که بگوید چه بنویسی. for برچسب باید با id کادر یکی باشد. آن وقت با زدن روی برچسب، کادر آماده‌ی نوشتن می‌شود؛ روی گوشی این یعنی هدف بزرگ‌تر برای انگشت. روی کلمه‌ی Name بزن!

<label for="name">Name</label>
<input id="name">

نوع کادر. با type="number" روی گوشی صفحه‌کلید عددی باز می‌شود و حروف قبول نمی‌شود. با type="date" یک تقویم کوچک می‌آید. placeholder یک مثال کم‌رنگ داخل کادر است که با نوشتن ناپدید می‌شود.

<label for="price">Price (toman)</label>
<input id="price" type="number" placeholder="12000">

<label for="day">Day</label>
<input id="day" type="date">

کادر اجباری. با کلمه‌ی required فرم تا وقتی این کادر خالی است ثبت نمی‌شود و مرورگر خودش به کاربر می‌گوید پرش کند. بدون آن، کاربر خراب‌کار یک کار خالی به لیستت اضافه می‌کند!

<form>
  <label for="task">Task</label>
  <input id="task" required placeholder="Homework">
  <button>Add</button>
</form>

ثبت فرم. وقتی Enter را می‌زنی یا دکمه‌ی داخل فرم را، فرم submit می‌شود و onsubmit اجرا می‌شود. ولی مرورگر بعدش صفحه را از نو باز می‌کند و همه‌چیز پاک می‌شود! خط اول تابع باید event.preventDefault() باشد: «صفحه را از نو باز نکن، خودم کارش را می‌کنم».

<form onsubmit="add(event)">
  <label for="task">Task</label>
  <input id="task" required>
  <button>Add</button>
</form>
<p id="out">Nothing yet</p>

<script>
function add(event) {
  event.preventDefault();
  let task = document.getElementById("task").value;
  document.getElementById("out").textContent = "Added: " + task;
}
</script>

خواندن عدد. value هر کادر همیشه متن است، حتی در type="number". برای حساب، با Number() آن را عدد کن. وگرنه "3" + 1 می‌شود "31"، نه 4!

<form onsubmit="calc(event)">
  <label for="cups">Cups of water</label>
  <input id="cups" type="number" required>
  <button>OK</button>
</form>
<p id="out"></p>

<script>
function calc(event) {
  event.preventDefault();
  let cups = Number(document.getElementById("cups").value);
  document.getElementById("out").textContent = "That is " + (cups * 250) + " ml";
}
</script>

اشتباه رایج: onsubmit را روی دکمه بگذاری یا event را به تابع ندهی. onsubmit مال تگ form است و باید add(event) بنویسی تا تابع بتواند event.preventDefault() را صدا بزند.

همین در پایتون: در پایتون cups = int(input("Cups? ")) ورودی را می‌گیرد و عدد می‌کند، مثل Number(...value). و به‌جای required خودت می‌پرسی: if task == "": print("Write a task first").

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

چالش‌ها

  1. A Label for Name (آسان)
  2. Price Field (آسان)
  3. Date Field (آسان)
  4. Stop the Reload (متوسط)
  5. No Empty Items (متوسط)
  6. Cups to Millilitres (متوسط)
  7. Add a Spending (سخت)
  8. Birthday Form (سخت)

بیشتر بخوان

← جلسه‌ی 2: صفحه برای گوشی جلسه‌ی 4: پروژه: اپ «درباره‌ی من» →