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