تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تكون معظم قيم الحقول جاهزة لتسلسلها مع سلسلة الرمز البرمجي على الفور.
ومع ذلك، تتطلّب بعض قيم الحقول إجراءً إضافيًا قبل أن تصبح قابلة للاستخدام.
السلاسل
يجب اقتباس السلاسل باستخدام quote_ أو multiline_quote_ قبل
دمجها. تُجري هذه الدوالّ عملية معالجة خاصة باللغة لتجنّب عرض الأحرف، مثل استبدال ' بـ \' في 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 في
أداة إنشاء الرموز. يؤدي ذلك إلى عرض اسم فريد وقانوني. تشمل getVariableName، على سبيل المثال لا الحصر:
لتحويل الأحرف غير ASCII إلى ASCII وهذا ضروري لأنّه يمكن للمستخدمين
إدخال أسماء المتغيّرات بلغتهم الخاصة. على سبيل المثال، يتم تحويل
"متغير" إلى "_D9_85_D8_AA_D8_BA_D9_8A_D8_B1".
التأكّد من أنّ أسماء المتغيّرات تلتزم بالقواعد التي تحدّدها لغات البرمجة
على سبيل المثال، تحوّل المسافات إلى شرطات سفلية وتضيف البادئة my_ إلى
أسماء المتغيّرات التي تبدأ بأرقام.
حلّ التعارضات مع الكلمات المحجوزة أو أسماء المتغيّرات أو الدوالّ الأخرى
على سبيل المثال، يتم تحويل for إلى for2.
بالنسبة إلى الحقل المنسدلة المضمّن، يعرض getFieldValue سلسلة
غير محايدة من حيث اللغة قد لا تكون قابلة للاستخدام مباشرةً في الرمز البرمجي. على سبيل المثال، قد يعرض القائمة المنسدلة التي تحتوي على عوامل مقارنة الرمز 'EQUALS' أو 'LESS' أو
'GREATER'. يمكن استخدام هذا الأمر للبحث عن سلسلة يتم استخدامها في الرمز البرمجي.
بالنسبة إلى حقل مربّع الاختيار المضمّن، يعرض الرمز getFieldValue القيمة 'TRUE' أو 'FALSE'.
تعتمد طريقة استخدام هذا الخيار على معنى مربّع الاختيار. على سبيل المثال، يمكنك
استخدامها للتوغّل أثناء إنشاء الرمز.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eFields in Blockly define user-editable values (strings, numbers, colors, etc.) for code generation.\u003c/p\u003e\n"],["\u003cp\u003eAccess field values using \u003ccode\u003egetFieldValue\u003c/code\u003e, transform them into usable strings (e.g., quoting strings, scrubbing variable names), and concatenate them into the code.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003equote_\u003c/code\u003e or \u003ccode\u003emultiline_quote_\u003c/code\u003e to properly format string values for code generation.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003egetVariableName\u003c/code\u003e to ensure variable names are valid and avoid conflicts in the generated code.\u003c/p\u003e\n"],["\u003cp\u003eRefer to specific block type documentation for details on returning the generated code.\u003c/p\u003e\n"]]],["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"],null,["# Transform field values\n\nMost field values are ready to be concatenated to your code string immediately.\nHowever, some field values require extra work before they are usable.\n\nStrings\n-------\n\nStrings need to be quoted with either `quote_` or `multiline_quote_` before they\ncan be concatenated. These functions perform language-specific character\nescaping, such as replacing `'` with `\\'` in JavaScript. \n\n // For a single line text field.\n const str = generator.quote_(block.getFieldValue('STR'));\n\n // For a multiline text field.\n const str = generator.multiline_quote_(block.getFieldValue('STR'));\n\n| **Note:** the `quote_` and `multiline_quote_` methods follow an earlier naming convention with underscores, but they are public.\n\nVariables\n---------\n\nFor the built-in variable field, `getFieldValue` returns a variable ID, not a\nvariable name. To get an actual variable name, call `getVariableName` in the\ncode generator. This returns a name that is both unique and legal. Among other\nthings, `getVariableName`:\n\n- Converts the non-ASCII characters to ASCII. This is necessary because users can enter variable names in their own language. For example, it converts \"`متغير`\" to \"`_D9_85_D8_AA_D8_BA_D9_8A_D8_B1`\".\n- Ensures variable names follow the rules set forth by programming languages. For example, it converts spaces to underscores and adds the prefix `my_` to variable names that start with a digit.\n- Resolves conflicts with reserved words or other variable or function names. For example, it converts `for` to `for2`.\n\n const identifier = generator.getVariableName(block.getFieldValue('VAR'));\n\nDropdowns\n---------\n\nFor the built-in dropdown field, `getFieldValue` returns a language-neutral\nstring that might not be directly usable in code. For example, a dropdown\ncontaining comparison operators might return `'EQUALS'`, `'LESS'`, or\n`'GREATER'`. This can be used to look up a string that is used in code. \n\n const OPERATORS = {\n EQUALS: '==',\n LESS: '\u003c',\n GREATER: '\u003e',\n };\n const operator = OPERATORS[block.getFieldValue('OPERATOR')];\n\nCheckboxes\n----------\n\nFor the built-in checkbox field, `getFieldValue` returns `'TRUE'` or `'FALSE'`.\nHow you use this depends on the meaning of the checkbox. For example, you might\nuse it for branching while generating code."]]
