مساحة اسم المتغيّرات
الدوال
| الوظيفة | الوصف |
|---|---|
| allDeveloperVariables(workspace) | يمكنك العثور على جميع متغيّرات المطوّرين التي تستخدمها الحظر في مساحة العمل. لا يتم عرض متغيّرات المطوِّرين للمستخدم مطلقًا، ولكن يتم تعريفها كمتغيّرات عمومية في الرمز الذي تم إنشاؤه. لتعريف متغيرات مطوّري البرامج، حدِّد دالة getDeveloperVariables على الكتلة وأرجع قائمة بأسماء المتغيرات. للاستخدام من قِبل المولّدات. |
| allUsedVarModels(ws) | يمكنك العثور على جميع المتغيّرات التي أنشأها المستخدمون والقيد الاستخدام في مساحة العمل. للاستخدام من قِبل المولّدات. للحصول على قائمة بجميع المتغيّرات في مساحة عمل، بما في ذلك المتغيّرات غير المستخدَمة، يمكنك استدعاء Workspace.getAllVariables. |
| createVariableButtonHandler(workspace, opt_callback, opt_type) | لمعالجة زر "إنشاء متغيّر" في فئة مجموعة أدوات المتغيّرات التلقائية ستطلب هذه السياسة من المستخدم إدخال اسم متغيّر، بما في ذلك إرسال الطلبات مجددًا إذا كان هناك اسم قيد الاستخدام حاليًا بين متغيّرات مساحة العمل. يمكن معالِجات الأزرار المخصّصة تفويض هذه الدالة، ما يسمح بأنواع المتغيرات والمعالجة بعد الإنشاء. التخصيص الأكثر تعقيدًا (مثل طلب نوع المتغير) يتجاوز نطاق هذه الدالة. |
| flyoutCategory(workspace) | أنشئ العناصر (القوالب والزر) المطلوبة من خلال القائمة المنبثقة لفئة المتغير. |
| flyoutCategoryBlocks(workspace) | أنشئ القوالب المطلوبة في القائمة المنبثقة لفئة المتغير. |
| generateUniqueName(workspace) | تُرجع اسم متغيّر جديد لم يتم استخدامه بعد. سيؤدي ذلك إلى محاولة إنشاء أسماء متغيرات من حرف واحد في النطاق من "i" إلى "z" للبدء. في حال عدم وجود اسم فريد، ستتم تجربة من "i" إلى "z" و"a" إلى "h"، ثم من "i2" إلى "z2" وما إلى ذلك. تخطّي "l". |
| generateUniqueNameFromOptions(startChar, usedNames) | تعرض اسمًا فريدًا غير متوفر في مصفوفة useNames. سيؤدي ذلك إلى محاولة إنشاء أسماء أحرف مفردة في النطاق a - z (تخطي l). وستبدأ بالحرف الذي تم تمريره إلى startChar. |
| generateVariableFieldDom(variableModel) | إنشاء كائنات DOM التي تمثل حقلاً متغيّرًا |
| getOrCreateVariablePackage(workspace, id, opt_name, opt_type) | دالة مساعدة للبحث عن متغيّر أو إنشائه في مساحة العمل المحدّدة. في حال عدم وجود متغير، يتم إنشاؤه وعرضه. |
| getVariable(workspace, id, opt_name, opt_type) | ابحث عن متغير في مساحة العمل المحددة. يبحث دائمًا في مساحة العمل الرئيسية قبل البحث في مساحة العمل المنبثقة. يتم تفضيل البحث حسب رقم التعريف دائمًا للبحث حسب الاسم والنوع. |
| nameUsedWithAnyType(name, workspace) | تحقّق مما إذا كان هناك متغيّر بالاسم الذي تم إدخاله من أي نوع. |
| promptName(promptText, defaultText, callback) | مطالبة المستخدم باسم متغيّر جديد |
| renameVariable(workspace, variable, opt_callback) | يتم فتح إشعار يسمح للمستخدم بإدخال اسم جديد للمتغيّر. تؤدي هذه السياسة إلى إعادة التسمية إذا كان الاسم الجديد صالحًا. أو المطالبة بإعادة الطلب في حال حدوث تصادم. |
المتغيرات
| متغير | الوصف |
|---|---|
| CATEGORY_NAME | سلسلة للاستخدام في السمة "custom" لفئة معيّنة في ملف XML بمربع الأدوات. تشير هذه السلسلة إلى أنه يجب تعبئة الفئة ديناميكيًا باستخدام كتل متغيرة. يمكنك أيضًا مراجعة Blockly.Procedures.CATEGORY_NAME وBlockly.Variables Dynamic.CATEGORY_NAME. |
| TEST_ONLY | |
| VAR_LETTER_OPTIONS |