מרחב השמות של המשתנים
פונקציות
פונקציה | תיאור |
---|---|
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 | מחרוזת לשימוש במאפיין 'custom' (מותאם אישית) של קטגוריה ב-XML של Toolbox. המחרוזת הזו מציינת שצריך לאכלס את הקטגוריה באופן דינמי באמצעות בלוקים משתנים. אפשר לעיין גם ב-Blockly.Procedures.CATEGORY_NAME וב-Blockly.VariablesDynamic.CATEGORY_NAME. |
TEST_ONLY | |
VAR_LETTER_OPTIONS |