ارزش
همه فیلدها باید دارای یک مقدار باشند که منبع حقیقت برای داده های فیلد است. این می تواند از هر نوع باشد (رشته، عدد، آرایه، تاریخ و غیره). فیلدها ممکن است از اعتبار سنجی برای محدود کردن مقادیر یا ترجمه به یک قالب قابل خواندن توسط ماشین استفاده کنند (مثلاً نرمال کردن قالب‌های تاریخ).
متن
همه فیلدها حاوی متن هستند که یک رشته ساده قابل خواندن توسط انسان است که مقدار فیلد را نشان می دهد. این لزوما به این معنی نیست که آنها یکسان هستند. به عنوان مثال، متن در یک فیلد بولی ممکن است "روشن" یا "خاموش" باشد، در حالی که مقدار آن "درست" یا "نادرست" است.
این متن چیزی است که هنگام جمع شدن بلوک، برای دسترسی، نمایش داده می شود و ممکن است به صورت اختیاری بخشی از نمایشگر روی بلوک باشد.
فیلدهای قابل ویرایش در مقابل غیرقابل ویرایش
به طور کلی، فیلدهای قابل ویرایش به کاربر اجازه می دهد تا تغییراتی در کد ایجاد کند، در حالی که فیلدهای غیرقابل ویرایش اطلاعات مربوط به بلوک را به کاربر نمایش می دهند. فیلدهای قابل ویرایش ممکن است با کلیک کردن، یک ویرایشگر غنی را نشان دهند.
فیلدهای قابل ویرایش عبارتند از:
فیلدهای غیر قابل ویرایش عبارتند از:
سریال سازی
مقدار یک فیلد سریال‌سازی شده در قالب ذخیره (JSON یا XML) کدگذاری می‌شود. همه فیلدهای قابل ویرایش قابل سریال سازی هستند، زیرا مقادیر آنها پویا هستند. مقادیر فیلدهای غیرقابل ویرایش معمولاً پویا نیستند، بنابراین معمولاً سریالی نیستند.
فیلدهای سریالی عبارتند از:
فیلدهای بدون سریال عبارتند از:
توجه داشته باشید که چگونه فیلد Label Serializable قابل ویرایش نیست، اما قابل سریال سازی است. این بدان معنی است که فقط می توان آن را به صورت برنامه نویسی ویرایش کرد، نه از طریق یک رابط کاربری قابل مشاهده برای کاربر. پس از ویرایش، مقدار آن در JSON/XML ایجاد شده کدگذاری می شود.
تولید کد
علاوه بر اتصال و قطع بلوک ها، فیلدها تنها راهی هستند که کاربر می تواند کد تولید شده توسط Blockly را کنترل کند. ویرایشگر ارائه شده توسط یک فیلد به کاربر اجازه می دهد مقدار ذخیره شده توسط فیلد را تغییر دهد. سپس مولد بلوک ممکن است به مقدار فیلد برای استفاده در کد تولید شده دسترسی پیدا کند.
برای اطلاعات بیشتر در مورد استفاده از مقدار فیلد در یک مولد ، تولید کد فیلد را ببینید.
نمایشگر روی بلوک
نمایش روی بلوک یک فیلد مجموعه ای از عناصر SVG است که مقدار فیلد را نشان می دهد. آنها فضای بلوک را اشغال می کنند و با تغییر اندازه بلوک را مجبور به تغییر اندازه می کنند. نمایش روی بلوک یک میدان بسته به نیاز آن می تواند ساده یا پیچیده باشد.
اینها چند نمونه از نمایشگرهای مختلف روی بلوک به ترتیب افزایش پیچیدگی هستند.
| نوع میدان | شرح |
|---|---|
| برچسب | فقط شامل یک عنصر متنی است. |
| زاویه | شامل یک پس‌زمینه راست، عنصر متن و نماد درجه است. |
| لاک پشت | شامل یک پس زمینه rect، عنصر متن و بسیاری از عناصر SVG است که برای ساختن گرافیک لاک پشت استفاده می شود. |
نمایش ویرایشگر
وقتی کاربر روی یک فیلد قابل ویرایش کلیک می کند، ممکن است این فیلد یک ویرایشگر پیچیده دلخواه نمایش دهد.
اینها چند نمونه از ویرایشگرهای مختلف به ترتیب افزایش پیچیدگی هستند.
| نوع میدان | شرح |
|---|---|
| چک باکس | بدون ویرایشگر وقتی کلیک کنید. صفحه نمایش روی بلوک به روز می شود. |
| ورودی شماره | ویرایشگر متن در بالای صفحه نمایش روی بلوک قرار گرفته است. کاربران می توانند تایپ کنند؛ ویرایشگر ممکن است رنگ را برای نشان دادن مقادیر بد تغییر دهد. |
| انتخابگر زاویه | انتخابگر زاویه دارای یک ویرایشگر متن برای تایپ اعداد و یک ویرایشگر قابل کشیدن برای انتخاب زاویه به صورت بصری است. |
سایر حالت های نمایش
حالت جمع شده: کاربر بلوک را جمع می کند. بلوک یک نمایش متنی از مقادیر آن را با استفاده از متن بازگردانده شده توسط فیلدهای جداگانه نمایش می دهد.
حالت دسترس‌پذیری: کاربران ممکن است از صفحه‌خوان یا فناوری مشابه برای تعامل با Blockly استفاده کنند. ممکن است متن فیلد برای کاربر خوانده شود.