provide/inject تسمح لـ مكون سلف بتوفير بيانات لأي مكون نسل، بغض النظر عن العمق، دون تمرير props عبر كل مكون وسيط. تحل مشكلة prop drilling.
App → Layout → Sidebar → Menu → MenuItem
إذا كان فقط يحتاج إلى ، فتمريره كـ prop عبر و و (التي لا تستخدمه) أمر مملل ومزعج. / تتخطى الوسائط.
MenuItemthemeLayoutSidebarMenuprovideinject<!-- App.vue -->
<script setup>
import { provide, ref } from "vue";
const theme = ref("dark");
provide("theme", theme); // make `theme` available to ALL descendants
provide("toggleTheme", () => { // can provide functions too
theme.value = theme.value === "dark" ? "light" : "dark";
});
</script>
<!-- MenuItem.vue (deeply nested) -->
<script setup>
import { inject } from "vue";
const theme = inject("theme"); // get it directly — no props in between
const toggleTheme = inject("toggleTheme");
const color = inject("color", "blue"); // with a default fallback
</script>
// ✅ provide a ref/reactive so descendants see updates
provide("theme", theme); // theme is a ref → reactive
// ❌ provide("theme", theme.value) → passes a snapshot, not reactive
وفر الكائن التفاعلي (ال ref، وليس .value خاصته) حتى عند تغييره، يتحدث كل المكونات المحقونة.
import { themeKey } from "./keys"; // export const themeKey = Symbol()
provide(themeKey, theme); // avoids string-key collisions
provide/inject → pass data down a specific subtree (theme, form context, a service)
Pinia → global, app-wide shared state (user, cart) usable anywhere
استخدم provide/inject لـ حقن التبعيات داخل شجرة جزئية؛ استخدم Pinia عندما تكون الحالة عامة حقًا أو مشتركة بين أجزاء غير مرتبطة من التطبيق.
provide/inject تلغي prop drilling للبيانات التي تشاركها العديد من المكونات المتداخلة (المواضيع، اللغات، نماذج السياق، خدمات الإضافات).
معرفة كيفية توفير قيم تفاعلية (بحيث تنتشر التحديثات)، واستخدام مفاتيح Symbol/القيم الافتراضية، وتمييزها عن الحالة العامة (Pinia) تسمح لك بتمرير السياق المشترك بشكل نظيف عبر شجرات المكونات العميقة.