ورودی های داخلی در مقابل ورودی های خارجی، ورودی های داخلی در مقابل ورودی های خارجی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ورودی ها می توانند به صورت درون خطی یا خارجی ارائه شوند. این کنترل می‌کند که آیا کانکتورهای ورودی مقدار در داخل بلوک (در خط) یا در لبه بیرونی (خارجی) رندر شوند، و همچنین اینکه آیا ورودی‌ها در ردیف‌های یکسان یا متفاوت ارائه شوند.
تعریف بلوک می تواند یک بولی اختیاری را تعیین کند که آیا ورودی ها درون خطی هستند یا نه.
JSON
{
// ...,
"inputsInline": true
}
جاوا اسکریپت
init: function() {
// ...
this.setInputsInline(true);
}
وقتی این بولی روی true تنظیم شود (ورودی های درون خطی):
- اتصال دهنده های ورودی مقدار در داخل بلوک ارائه می شوند.
- ورودی های بیانیه در ردیف خودشان ارائه می شوند.
- ورودی‌های ساختگی، انتهای ردیف و مقدار همگی در یک ردیف ارائه می‌شوند، با این تفاوت که هر ورودی پس از یک عبارت یا ورودی انتهای ردیف در یک ردیف جدید ارائه می‌شود.
وقتی روی false تنظیم می شود (ورودی های خارجی):
- اتصال دهنده های ورودی مقدار در لبه بیرونی بلوک ارائه می شوند.
- همه ورودی‌ها در ردیف خودشان رندر می‌شوند، با این تفاوت که ورودی انتهای ردیفی که از ورودی ساختگی پیروی می‌کند، در همان ردیف ورودی ساختگی ارائه می‌شود.
اگر در تجسم این موضوع مشکل دارید، بلوک‌هایی را در ابزار برنامه‌نویس Blockly ایجاد کنید و تنظیمات مختلف را برای inputs کشویی انتخاب کنید ( automatic ، external ، inline ).
اگر این بولی تعریف نشده باشد، Blockly از برخی اکتشافی ها برای حدس زدن بهترین حالت استفاده می کند. با فرض اینکه Blockly انتخاب درستی داشته باشد، ترجیح داده می شود که این فیلد تعریف نشده باقی بماند زیرا ترجمه های زبان های مختلف می توانند به طور خودکار حالت های مختلفی داشته باشند. به مثال "set %1 to %2" (ورودی های خارجی) و "put %2 in %1" (ورودی های درون خطی) به ترتیب توکن درون یابی را ببینید.
از ورودی های درون خطی زمانی استفاده کنید که یک بلوک احتمال دارد ورودی های کوچکی مانند اعداد داشته باشد. کاربر می تواند این گزینه را از طریق منوی زمینه تغییر دهد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Inline vs. external inputs\n\nInputs can be rendered **inline** or **externally**. This controls whether the\nconnectors for value inputs are rendered inside the block (inline) or on the\noutside edge (external), as well as whether inputs are rendered in the same or\ndifferent rows.\n\nThe block definition can specify an optional boolean controlling whether inputs\nare inline or not. \n\n### JSON\n\n {\n // ...,\n \"inputsInline\": true\n }\n\n### JavaScript\n\n init: function() {\n // ...\n this.setInputsInline(true);\n }\n\nWhen this boolean is set to `true` (inline inputs):\n\n- The connectors for value inputs are rendered inside the block.\n- Statement inputs are rendered on their own row.\n- Dummy, end-of-row, and value inputs are all rendered in the same row, except that any input following a statement or end-of-row input is rendered on a new row.\n\nWhen it is set to `false` (external inputs):\n\n- The connectors for value inputs are rendered on the outside edge of the block.\n- All inputs are rendered in their own row, except that an end-of-row input that follows a dummy input is rendered in the same row as the dummy input.\n\nIf you're having trouble visualizing this, construct blocks in the\n[Blockly Developer Tools](https://google.github.io/blockly-samples/examples/developer-tools/index.html) and choose different settings for the\n`inputs` dropdown (`automatic`, `external`, `inline`).\n\nIf this boolean is not defined then Blockly will use some heuristics to guess\nwhich mode is\nbest. Assuming Blockly makes the right choice, leaving this field undefined\nis preferable since different language translations can automatically have\ndifferent modes. See the example of `\"set %1 to %2\"` (external inputs) and\n`\"put %2 in %1\"` (inline inputs) in [Interpolation token\norder](/blockly/guides/create-custom-blocks/define/structure-json#interpolation_token_order).\n\nUse inline inputs when a block is likely to have small inputs such as numbers.\nThe user can toggle this option through the context menu."]]
