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