renderToString() التصيير في الخادم إلى سلسلة نصية
آخر تحديث: 2026-10-22
renderToString() التصيير في الخادم إلى سلسلة نصية
تصيّر renderToString() التطبيق إلى سلسلة HTML على خادم Node: وهي مرحلة الإخراج في SSR، وتقترن بـ createSSRApp للترطيب في العميل.
| المجموعة | دوال العرض و SSR |
|---|---|
| النوع | API |
| النطاق | عام |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
import { renderToString } from "vue/server-renderer"
const html = await renderToString(app)⚙️ الوسائط
| app, context? | نسخة تطبيق (يمكن تمرير كائن سياق، مثل سياق SSR) |
|---|
القيمة المُرجعة：Promise
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Shows the SSR notice (real rendering happens in Node).💡 نقاط مهمة
ℹ️ ملاحظة تُستورد من vue/server-renderer: مخصصة للـ SSR في بيئة Node ولا يمكن استخدامها في المتصفح.
💡 نصيحة تقترن بـ onServerPrefetch للجلب المسبق للبيانات و useSSRContext لتمرير السياق.
⚠️ تحذير تحت SSR لا تستطيع المكوّنات الوصول إلى window/document، وإلا أخفق الخادم مباشرة.
🏷️ دوال العرض و SSR ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س هل تُستخدم في المتصفح؟
ج لا، فالحزمة server-renderer خاصة بـ Node.
س ما علاقتها بـ Nuxt؟
ج Nuxt داخلياً غلاف لهذه الآلية نفسها (renderToString + الترطيب).
س ماذا يجب أن يتضمن الناتج؟
ج HTML الصفحة + الحالة المُسلسلة، ليُعاد استخدامها عند ترطيب العميل.
