الحقن
يمكنك إدراج مساحة عمل 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/". |
move
|
عنصر | لضبط السلوك الذي يمكن للمستخدمين من خلاله التنقّل في مساحة العمل يُرجى الاطّلاع على النقل. |
oneBasedIndex
|
قيمة منطقية | إذا كان يجب فهرسة عمليات القائمة والسلسلة true من 1،
إذا كان يجب فهرسة false من 0. الإعداد التلقائي هو true. |
readOnly
|
قيمة منطقية | إذا كان الخيار true، امنع المستخدم من التعديل. يوقف
صندوق الأدوات وصندوق المهملات. الإعداد التلقائي هو false. |
renderer
|
سلسلة | لتحديد أداة التحويل التي تستخدمها أداة Blockly تشمل مُحرّرات الصور المُعدّة مسبقًا "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 |
عنصر | لضبط سلوك التكبير/التصغير راجِع مقالة Zoom. |