קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
רוב ערכי השדות מוכנים לשרשור למחרוזת הקוד באופן מיידי.
עם זאת, חלק מערכי השדות דורשים עבודה נוספת לפני שאפשר להשתמש בהם.
מיתרים
כדי שאפשר יהיה לשרשר מחרוזות, צריך להוסיף להן קווים עליונים (quotation marks) עם quote_ או multiline_quote_. הפונקציות האלה מבצעות בריחה מסימן (escape) ספציפי לשפה, למשל החלפת ' ב-\' ב-JavaScript.
// For a single line text field.conststr=generator.quote_(block.getFieldValue('STR'));// For a multiline text field.conststr=generator.multiline_quote_(block.getFieldValue('STR'));
משתנים
בשדה המשתנה המובנה, getFieldValue מחזיר מזהה משתנה ולא שם משתנה. כדי לקבל שם משתנה בפועל, צריך להפעיל את getVariableName ב-code generator. הפונקציה מחזירה שם ייחודי וחוקי. בין היתר, getVariableName:
ממירה את התווים שאינם ASCII ל-ASCII. הדבר נחוץ כי המשתמשים יכולים להזין שמות משתנים בשפה שלהם. לדוגמה, הוא ממיר את הערך متغير לערך _D9_85_D8_AA_D8_BA_D9_8A_D8_B1.
מוודאים ששמות המשתנים עומדים בכללים שהוגדרו בשפות התכנות.
לדוגמה, הוא ממיר רווחים לקווים תחתונים ומוסיף את הקידומת my_ לשמות של משתנים שמתחילים במספר.
פתרון התנגשויות עם מילים שמורות או שמות אחרים של משתנים או פונקציות.
לדוגמה, הוא ממיר את הערך for לערך for2.
בשדה התפריט הנפתח המובנה, הפונקציה getFieldValue מחזירה מחרוזת ללא שיוך לשפה, שיכול להיות שלא ניתן להשתמש בה ישירות בקוד. לדוגמה, תפריט נפתח שמכיל אופרטורים להשוואה עשוי להחזיר את הערכים 'EQUALS', 'LESS' או 'GREATER'. אפשר להשתמש בו כדי לחפש מחרוזת שנעשה בה שימוש בקוד.
בשדה התיבה המובנית, הפונקציה getFieldValue מחזירה את הערך 'TRUE' או 'FALSE'.
האופן שבו משתמשים באפשרות הזו תלוי במשמעות של תיבת הסימון. לדוגמה, אפשר להשתמש בו להסתעפות בזמן יצירת קוד.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-04-14 (שעון UTC)."],[[["Fields in Blockly define user-editable values (strings, numbers, colors, etc.) for code generation."],["Access field values using `getFieldValue`, transform them into usable strings (e.g., quoting strings, scrubbing variable names), and concatenate them into the code."],["Use `quote_` or `multiline_quote_` to properly format string values for code generation."],["Use `getVariableName` to ensure variable names are valid and avoid conflicts in the generated code."],["Refer to specific block type documentation for details on returning the generated code."]]],["Code generation with fields involves retrieving user-inputted values, such as strings or numbers, from fields. `getFieldValue` accesses these values, which vary by field type. Strings need quoting via `quote_` or `multiline_quote_`, while variables require scrubbing with `getVariableName` to ensure they are ASCII and don't clash with reserved words. Finally, the processed field value is inserted into the code string. The completed code string is returned depending on the specific type of block.\n"]]
