Vue Tutorial فصل ۲ — داده و رندر درس آموزشی

v-if، v-for و رندر لیست‌ها

v-if/v-else/v-show کنترل نمایش هستند (v-if از DOM حذف می‌کند، v-show فقط CSS می‌پوشاند) و v-for لیست می‌رندد — همیشه با :key یکتا. ناوبری و لیست کارت‌ها قلب هر اپ فارسی است؛ ترتیب صحیح شکل داده → قالب را حفظ کنید.

مراحل قدم‌به‌قدم

  1. ۱

    v-if در برابر v-show

    v-if=true/false مونت/آن‌مونت واقعی است — برای بخش‌های سنگین یا کم‌تعویض؛ v-show فقط display می‌عوض — برای toggleهای پرتکرار. v-if با v-else-if و v-else زنجیر می‌شود؛ v-for و v-if روی یک المان نگذارید (v-if اول اجرا می‌شود و منبع می‌بیند).

  2. ۲

    v-for با key

    <li v-for="task in tasks" :key="task.id"> — key یکتا (id) نه ایندکس؛ با ایندکس، حذف وسط لیست حالت المان‌ها را خراب می‌کند. دو متغیر: v-for="(item, index) in items". برای آبجکت هم می‌شود: v-for="(value, key) in obj".

  3. ۳

    داده از API

    onMounted(() => { load() }) بعد از مونت اجرا می‌شود؛ لیست را ref([]) بگذارید و بعد از fetch پر کنید؛ loading ref(false) برای اسکلتون. خطا هم ref و در قالب v-if="error" برای پیام فارسی.

  4. ۴

    فیلتر و مرتب‌سازی

    لیست نمایش‌داده‌شده را با computed بسازید: const visible = computed(() => tasks.value.filter(t => !t.done)) — داده اصلی دست‌نخورده و قالب از visible می‌خواند؛ فیلتر جستجو با همین الگو.

نکات مهم

  • ◆ key یکتا برای v-for الزامی؛ ایندکس فقط وقتی لیست ثابت است.
  • ◆ v-if برای حذف واقعی، v-show برای toggle سریع.
  • ◆ لیست‌های فیلترشده را با computed بسازید نه دستکاری داده اصلی.

کد یا مسیر نمونه

<!-- TaskList.vue -->
<template>
  <input v-model="query" placeholder="جستجو…" class="border rounded p-2">
  <p v-if="loading">در حال بارگذاری…</p>
  <p v-else-if="error" class="text-rose-600">{{ error }}</p>
  <ul v-else class="divide-y">
    <li v-for="task in visible" :key="task.id" class="py-2">
      {{ task.title }}
      <span v-if="task.done" class="text-emerald-600">✓</span>
    </li>
    <li v-if="visible.length === 0" class="py-4 text-slate-400">کاری یافت نشد.</li>
  </ul>
</template>

<script setup>
import { ref, computed, onMounted } from "vue";
const tasks = ref([]), query = ref(""), loading = ref(true), error = ref("");
const visible = computed(() =>
  tasks.value.filter(t => t.title.includes(query.value))
);
onMounted(async () => {
  try {
    const res = await fetch("/api/todos");
    tasks.value = await res.json();
  } catch {
    error.value = "بارگذاری ناموفق بود";
  } finally {
    loading.value = false;
  }
});
</script>

اجرای زنده کد HTML

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.