فهرست سرفصل‌های Vue
خانه (HOME) معرفی (Intro) دایرکتیوها (Directives) v-bind (v-bind) v-if (v-if) v-show (v-show) v-for (v-for) رویدادها (Events) v-on (v-on) متدها (Methods) تغییردهنده های رویداد (Event Modifiers) فرم ها (Forms) v-model (v-model) بایندینگ CSS (CSS Binding) ویژگی های محاسبه شده (Computed Properties) واچرها (Watchers) قالب ها (Templates) چرا، چگونه و راه اندازی (Why, How and Setup) اولین صفحه SFC (First SFC Page) کامپوننت ها (Components) پراپس (Props) کامپوننت های v-for (v-for Components) $emit() ($emit()) ویژگی های عبوری (Fallthrough) (Fallthrough Attributes) استایل Scoped (Scoped Styling) کامپوننت های محلی (Local Components) اسلات ها (Slots) v-slot (v-slot) اسلات های Scoped (Scoped Slots) کامپوننت های پویا (Dynamic Components) Teleport (Teleport) درخواست HTTP (HTTP Request) رفرنس های تمپلیت (Template Refs) هوک های چرخه عمر (Lifecycle Hooks) Provide/Inject (Provide/Inject) مسیریابی (Routing) ورودی های فرم (Form Inputs) انیمیشن ها (Animations) انیمیشن با v-for (Animations with v-for) بیلد (Build) Composition API (Composition API) ویژگی های توکار (Built-in Attributes) ویژگی 'is' ('is' Attribute) ویژگی 'key' ('key' Attribute) ویژگی 'ref' ('ref' Attribute) کامپوننت های توکار (Built-in Components) <KeepAlive> (<KeepAlive>) <Teleport> (<Teleport>) <Transition> (<Transition>) <TransitionGroup> (<TransitionGroup>) المان های توکار (Built-in Elements) <component> (<component>) <slot> (<slot>) <template> (<template>) نمونه کامپوننت (Component Instance) $attrs ($attrs) $data ($data) $el ($el) $parent ($parent) $props ($props) $refs ($refs) $root ($root) $slots ($slots) $emit() ($emit()) $forceUpdate() ($forceUpdate()) $nextTick() ($nextTick()) $watch() ($watch()) دایرکتیوها (Directives) v-bind (v-bind) v-cloak (v-cloak) v-for (v-for) v-html (v-html) v-if (v-if) v-else-if (v-else-if) v-else (v-else) v-memo (v-memo) v-model (v-model) v-on (v-on) v-once (v-once) v-pre (v-pre) v-show (v-show) v-slot (v-slot) v-text (v-text) گزینه های نمونه (Instance Options) داده ها (data) متدها (methods) محاسبه شده ها (computed) watch (watch) پراپس (props) emits (emits) expose (expose) هوک های چرخه عمر (Lifecycle Hooks) beforeCreate (beforeCreate) created (created) beforeMount (beforeMount) mounted (mounted) beforeUpdate (beforeUpdate) updated (updated) beforeUnmount (beforeUnmount) unmounted (unmounted) errorCaptured (errorCaptured) renderTracked (renderTracked) renderTriggered (renderTriggered) activated (activated) deactivated (deactivated) serverPrefetch (serverPrefetch) مثال ها (Examples) تمرین ها (Exercises) کوییز (Quiz) سیلابس (Syllabus) برنامه مطالعه (Study Plan) سرور (Server) گواهینامه (Certificate)
نتیجه‌ای برای جستجو یافت نشد.
Vue

Vue — پراپس (props)

آخرین بروزرسانی: 1404/08/21

پراپس (props)

پراپس (Props) یعنی «ورودیِ کامپوننت». مثل تکلیفِ معلم که به شاگرد می دهد. والد مقدار می فرستد، فرزند فقط استفاده می کند.

تعریف و حالت های props

گزینه props می تواند آرایه باشد یا شیء. در آرایه، فقط نام ها می آیند. در شیء، نوع، پیش فرض، اجباری بودن و اعتبارسنجی هم داریم.

نمونه ساده: تعریف props با آرایه

<script>
export default {
  props: [
    'foodName',
    'foodDesc'
  ]
};
<\/script>

مشاهده در ادیتور

نمونه کامل: تنظیم نوع، پیش فرض و اجباری

<template>
  <div>
    <h2>{{ foodName }}</h2>
    <p>{{ foodDesc }}</p>
  </div>
</template>

<script>
export default {
  props: {
    foodName: {
      type: String,
      required: true
    },
    foodDesc: {
      type: String,
      required: false,
      default: 'This is the food description...'
    }
  }
};
<\/script>

<style>
/* استایل آزمایشی برای نمایش کارت ها */
<\/style>

مشاهده در ادیتور

گام های عملی استفاده از props

  1. در فرزند، نام پراپس ها را تعریف کن.
  2. در والد، مقدار را با ویژگی HTML بفرست.
  3. در قالب فرزند، مقدار را نمایش یا مصرف کن.

نکته: نوع نادرست در توسعه «هشدار» می دهد. اما اجرای برنامه متوقف نمی شود.

هشدار: پراپس «فقط خواندنی» است. آن را در فرزند تغییر نده. اگر نیاز داری، کپی محلی بساز.

جمع بندی سریع

  • پراپس ورودیِ کامپوننت فرزند است.
  • آرایه ساده، شیء پیشرفته است.
  • type و default کیفیت را بالا می برند.
  • required نبود مقدار را گوشزد می کند.
  • validator قوانین دلخواه را چک می کند.

مطالب مرتبط داخلی: emits برای رویداد برگشتی، و watch برای واکنش به تغییرات.

منابع در W3Schools: مرجع props، Vue Props، و $emit().