تشريح الحقل

القيمة

يجب أن تحتوي جميع الحقول على قيمة، وهي مصدر الحقيقة لبيانات الحقل. يمكن أن يكون أي نوع (سلسلة أو رقم أو صفيف أو تاريخ أو غير ذلك). يمكن أن تستخدم الحقول أدوات التحقق لتقييد القيم أو ترجمتها إلى تنسيق يمكن للآلة قراءته (مثل تسوية تنسيقات التاريخ).

النص

تحتوي جميع الحقول على نص، وهو سلسلة بسيطة يمكن لشخص عادي قراءتها تمثل قيمة الحقل. هذا لا يعني بالضرورة أنهما متماثلان. على سبيل المثال، قد تكون قيمة النص في الحقل المنطقي "تشغيل" أو "إيقاف"، بينما تكون قيمته "صحيحة" أو "خطأ".

هذا النص هو ما يتم عرضه عند تصغير المجموعة لأغراض تسهيل الاستخدام، ويمكن أن يكون جزءًا من العرض عند الحظر.

الحقول القابلة للتعديل في مقابل الحقول غير القابلة للتعديل

بشكل عام، تتيح الحقول القابلة للتعديل للمستخدم إجراء تغييرات على الرمز، بينما تعرض الحقول غير القابلة للتعديل معلومات للمستخدم حول الكتلة. وقد يظهر محرر منسق عند النقر على الحقول القابلة للتعديل.

تشمل الحقول القابلة للتعديل ما يلي:

تشمل الحقول غير القابلة للتعديل ما يلي:

التسلسل

يتم ترميز قيمة الحقل القابل للتسلسل بتنسيق الحفظ (JSON أو XML). جميع الحقول القابلة للتعديل قابلة للتسلسل، لأن قيمها ديناميكية. عادةً ما تكون قيم الحقول غير القابلة للتعديل غير ديناميكية، لذلك لا تكون عادةً متسلسلة.

تشمل الحقول المسلسلة ما يلي:

تشمل الحقول غير المتسلسلة ما يلي:

لاحظ كيف أن حقل "التصنيف قابل للتسلسل" غير قابل للتعديل، ولكن قابل للتسلسل. وهذا يعني أنّه لا يمكن تعديله إلا بشكل آلي، وليس من خلال واجهة مستخدم مرئية للمستخدم. بعد التعديل، يتم ترميز قيمته بتنسيق JSON/XML الذي تم إنشاؤه.

إنشاء الرمز

إلى جانب ربط الكتل وإلغاء ربطها، تُعد الحقول الطريقة الوحيدة التي يمكن للمستخدم من خلالها التحكم في الرمز الذي يتم إنشاؤه بواسطة Blockly. يتيح المحرر الذي يوفره الحقل للمستخدم تعديل القيمة المخزنة بواسطة الحقل. قد يصل منشئ الكتلة بعد ذلك إلى قيمة الحقل لاستخدامها في التعليمة البرمجية التي تم إنشاؤها.

لمزيد من المعلومات حول استخدام قيمة حقل في منشئ، يُرجى الاطّلاع على إنشاء رمز الحقل.

عرض المحتوى في الحظر

عرض الحقل داخل الحظر هو مجموعة من عناصر SVG التي تمثّل قيمة الحقل. وهي تشغل مساحة على الكتلة، وعندما يتغير حجمها، تجبر الكتلة على تغيير حجمها. يمكن أن يكون عرض الحقل داخل الحظر بسيطًا أو معقدًا، حسب احتياجاته.

هذه بعض الأمثلة على الشاشات المختلفة المعروضة في الحظر، وذلك لزيادة مستوى التعقيد.

نوع الحقل الوصف
التصنيف تحتوي على عنصر نصي فقط.
الزاوية يحتوي على مستطيل خلفية وعنصر نصي ورمز درجة.
سلحفاة يحتوي على مستطيل خلفية وعنصر نصي والعديد من عناصر SVG المستخدمة لإنشاء رسم السلحفاة.

عرض المحرّر

عندما ينقر المستخدم على حقل قابل للتعديل، قد يعرض الحقل محرِّرًا معقدًا بشكل عشوائي.

هذه بعض الأمثلة لمختلف المحررات، بهدف زيادة التعقيد.

نوع الحقل الوصف
مربّع اختيار لا يكون هناك أي محرر عند النقر عليه. يتم تعديل شاشة العرض في الحظر.
إدخال الأرقام محرِّر النصوص متراكب فوق شاشة الحظر يمكن للمستخدمين الكتابة، وقد يغيّر المحرر لونه للإشارة إلى القيم السيئة.
أداة اختيار الزاوية يحتوي منتقي الزوايا على محرِّر نصوص لكتابة الأرقام ومحرِّر قابل للسحب لاختيار الزوايا بشكل مرئي.

أوضاع العرض الأخرى

الوضع المصغّر: يصغّر المستخدم المربّع.تعرض المجموعة تمثيلاً نصيًا لقيمها، باستخدام النص المعروض في الحقول الفردية.

انهيار كتلة حقل سلحفاة

وضع تسهيل الاستخدام: قد يستخدم المستخدمون قارئ شاشة أو تكنولوجيا مشابهة للتفاعل مع تطبيق Blockly. يمكن قراءة نص الحقل بصوت عالٍ للمستخدم.