القيمة
يجب أن تتضمّن جميع الحقول قيمة، وهي مصدر المعلومات الصحيحة لبيانات الحقل. يمكن أن يكون هذا النوع أي نوع (سلسلة أو رقم أو مصفوفة أو تاريخ أو غير ذلك). قد تستخدم الحقول أدوات التحقّق من الصحة لفرض قيود على القيم أو لتحويلها إلى تنسيق يمكن قراءته آليًا (مثل توحيد تنسيقات التاريخ).
نص
تحتوي جميع الحقول على نص، وهو عبارة عن سلسلة بسيطة يمكن قراءتها وتمثّل قيمة الحقل. ولا يعني ذلك بالضرورة أنّهما متماثلان. على سبيل المثال، قد يكون النص في حقل منطقي هو "مفعّل" أو "غير مفعّل"، بينما تكون قيمته true أو false.
هذا النص هو ما يتم عرضه عند تصغير البلوك، وذلك لتسهيل الاستخدام، وقد يكون اختياريًا جزءًا من العرض على البلوك.
الحقول القابلة للتعديل مقابل الحقول غير القابلة للتعديل
بشكل عام، تسمح الحقول القابلة للتعديل للمستخدم بإجراء تغييرات على الرمز، بينما تعرض الحقول غير القابلة للتعديل معلومات للمستخدم حول الكتلة. قد يظهر محرر منسّق عند النقر على الحقول القابلة للتعديل.
تشمل الحقول القابلة للتعديل ما يلي:
تشمل الحقول غير القابلة للتعديل ما يلي:
نشر الحلقات على نحو متسلسِل
يتم ترميز قيمة الحقل القابل للتسلسل بتنسيق الحفظ (JSON أو XML). جميع الحقول القابلة للتعديل يمكن تسلسلها لأنّ قيمها ديناميكية. لا تكون قيم الحقول غير القابلة للتعديل ديناميكية عادةً، لذا لا يتم تسلسلها عادةً.
تشمل الحقول المتسلسلة ما يلي:
تشمل الحقول غير المتسلسلة ما يلي:
لاحظ كيف أنّ الحقل Label Serializable غير قابل للتعديل، ولكنّه قابل للتسلسل. وهذا يعني أنّه لا يمكن تعديله إلا بشكل برمجي، وليس من خلال واجهة مستخدم مرئية. بعد تعديلها، يتم ترميز قيمتها في ملف JSON/XML الذي تم إنشاؤه.
إنشاء الرموز البرمجية
بالإضافة إلى ربط اللبنات وفصلها، تُعد الحقول الطريقة الوحيدة التي يمكن للمستخدم من خلالها التحكّم في الرمز البرمجي الذي ينشئه Blockly. يتيح المحرّر الذي يوفّره أحد الحقول للمستخدم تعديل القيمة المخزّنة في الحقل. قد يتمكّن منشئ الحظر بعد ذلك من الوصول إلى قيمة الحقل لاستخدامها في الرمز الذي تم إنشاؤه.
لمزيد من المعلومات حول استخدام قيمة حقل في مولّد، راجِع إنشاء رمز الحقل.
العرض على البلاطة
عرض الحقل على مستوى البلوك هو مجموعة من عناصر SVG تمثّل قيمة الحقل. وتشغل هذه العناصر مساحة في المربّع، وعندما يتغير حجمها، فإنها تجبر المربّع على تغيير حجمه. يمكن أن يكون عرض الحقل عند الحظر بسيطًا أو معقّدًا، حسب احتياجاته.
في ما يلي بعض الأمثلة على العروض المختلفة داخل الحظر، مرتّبة حسب مستوى التعقيد المتزايد.
| نوع الحقل | الوصف |
|---|---|
| التصنيف | يحتوي على عنصر نصي فقط. |
| الزاوية | يحتوي على مستطيل خلفية وعنصر نص ورمز درجة. |
| سلحفاة | يحتوي على مستطيل خلفية وعنصر نص والعديد من عناصر SVG المستخدَمة لإنشاء رسم السلحفاة. |
عرض المحرّر
عندما ينقر المستخدم على حقل قابل للتعديل، قد يعرض الحقل محررًا معقّدًا بشكل عشوائي.
في ما يلي بعض الأمثلة على أدوات التعديل المختلفة، مرتّبة حسب مستوى التعقيد المتزايد.
| نوع الحقل | الوصف |
|---|---|
| مربّع اختيار | لا يظهر أي محرر عند النقر. يتم تعديل العرض على البلاطة. |
| إدخال الأرقام | محرّر النصوص الذي تمّت إضافة طبقة فوقه أعلى العرض داخل البلوك يمكن للمستخدمين الكتابة، وقد يغيّر المحرّر اللون للإشارة إلى القيم غير الصالحة. |
| أداة اختيار الزاوية | يتضمّن أداة اختيار الزاوية أداة تعديل نص لكتابة الأرقام وأداة تعديل قابلة للسحب لاختيار الزوايا بشكل مرئي. |
أوضاع العرض الأخرى
الوضع المصغّر: يصغّر المستخدم الحظر، ويعرض الحظر تمثيلاً نصيًا لقيمه باستخدام النص الذي تعرضه الحقول الفردية.
وضع تسهيل الاستخدام: قد يستخدم المستخدمون قارئ شاشة أو تكنولوجيا مشابهة للتفاعل مع Blockly. قد تتم قراءة نص الحقل للمستخدم.