Vue Tutorial فصل ۳ — کامپوننت‌ها و پروژه درس آموزشی

props، emit و ترکیب کامپوننت‌ها

کامپوننت قرارداد دارد: props ورودی‌هایش از والد (فقط‌خواندنی) و emit رویدادهایش به والد. داده به پایین می‌رود (props)، رویداد به بالا (emit) — این جریان یک‌طرفه، دیباگ هر اپ بزرگ را ممکن می‌کند. با defineProps و defineEmits در script setup تعریف می‌شوند.

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

  1. ۱

    props — ورودی‌ها

    defineProps({ title: String, price: Number, premium: Boolean }); در قالب مستقیم: {{ title }}. از والد: <ProductCard title="هندزفری" :price="250000" /> — دونقطه برای عبارت JS، بدون آن رشته می‌شود (اشتباه کلاسیک!).

  2. ۲

    emit — رویداد به بالا

    const emit = defineEmits(['select', 'remove']); emit('select', product); والد گوش می‌دهد: @select="onSelect". کامپوننت فرزند وضعیت والد را مستقیم mutate نمی‌کند — رویداد می‌فرستد و والد تصمیم می‌گیرد.

  3. ۳

    slot — جای محتوا

    <slot></slot> در قالب فرزند یعنی «محتوای والد اینجا می‌نشیند»: <Card><h3>هرچه</h3></Card>. slot نام‌دار برای چند جایگاه — الگوی layoutها.

  4. ۴

    کامپوننت‌های آبشاری

    App → Sidebar + Main → ProductList → ProductCard — داده در App ورد و با props پایین می‌رود. برای عمق زیاد، composables یا store (Pinia) جایگزین props-chain می‌شوند (درس بعدی).

نکات مهم

  • ◆ props فقط‌خواندنی؛ فرزند با emit از والد درخواست می‌کند.
  • ◆ :value عبارت JS می‌فرستد؛ value رشته خام است — دونقطه را فراموش نکنید.
  • ◆ slot برای کامپوننت‌های ظرف (Card، Modal) استاندارد است.

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

<!-- ProductCard.vue -->
<template>
  <div class="border rounded-xl p-4 hover:shadow-md transition" @click="emit('select', product)">
    <h3 class="font-bold">{{ product.name }}</h3>
    <p class="text-sm text-slate-500">{{ product.price.toLocaleString('fa-IR') }} تومان</p>
    <button v-if="removable" @click.stop="emit('remove', product.id)" class="text-rose-500 text-xs">حذف</button>
  </div>
</template>

<script setup>
const props = defineProps({ product: Object, removable: Boolean });
const emit = defineEmits(["select", "remove"]);
</script>

<!-- استفاده در والد -->
<!-- <ProductCard v-for="p in products" :key="p.id" :product="p" removable @remove="onDelete" /> -->

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

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

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

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

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

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

کپچا

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