تتيح ميزة "حظر التعليقات" للمستخدمين إضافة تعليقات إلى أيّ قسم محظور. تمامًا مثل التعليقات في لغة برمجة مستندة إلى النصوص، لا تؤثّر هذه التعليقات في سلوك أيّ مربّع. ويتم إضافتها إلى الرمز الذي تم إنشاؤه (بما في ذلك الرمز الذي تم إنشاؤه بواسطة الكتل المخصّصة) من خلال أداة إنشاء الرموز البرمجية للغة العادية.
رمز التعليق
يُدخل المستخدمون التعليقات المحظورة باستخدام محرِّر النصوص في رمز التعليق.
لا يظهر رمز التعليق تلقائيًا. هناك طريقتان لعرضه:
- استخدِم
Block.setCommentTextمع سلسلة غير فارغة. - اسمح للمستخدم بعرضه من خلال النقر على "إضافة تعليق" في قائمة سياق العبارة.
لإزالة رمز التعليق، اتّبِع الخطوات التالية:
- يُرجى الاتصال بـ
Block.setCommentTextباستخدامnull. - يمكنك السماح للمستخدم بإزالته من خلال النقر على "إزالة التعليق" في قائمة سياق الحظر.
يُرجى العِلم أنّ الخيارَين "إضافة تعليق" و "إزالة تعليق" لا يظهران في قائمة السياقات إلا في الحالتَين التاليتَين:
- أن يكون العنصر قابلاً للتعديل
- لم يتم تصغير الكتلة.
- تم ضبط خيار الضبط
commentsعلىtrue. إذا لم تضبط هذا الخيار صراحةً، سيتم ضبطه تلقائيًا علىtrueإذا كانت مجموعة الأدوات تحتوي على فئات، وfalseفي حال عدم احتوائها على فئات.
التعامل مع التعليقات المُجمَّعة آليًا
للحصول على تعليق محظور:
// Returns comment text or null if there is no comment.
myBlock.getCommentText();
لضبط تعليق محظور:
// Sets comment text and displays comment icon.
myBlock.setCommentText('My comment');
لحذف تعليق مربّع:
// Removes comment text and removes comment icon.
myBlock.setCommentText(null);
لا تتأثر إمكانية العمل مع التعليقات آليًا بحالة
الوحدة (مثل ما إذا كانت قابلة للتعديل أو مصغّرة) أو إعداد خيار الضبط
comments.