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