يمكنك إنشاء مساحة عمل وإدراجها في DOM في مكالمة واحدة، أو يمكنك إنشاء مساحة عمل فقط.
الحقن
يمكنك إنشاء مساحة عمل Blockly وإدراجها في نموذج المستند (DOM) من خلال استدعاء Blockly.inject(location, options). تحدّد الوسيطة الأولى المكان الذي سيتم فيه إدراج مساحة العمل في نموذج المستند (DOM). الوسيطة الثانية هي كائن يحتوي على خيارات الإعداد.
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مساحة عمل.
إنشاء مباشر
يمكنك إنشاء مساحة عمل مباشرةً عن طريق استدعاء new Blockly.WorkspaceSvg(new
Blockly.Options(options)). عند إجراء هذه المكالمة، احرص على تمرير خيارات الإعداد في مكالمة إلى new Blockly.Options(options)، لأنّ الدالة الإنشائية WorkspaceSvg لا يمكنها قبول عنصر خيارات الإعداد مباشرةً.
خيارات الإعداد
ينفّذ عنصر الإعدادات
Blockly.BlocklyOptions
ويتضمّن الخيارات التالية. يُرجى العلم أنّ العديد من هذه الخيارات تغيّر قيمتها التلقائية استنادًا إلى ما إذا كانت مجموعة الأدوات المتوفّرة تتضمّن فئات أم لا.
| الاسم | النوع | الوصف |
|---|---|---|
collapse |
قيمة منطقية | تحديد ما إذا كانت قوائم السياق الخاصة بالكتل تتضمّن عنصرًا لتصغير الكتل أو توسيعها القيمة التلقائية هي true إذا كانت مجموعة الأدوات تتضمّن فئات، أو false في حال عدم توفّرها. |
comments |
قيمة منطقية | تحديد ما إذا كانت قوائم السياق الخاصة بالكتل تتضمّن عنصرًا لإضافة التعليقات أو إزالتها القيمة التلقائية هي true إذا كانت مجموعة الأدوات تتضمّن فئات،false وإلا ستكون القيمة التلقائية هي 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 عرض محرّرات مشروطة لحقول إدخال النص وفئاتها الفرعية على الأجهزة الجوّالة، ومحرّر مضمّن على الكمبيوتر إذا false عرضت محررًا مضمّنًا على كلّ من أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة. القيمة التلقائية هي true. |
move |
عنصر | تضبط هذه السمة طريقة تنقّل المستخدمين في مساحة العمل. اطّلِع على نقل. |
oneBasedIndex |
قيمة منطقية | إذا كان يجب أن تبدأ عمليات القائمة والسلسلة من true، يجب أن يبدأ الفهرس false من 0.1 القيمة التلقائية هي true. |
plugins |
عنصر | تسجيل ربط الكائنات هو نوع من أنواع التسجيلات التي تربط أسماء الأنواع بفئات بديلة أو الأسماء المسجّلة للفئات البديلة. راجِع إدخال فئة بديلة. |
readOnly |
قيمة منطقية | إذا كانت القيمة true، امنع المستخدم من التعديل. يؤدي ذلك إلى إخفاء شريط الأدوات وسلّة المهملات. القيمة التلقائية هي false. يمكنك الاطّلاع أيضًا على setIsReadOnly وisReadOnly. |
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 |
عنصر | تضبط هذه السمة سلوك التكبير/التصغير. راجِع مقالة التكبير/التصغير. |