بلوکی

بسته بلوکی

کلاس ها

کلاس توضیحات
مسدود کردن کلاس برای یک بلوک معمولاً مستقیماً فراخوانی نمی شود، () workspace.newBlock ترجیح داده می شود.
BlockFlyoutInflater کلاسی که مسئول ایجاد بلوک برای پروازها است.
BlockNavigationPolicy مجموعه قوانین کنترل ناوبری صفحه کلید از یک بلوک.
BlockSvg کلاس برای نمایش SVG یک بلوک. معمولاً مستقیماً فراخوانی نمی شود، () workspace.newBlock ترجیح داده می شود.
ButtonFlyoutInflater کلاسی که مسئول ایجاد دکمه‌هایی برای پروازها است.
CodeGenerator کلاس برای یک تولید کننده کد که بلوک ها را به یک زبان ترجمه می کند.
دسته بندی CollapsibleToolbox کلاس برای یک دسته در جعبه ابزار که می تواند جمع شود.
ComponentManager مدیر تمام موارد ثبت شده در فضای کاری.
اتصال کلاس برای اتصال بین بلوک ها.
ConnectionChecker کلاس برای منطق بررسی نوع اتصال.
ConnectionDB پایگاه داده اتصالات اتصالات به ترتیب جزء عمودی خود ذخیره می شوند. به این ترتیب اتصالات در یک منطقه ممکن است به سرعت با استفاده از جستجوی دودویی جستجو شوند.
ConnectionNavigationPolicy مجموعه قوانین کنترل ناوبری صفحه کلید از یک اتصال.
ContextMenuRegistry کلاس برای رجیستری آیتم های منوی زمینه. این در نظر گرفته شده است که تک تن باشد. شما نباید یک نمونه جدید ایجاد کنید و فقط از ContextMenuRegistry.registry به این کلاس دسترسی داشته باشید.
Delete Area کلاس انتزاعی برای مؤلفه‌ای که می‌تواند بلوک یا حبابی را که در بالای آن رها شده است حذف کند.
DragTarget کلاس انتزاعی برای یک مؤلفه با رفتار سفارشی هنگامی که یک بلوک یا حباب روی آن کشیده شود یا روی آن رها شود.
فیلد چک باکس کلاس برای فیلد چک باکس.
FieldDropdown کلاس برای یک فیلد کشویی قابل ویرایش.
فیلدتصویر کلاس برای یک تصویر در یک بلوک.
فیلد لیبل کلاس برای یک فیلد متنی غیرقابل ویرایش و غیرقابل سریال.
FieldLabelSerializable کلاس برای یک فیلد متنی غیرقابل ویرایش و سریال.
Field NavigationPolicy مجموعه قوانین کنترل ناوبری صفحه کلید از یک فیلد.
شماره فیلد کلاس برای فیلد شماره قابل ویرایش.
FieldTextInput کلاس برای یک فیلد متنی قابل ویرایش.
FieldVariable کلاس برای فیلد کشویی متغیر.
FlyoutButton کلاس برای یک دکمه یا برچسب در پرواز.
FlyoutButtonNavigationPolicy مجموعه ای از قوانین کنترل ناوبری صفحه کلید از یک دکمه پرواز.
FlyoutItem نمایش یک مورد نمایش داده شده در یک پرواز.
FlyoutMetricsManager معیارهای فضای کاری یک پرواز را محاسبه می کند. معیارها عمدتاً برای اندازه‌گیری نوارهای پیمایش برای پرواز استفاده می‌شوند.
FlyoutNavigationPolicy خط مشی ناوبری عمومی که بین موارد موجود در پرواز حرکت می کند.
FlyoutNavigator
FlyoutSeparator نمایش شکاف بین عناصر در یک پرواز.
FlyoutSeparatorNavigationPolicy مجموعه قوانین کنترل ناوبری صفحه کلید از جداکننده فلای اوت. این یک مکان نگهدار بدون عملیات است، زیرا جداکننده های پرواز نمی توانند به آن پیمایش شوند.
FocusableTreeTraverser یک ابزار کمکی برای پیاده سازی IFocusableTree برای کمک به پیمایش درخت رایج.
FocusManager

تک‌تنه‌ای در هر صفحه که فوکوس Blockly را در یک یا چند درخت IFocusable مدیریت می‌کند و این فوکوس را به صورت دوطرفه با DOM همگام‌سازی می‌کند.

تماس‌گیرندگانی که می‌خواهند به‌صراحت فوکوس ورودی را برای اجزای انتخابی Blockly در صفحه تغییر دهند، باید از عملکردهای فوکوس در این مدیر استفاده کنند.

مدیر مسئول رسیدگی به رویدادهای فوکوس از DOM است (که ممکن است از کلیک کاربران بر روی عناصر صفحه ایجاد شود) و اطمینان حاصل شود که IFocusableNodeهای مربوطه به طور واضح به صورت فعال/غیرفعال برجسته شده اند، به همان شکلی که با فراخوانی به focusNode() نشان داده می شود.

ژست کلاس برای یک ژست.
شبکه کلاس برای شبکه یک فضای کاری.
HorizontalFlyout کلاس برای پرواز
ورودی کلاس برای ورودی با فیلدهای اختیاری.
InsertionMarkerPreviewer
KeyboardNavigationController KeyboardNavigationController هماهنگی رفتار ناوبری صفحه‌کلید به‌طور گسترده، مانند فعال/غیرفعال کردن تجسم کامل مکان‌نما را انجام می‌دهد.
LabelFlyoutInflater کلاس مسئول ایجاد برچسب برای پروازها.
نشانگر خط کلاس برای مکان نما خط.
نشانگر کلاس برای نشانگر. این در ناوبری صفحه کلید برای ذخیره یک مکان در Blockly AST استفاده می شود.
MarkerManager کلاس برای مدیریت نشانگرهای متعدد و مکان نما در یک فضای کاری.
منو یک کلاس منوی اولیه
آیتم منو کلاس نشان دهنده یک آیتم در یک منو.
MetricsManager مدیر تمام محاسبات متریک فضای کاری.
نام ها کلاس برای پایگاه داده ای از نام نهادها (متغیرها، رویه ها و غیره).
ناوبر کلاسی که مسئول تعیین محل تمرکز در پاسخ به دستورات پیمایش صفحه کلید است.
گزینه ها با استفاده از پیش‌فرض‌های معقول در مواردی که رفتار مشخص نشده است، گزینه‌های مشخص‌شده توسط کاربر را تجزیه کنید.
RenderedConnection کلاس برای ارتباط بین بلوک هایی که ممکن است روی صفحه نمایش داده شوند.
نوار پیمایش کلاس برای نوار اسکرول SVG خالص. این تکنیک نوار پیمایشی را ارائه می دهد که کارکرد آن تضمین شده است، اما ممکن است شبیه نوارهای پیمایش سیستم نباشد یا رفتاری نداشته باشد.
ScrollbarPair کلاس برای یک جفت اسکرول. افقی و عمودی.
SeparatorFlyoutInflater کلاسی که مسئول ایجاد جداکننده برای پروازها است.
ShortcutRegistry کلاس برای رجیستری میانبرهای صفحه کلید. این در نظر گرفته شده است که تک تن باشد. شما نباید یک نمونه جدید ایجاد کنید و فقط از ShortcutRegistry.registry به این کلاس دسترسی داشته باشید.
موضوع کلاس برای یک موضوع
مدیریت تم کلاس برای ذخیره و به روز رسانی تم و اجزای رابط کاربری یک فضای کاری.
نان تست کلاسی که امکان نمایش و رد اعلان های موقت را فراهم می کند.
جعبه ابزار کلاس برای جعبه ابزار. DOM جعبه ابزار را ایجاد می کند.
دسته جعبه ابزار کلاس برای یک دسته در جعبه ابزار.
مورد جعبه ابزار کلاس برای یک مورد در جعبه ابزار.
جداکننده جعبه ابزار کلاس برای جداکننده جعبه ابزار. این خط بصری نازکی است که روی جعبه ابزار ظاهر می شود. این مورد قابل تعامل نیست.
سطل زباله کلاس برای سطل زباله
UnattachedFieldError نشان دهنده خطایی است که در آن فیلد سعی می کند به بلوک یا اطلاعات مربوط به بلوک خود قبل از اینکه واقعاً به بلوک مذکور متصل شود، دسترسی پیدا کند.
VariableMap کلاس برای یک نقشه متغیر. این شامل یک ساختار داده فرهنگ لغت با انواع متغیر به عنوان کلید و لیستی از متغیرها به عنوان مقادیر است. لیست متغیرها از نوع مشخص شده با کلید هستند.
VariableModel کلاس برای یک مدل متغیر. اطلاعات متغیر شامل نام، شناسه و نوع را نگه می دارد.
VerticalFlyout کلاس برای پرواز
فضای کار کلاس برای یک فضای کاری این یک ساختار داده ای است که شامل بلوک ها است. هیچ رابط کاربری وجود ندارد و می توان بدون سر و صدا ایجاد کرد.
WorkspaceAudio کلاس برای بارگیری، ذخیره و پخش صدا برای یک فضای کاری.
WorkspaceDragger کلاس برای کشنده فضای کاری. هنگامی که فضای کاری توسط ماوس یا لمس کشیده می شود، فضای کاری را به اطراف حرکت می دهد.
WorkspaceNavigationPolicy مجموعه قوانین کنترل ناوبری صفحه کلید از یک فضای کاری.
WorkspaceSvg کلاس برای یک فضای کاری این یک منطقه روی صفحه با سطل زباله اختیاری، نوارهای پیمایش، حباب ها و کشیدن است.
ZoomControls کلاس برای کنترل های زوم.

کلاس های چکیده

کلاس چکیده توضیحات
میدان کلاس انتزاعی برای یک فیلد قابل ویرایش.
پرواز کلاس برای پرواز

شمارش ها

شمارش توضیحات
نوع اتصال Enum برای نوع اتصال یا ورودی.

توابع

تابع توضیحات
getFocusManager() تابع راحتی برای FocusManager.getFocusManager.
hasBubble(obj) محافظ تایپ کنید که بررسی می کند آیا شی داده شده یک IHasBubble است یا خیر.
hideChaff (opt_onlyClosePopups) نکات ابزار، منوهای زمینه، انتخاب های کشویی و غیره را ببندید.
تزریق (کانتینر، گزینه‌های انتخابی) یک ویرایشگر Blockly را به عنصر کانتینر مشخص شده (معمولاً یک div) تزریق کنید.
قابل کپی است(obj)
قابل حذف است(obj) نشان می دهد که آیا شی داده شده IDeletable است یا خیر.
isDraggable(obj) نشان می دهد که آیا شی داده شده IDraggable است یا خیر.
isIcon(obj) محافظ تایپ کنید که بررسی می کند آیا شی داده شده یک IIcon است یا خیر.
isPaster(obj)
isRenderedElement(obj)
isSelectable(obj) بررسی می کند که آیا شیء داده شده قابل انتخاب است یا خیر.
isSerializable(obj) محافظ تایپ کنید که بررسی می‌کند آیا شیء داده‌شده یک ISerializable است یا خیر.
isVariableBackedParameterModel(param) برمی‌گرداند که آیا شی داده شده یک دارنده متغیر است یا خیر.
navigateBlock (جریان، دلتا) مورد قابل پیمایش بعدی را نسبت به فرزند بلوک ارائه شده برمی گرداند.
navigateStacks (جریان، دلتا) پشته بعدی/قبلی را نسبت به پشته عنصر داده شده برمی گرداند.
setLocale(محلی)

محلی را (یعنی پیام‌های بومی‌سازی‌شده/بلاک-متن/غیره) را بر روی منطقه داده شده تنظیم می‌کند.

این کار هنگام بارگیری از برچسب اسکریپت مفید/ضروری نیست، زیرا پیام‌ها به طور خودکار در شی Blockly.Msg قرار می‌گیرند. اما ما آن را در هر دو زمینه اسکریپت تگ و غیر اسکریپت تگ ارائه می کنیم تا tscompiler بتواند به درستی فایل های تعریف نوع ما را ایجاد کند.

رابط ها

رابط توضیحات
BlocklyOptions گزینه های بلوکی
FieldCheckboxConfig گزینه های پیکربندی برای فیلد چک باکس.
FieldCheckboxFromJsonConfig گزینه های پیکربندی fromJson برای فیلد چک باکس.
FieldConfig گزینه های پیکربندی اضافی برای فیلد پایه.
FieldDropdownFromJsonConfig پیکربندی fromJson برای فیلد کشویی.
FieldImageConfig گزینه های پیکربندی برای فیلد تصویر.
FieldImageFromJsonConfig گزینه های پیکربندی fromJson برای فیلد تصویر.
FieldLabelConfig گزینه های پیکربندی برای فیلد برچسب.
FieldLabelFromJsonConfig گزینه های پیکربندی fromJson برای فیلد برچسب.
FieldNumberConfig گزینه های پیکربندی برای فیلد شماره.
FieldNumberFromJsonConfig گزینه های پیکربندی fromJson برای فیلد شماره.
FieldTextInputFromJsonConfig گزینه های پیکربندی fromJson برای قسمت ورودی متن.
FieldVariableConfig گزینه های پیکربندی برای فیلد متغیر.
FieldVariableFromJsonConfig گزینه های پیکربندی fromJson برای فیلد متغیر.
IAutoHideable رابط برای یک جزء که می تواند به طور خودکار پنهان شود.
IBoundedElement یک رابط عنصر محدود.
IBubble رابط حباب.
ICollapsibleToolboxItem رابط برای یک مورد در جعبه ابزار که می تواند جمع شود.
آی کامپوننت رابط برای یک جزء فضای کاری که می تواند با ComponentManager ثبت شود.
IConnectionChecker کلاس برای منطق بررسی نوع اتصال.
IConnectionPreviewer نمایش "پیش نمایش" بصری از محل اتصال بلوک در صورت رها شدن.
IContextMenu
قابل کپی
ID قابل حذف رابط برای یک شی که می تواند حذف شود.
IDelete Area رابط برای مؤلفه ای که می تواند بلوک یا حبابی را که در بالای آن رها شده است حذف کند.
قابل کشش نشان دهنده یک شی است که می توان آن را کشید.
IDragger
استراتژی IDrag
IDragTarget رابط برای یک مؤلفه با رفتار سفارشی هنگامی که یک بلوک یا حباب روی آن کشیده می شود یا روی آن رها می شود.
IFlyout رابط برای پرواز.
IFlyoutInflater
IFocusableNode نشان دهنده هر چیزی است که می تواند تمرکز ورودی داشته باشد.
IFocusableTree

درختی از عناصر قابل تمرکز را با زمینه تمرکز فعال/غیرفعال خود نشان می دهد.

توجه داشته باشید که تمرکز توسط FocusManager مدیریت می شود و پیاده سازی های درختی می توانند حداکثر یک IFocusableNode را در یک زمان متمرکز کنند. اگر خود درخت فوکوس داشته باشد، گره متمرکز درخت «فعال» در نظر گرفته می شود (اگر درخت دیگری فوکوس داشته باشد، «منفعل» است.

فوکوس بین یک یا چند درخت به اشتراک گذاشته می شود، جایی که هر درخت می تواند دقیقاً یک گره فعال یا غیرفعال داشته باشد (و فقط یک گره فعال می تواند در کل صفحه در هر زمان معین وجود داشته باشد). ایده فوکوس غیرفعال این است که زمینه ای را برای کاربران فراهم کند که در آن هنگام بازگشت به درختی که قبلاً متمرکز شده بود، تمرکز آنها بازیابی می شود.

توجه داشته باشید که اگر گره متمرکز فعلی درخت (غیرفعال یا فعال) مورد نیاز باشد، می توان از FocusableTreeTraverser.findFocusedNode استفاده کرد.

توجه داشته باشید که اگر گره های خاصی برای بازیابی این درخت نیاز است، از lookUpFocusableNode یا FocusableTreeTraverser.findFocusableNodeFor استفاده کنید.

IHasBubble
IIcon
IKeyboard قابل دسترسی رابطی برای یک شی که میانبرهای صفحه کلید را مدیریت می کند.
ImageProperties تعریف گزینه کشویی تصویر قابل خواندن توسط انسان.
IMetricsManager رابط برای یک مدیر متریک.
غیر متحرک رابط برای یک شی که متحرک است.
سیاست INavigation مجموعه ای از قوانین که مشخص می کند ناوبری صفحه کلید کجا باید ادامه یابد.
IPaster یک شی که می تواند داده ها را در یک فضای کاری جایگذاری کند.
قابل جابجایی رابط برای یک جزء که در بالای فضای کاری قرار دارد.
قابل ثبت رابط برای یک جزء Blockly که می تواند ثبت شود.
IRenderedElement
قابل انتخاب

رابط برای یک شی که قابل انتخاب است.

معمولاً از پیاده‌سازی‌ها انتظار می‌رود که از پیاده‌سازی‌های onNodeFocus() و onNodeBlur() برای فراخوانی setSelected() با خودشان و null استفاده کنند تا اطمینان حاصل شود که انتخاب‌ها به‌درستی به‌روزرسانی شده و رویداد تغییر انتخاب فعال می‌شود.

ISelectableToolboxItem رابط برای یک مورد در جعبه ابزار که می تواند انتخاب شود.
ISerializable
IStyleable رابط برای یک شی که یک سبک می تواند به آن اضافه شود.
جعبه ابزار رابط برای جعبه ابزار.
آیتم جعبه ابزار رابط برای یک مورد در جعبه ابزار.
IVariableBackedParameterModel رابط برای یک مدل پارامتر که دارای یک مدل متغیر است.
IVariableMap

نقشه های متغیر، اشیاء کانتینری هستند که مسئول ذخیره و مدیریت مجموعه ای از متغیرهای ارجاع شده در یک فضای کاری هستند.

هر یک از این روش‌ها ممکن است متغیرهایی را تعریف کند که نام‌ها و انواع آن‌ها قانونی هستند و در صورت عدم رعایت آنها، آنها را پرتاب می‌کند.

مدل IVariable
IVariableState وضعیت یک متغیر معین را نشان می دهد.
ToastOptions گزینه های نمایش/پیکربندی برای اعلان نان تست.

فضاهای نام

فضای نام توضیحات
مسدود کردن
بلاک انیمیشن ها
blockRendering
مرورگر رویدادها
حباب ها
bumpObjects
کلیپ بورد
دسته بندی CollapsibleToolbox
نظرات
مشترک
ComponentManager
ثابت ها
Context Menu
ContextMenuItems
ContextMenuRegistry
Css
گفتگو
کشیدن
رویدادها
برنامه های افزودنی
فیلدرجیستری
گراس
نمادها
قابل کپی
ورودی ها
لایه ها
libraryBlocks
MetricsManager
نام ها
گزینه ها
رویه ها
رجیستری
RenderedConnection
renderManagement
سریال سازی
Shortcut Items
ShortcutRegistry
موضوع
مدیریت تم
تم ها
تراسوس
نان تست گزینه‌هایی برای نحوه تهاجمی نان تست‌ها توسط خوانندگان صفحه نمایش. مقادیر مربوط به مقادیر برای aria-live است.
دسته جعبه ابزار
جداکننده جعبه ابزار
راهنمای ابزار
لمس کنید
uiPosition
کاربردها
متغیرها
متغیرها پویا
WidgetDiv
Xml
zelos

متغیرها

متغیر توضیحات
بلوک ها نقشه برداری از نام های نوع بلوک برای مسدود کردن اشیاء نمونه اولیه.
COLLAPSE_CHARS
COLLAPSED_FIELD_NAME
COLLAPSED_INPUT_NAME
پیکربندی شیء دارای تمام مقادیری در Blockly است که انتظار داریم توسعه دهندگان بتوانند آن را تغییر دهند.
defineBlocksWithJsonArray بلوک‌ها را از آرایه‌ای از تعاریف بلوک JSON، همانطور که ممکن است توسط ابزار توسعه‌دهنده Blockly ایجاد شود، تعریف کنید.
DELETE_VARIABLE_ID
DropDownDiv
getMainWorkspace فضای کار اصلی را برمی گرداند. آخرین فضای کاری اصلی استفاده شده (بر اساس تمرکز) را برمی گرداند. سعی کنید از این تابع استفاده نکنید، به خصوص اگر چندین نمونه Blockly در یک صفحه وجود دارد.
getSelected شیء قابل کپی انتخاب شده فعلی را برمی گرداند.
INPUT_VALUE
جاوا اسکریپت
keyboardNavigationController نمونه Singleton از کنترلر ناوبری صفحه کلید.
پیام فرهنگ لغت پیام های محلی.
NEXT_STATEMENT
OPPOSITE_TYPE
OUTPUT_VALUE
PREVIOUS_STATEMENT
PROCEDURE_CATEGORY_NAME رشته ای برای استفاده در ویژگی «سفارشی» یک دسته در جعبه ابزار XML. این رشته نشان می دهد که دسته باید به صورت پویا با بلوک های رویه پر شود.
RENAME_VARIABLE_ID
setParentContainer ظرف والد را تنظیم کنید. این عنصر ظرفی است که WidgetDiv، dropDownDiv و Tooltip در اولین باری که Blockly.inject فراخوانی می‌شود، ارائه می‌شوند. این روش اگر بعد از اولین Blockly.inject فراخوانی شود، یک NOP است.
svgResize اندازه تصویر SVG را طوری تنظیم کنید که محفظه آن کاملاً پر شود. زمانی که نما واقعاً اندازه ها را تغییر می دهد، این را صدا بزنید (مثلاً در تغییر اندازه پنجره/تغییر جهت دستگاه). برای تغییر اندازه فضای کاری هنگام تغییر محتویات (مثلاً هنگامی که یک بلوک اضافه یا حذف می شود) به workspace.resizeContents مراجعه کنید. ارتفاع/عرض تصویر SVG را ثبت کنید.
TOOLBOX_AT_BOTTOM
TOOLBOX_AT_LEFT
TOOLBOX_AT_RIGHT
TOOLBOX_AT_TOP
VARIABLE_CATEGORY_NAME رشته ای برای استفاده در ویژگی «سفارشی» یک دسته در جعبه ابزار XML. این رشته نشان می دهد که دسته باید به صورت پویا با بلوک های متغیر پر شود.
VARIABLE_DYNAMIC_CATEGORY_NAME رشته ای برای استفاده در ویژگی «سفارشی» یک دسته در جعبه ابزار XML. این رشته نشان می دهد که دسته باید به صورت پویا با بلوک های متغیر پر شود.
VERSION نسخه Blockly core. این ثابت توسط اسکریپت ساخت (npm run build) به مقدار نسخه در package.json لغو می شود. این کار توسط Closure Compiler در کار buildCompressed gulp انجام می شود. برای ساخت‌های محلی، می‌توانید --define='Blockly.VERSION=XYZ' را به کامپایلر ارسال کنید تا این ثابت را لغو کند.

نام مستعار را تایپ کنید

نام مستعار را تایپ کنید توضیحات
FieldCheckbox Validator تابعی که برای اعتبارسنجی تغییرات مقدار فیلد قبل از تنظیم فراخوانی می شود.
FieldDropdownConfig گزینه های پیکربندی برای فیلد کشویی.
FieldDropdown Validator تابعی که برای اعتبارسنجی تغییرات مقدار فیلد قبل از تنظیم فراخوانی می شود.
FieldNumber Validator تابعی که برای اعتبارسنجی تغییرات مقدار فیلد قبل از تنظیم فراخوانی می شود.
FieldTextInputConfig گزینه های پیکربندی برای فیلد ورودی متن.
FieldTextInput Validator تابعی که برای اعتبارسنجی تغییرات مقدار فیلد قبل از تنظیم فراخوانی می شود.
Field Validator تابعی که برای اعتبارسنجی تغییرات مقدار فیلد قبل از تنظیم فراخوانی می شود.
FieldVariableValidator تابعی که برای اعتبارسنجی تغییرات مقدار فیلد قبل از تنظیم فراخوانی می شود.
ICopyData
MenuGenerator آرایه ای از گزینه های منو یا تابعی که آرایه ای از گزینه های منو را برای FieldDropdown یا فرزندان آن ایجاد می کند.
MenuGenerator Function تابعی که آرایه ای از گزینه های منو را برای FieldDropdown یا فرزندان آن ایجاد می کند.
گزینه منو یک گزینه فردی در منوی کشویی. می تواند separator لفظی رشته ای برای یک آیتم جداکننده منو یا آرایه ای برای آیتم های منوی عملکرد معمولی باشد. در مورد دوم، عنصر اول مقدار قابل خواندن توسط انسان (متن، شی ImageProperties یا عنصر HTML) و عنصر دوم مقدار خنثی زبان است.
ReturnEphemeralFocus

برای بازگشت فوکوس به FocusManager پس از تکمیل یک جریان UI زودگذر (مانند یک گفتگو) اعلان تایپ کنید.

برای جزئیات بیشتر به FocusManager.takeEphemeralFocus مراجعه کنید.