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