الحقن
يمكنك إدراج مساحة عمل Blockly من خلال طلب إلى
Blockly.inject(location, options). تُخبر الوسيطة الأولى أداة Blockly بمكان
إدراج مساحة العمل في DOM. الوسيطة الثانية هي قاموس لأزواج
الاسم والقيمة التي يتم استخدامها للضبط. يفكّك رمز الإدراج القاموس
options إلى مثيل من Blockly.Options.
الإنشاء المباشر
يمكنك أيضًا إنشاء مساحة عمل مباشرةً من خلال الاتصال بالرقم
Blockly.WorkspaceSvg(new Blockly.Options(options)). يُرجى العِلم أنّك تحتاج إلى
استدعاء new Blockly.Options(options)، مع تضمين معجم الخيارات، لأنّ Blockly.Options new Blockly.Options(options)يتوقع مثيلًا منBlockly.Options، وليس معجم خيارات فارغًا.
قاموس الخيارات
تتوفّر الخيارات التالية. يُرجى العِلم أنّ العديد من هذه الخيارات تغيّر قيمتها التلقائية استنادًا إلى ما إذا كانت مجموعة الأدوات المقدَّمة تتضمّن فئات أم لا.
| الاسم | النوع | الوصف |
|---|---|---|
collapse
|
قيمة منطقية | السماح بتصغير الكتل أو توسيعها يتم ضبط القيمة تلقائيًا على
true إذا كان صندوق الأدوات يتضمّن فئات، وfalse في غير ذلك. |
comments
|
قيمة منطقية | السماح بإضافة تعليقات إلى الكتل يتم ضبط القيمة التلقائية على true إذا كانت
ملحقة الأدوات تتضمّن فئات،false وfalse في غير ذلك. |
css
|
قيمة منطقية | إذا كانت القيمة "false"، لا تُدرِج CSS (يصبح توفير CSS مسؤولية
الوثيقة). الإعداد التلقائي هو true. |
disable
|
قيمة منطقية | السماح بإيقاف الوحدات يتم ضبط القيمة التلقائية على true إذا كانت
أداة الأدوات تتضمّن فئات، وfalse في حال عدم توفّر فئات. |
grid |
عنصر | لضبط شبكة يمكن أن تلتصق بها الكتل اطّلِع على الشبكة. |
horizontalLayout
|
قيمة منطقية | إذا كان صندوق الأدوات true أفقيًا، إذا كان صندوق الأدوات false عموديًا. الإعداد التلقائي هو false. |
maxBlocks
|
الرقم | الحد الأقصى لعدد الكتل التي يمكن إنشاؤها مفيدة ل
تمارين الطلاب الإعداد التلقائي هو Infinity. |
maxInstances
|
عنصر | ربط أنواع الكتل بالحد الأقصى لعدد الكتل من هذا
النوع التي يمكن إنشاؤها تكون الأنواع غير المعلَن عنها تلقائيًا
Infinity. مثال:
maxInstances: {'controls_if': 3, 'math_number': 42} |
media
|
سلسلة | المسار من الصفحة (أو الإطار) إلى دليل وسائط Blockly
الإعداد التلقائي هو
"https://blockly-demo.appspot.com/static/media/". |
modalInputs
|
قيمة منطقية | إذا كان true يعرض محرّرات مشروطة لحقول إدخال النص
وفئاتها الفرعية عند استخدام الأجهزة الجوّالة، ومحرّرًا مضمّنًا
على أجهزة الكمبيوتر المكتبي. إذا كان الخيار false مفعّلاً، يتم عرض محرِّر مضمّن على
كلّ من أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة. الإعداد التلقائي هو true. |
move
|
عنصر | لضبط السلوك الذي يمكن للمستخدمين من خلاله التنقّل في مساحة العمل يُرجى الاطّلاع على نقل. |
oneBasedIndex
|
قيمة منطقية | إذا كان يجب فهرسة عمليات القائمة والسلسلة true من 1،
إذا كان يجب فهرسة false من 0. الإعداد التلقائي هو true. |
readOnly
|
قيمة منطقية | إذا كان الخيار true، امنع المستخدم من التعديل. يوقف
صندوق الأدوات وصندوق المهملات. الإعداد التلقائي هو false. |
renderer
|
سلسلة | لتحديد أداة الربط المستخدَمة في Blockly تشمل مُحرّرات DWG المُعدّة مسبقًا "geras" (الإعداد التلقائي) و"thrasos" و"zelos" (محرّر مثل "الرسم من الصفر"). |
rtl
|
قيمة منطقية | إذا كان true، يمكنك نسخ المحرِّر (للغات العربية أو العبرية).
اطّلِع على العرض التوضيحي لعرض الإعلانات من اليمين إلى اليسار. الإعداد التلقائي هو false. |
scrollbars
|
عنصر أو قيمة منطقية | لتحديد ما إذا كانت مساحة العمل تحتوي على شريطَي التمرير عموديَين أو أفقيَين
تأخذ عنصرًا تحدّد فيه السمة horizontal
ما إذا كان التمرير الأفقي مفعّلاً، وتحدّد السمة
vertical ما إذا كان التمرير العمودي مفعّلاً. إذا تم تمرير قيمة منطقية، يكون ذلك معادلاً لمحاولة
تمرير عنصر تم ضبط سمتَيه horizontal وvertical
على تلك القيمة. يتم ضبط القيمة تلقائيًا على true إذا كانت
أداة الأدوات تتضمّن فئات. |
sounds |
قيمة منطقية | إذا كانت القيمة false، يتم إيقاف الأصوات. الإعداد التلقائي هو true. |
theme
|
المظهر | يتم ضبط القيمة تلقائيًا على المظهر الكلاسيكي في حال عدم توفير مظهر. اطّلِع على المظاهر. |
toolbox
|
سلسلة أو XML أو JSON | بنية شجرة للفئات والكتل المتاحة للمستخدم اطّلِع على تحديد صندوق الأدوات للحصول على مزيد من المعلومات. |
toolboxPosition
|
سلسلة | إذا كان "start" صندوق الأدوات في الأعلى (إذا كان الوضع أفقيًا) أو على اليسار (إذا كان الوضع عموديًا واتجاه النص من اليمين إلى اليسار) أو على اليمين (إذا كان الوضع عموديًا واتجاه النص من اليمين إلى اليسار). إذا كان صندوق أدوات
"end" على الجانب المقابل الإعداد التلقائي هو "start". |
trashcan
|
قيمة منطقية | لعرض المهملات أو إخفائها يتم ضبط القيمة التلقائية على true إذا كانت
أداة الأدوات تتضمّن فئات، وfalse في حال عدم توفّر فئات. |
maxTrashcanContents
|
الرقم | الحد الأقصى لعدد العناصر المحذوفة التي ستظهر في النافذة المنبثقة لسلة المهملات يؤدي استخدام القيمة 0 إلى إيقاف الميزة. القيمة التلقائية هي 32. |
plugins
|
عنصر | تعيين نوع المكوّن الإضافي إلى اسم المكوّن الإضافي المسجّل أو فئة المكوّن الإضافي راجِع إدخال الفئات الفرعية. |
zoom |
عنصر | لضبط سلوك التكبير/التصغير راجِع التكبير/التصغير. |