Text Block (""")

النصوص متعددة الأسطر (Text Blocks) Text Block (""")

text block نص يبدأ وينتهي بثلاث علامات اقتباس """ — يكتب عدة أسطر بدون \n أو تهريب مزعج لعلامات الاقتباس.

منذ Java 15، text block يفتح بـ """ متبوعة مباشرة بسطر جديد، وينتهي بـ """ أخرى. المترجم يحذف تلقائيًا أي مسافة بادئة مشتركة بين كل الأسطر بناءً على أقل سطر تباعدًا، فيمكن محاذاة النص مع بقية الكود دون أن تظهر تلك المسافات في القيمة الفعلية.

مفيد خصوصًا لتضمين HTML أو JSON أو استعلامات SQL داخل الكود دون سلسلة من عمليات الدمج (+) أو تهريب علامات الاقتباس.

الصياغة

String s = """
    نص
    متعدد الأسطر
    """;

📄 مثال

String json = """
    {
      "name": "سارة",
      "age": 22
    }
    """;

System.out.println(json);
// يطبع الـ JSON بنفس التنسيق والمحاذاة، بدون \n يدوية أو تهريب علامات الاقتباس

أهم النقاط

العنصر	الوظيفة
""" (فتح)	يجب أن يتبعها سطر جديد مباشرة
""" (إغلاق)	يمكن أن تكون في سطرها الخاص أو في نهاية آخر سطر نص
\ (نهاية السطر)	يلغي السطر الجديد ويكمل النص على نفس السطر المنطقي
\s	يحافظ على مسافة بيضاء زائدة كانت ستُحذف تلقائيًا في نهاية السطر

💡 نصائح عملية

استخدمها لأي نص متعدد الأسطر: HTML وSQL وJSON مضمّن، أو رسائل طويلة للمستخدم
المسافة البادئة المشتركة تُحسب من أقل سطر تباعدًا، بما فيه سطر الإغلاق — انتبه لموضع """ الأخيرة

⚠️ أخطاء شائعة

وضع نص مباشرة بعد """ الفاتحة بدون سطر جديد — خطأ ترجمة
خلط المسافات (spaces) والتبويبات (tabs) في المسافة البادئة — يُحسب حرفيًا فيعطي نتيجة غير متوقعة

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار JAVA الكامل بالعربي.