کلاس WorkspaceSvg
کلاس برای یک فضای کاری این یک منطقه روی صفحه با سطل زباله اختیاری، نوارهای پیمایش، حباب ها و کشیدن است.
امضا:
export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationSvg
گسترش می دهد: فضای کاری
پیاده سازی: IASTNodeLocationSvg
سازندگان
| سازنده | اصلاح کننده ها | شرح |
|---|---|---|
| (سازنده) (گزینه ها) | یک نمونه جدید از کلاس WorkspaceSvg می سازد |
خواص
| ویژگی | اصلاح کننده ها | تایپ کنید | شرح |
|---|---|---|---|
| configureContextMenu | ((گزینه های منو: ContextMenuOption[]، e: رویداد) => void) | خالی | توسعه دهندگان ممکن است این عملکرد را برای اضافه کردن گزینه های منوی سفارشی به منوی زمینه فضای کاری یا ویرایش مجموعه ای از گزینه های منو ایجاد شده توسط فضای کاری تعریف کنند. | |
| حالت دسترسی به صفحه کلید | بولی | اگر حالت دسترسی به صفحه کلید روشن باشد درست است، در غیر این صورت نادرست است. | |
| ارائه شده است | بولی | وضعیت رندر یک فضای کاری SVG. برای فضاهای کاری بدون سر false و برای نمونه‌هایی از WorkspaceSvg درست است. | |
| مقیاس | عدد | مقیاس فعلی. | |
| نوارچرخ | ScrollbarPair | خالی | نوارهای پیمایش این فضای کاری، در صورت وجود. | |
| scrollX | عدد | پیمایش افقی فعلی در واحدهای پیکسل، نسبت به مبدأ فضای کاری جابه‌جا می‌شود. فکر کردن به یک منظره و یک بوم که در زیر آن منظره حرکت می کند مفید است. همانطور که بوم به سمت راست حرکت می کند، این مقدار مثبت تر می شود و نمای اکنون سمت چپ بوم را "دیدن" می کند. همانطور که بوم به سمت چپ حرکت می کند، این مقدار منفی تر می شود و نما اکنون سمت راست بوم را "دیدن" می کند. نکته گیج کننده در مورد این مقدار این است که شامل offset absoluteLeft نیست و نباید باشد. این به این دلیل است که برای محاسبه مقدار viewLeft استفاده می شود. viewLeft نسبت به مبدا فضای کاری است (اگرچه در واحد پیکسل). مبدا فضای کاری گوشه سمت چپ بالای فضای کاری است (حداقل زمانی که فعال باشد). از سمت چپ بالای blocklyDiv جابجا می شود تا زیر جعبه ابزار قرار نگیرد. هنگامی که فضای کاری فعال است، viewLeft و مبدا فضای کاری در یک مکان X هستند. با لغزش بوم به سمت راست در زیر نما، این مقدار (scrollX) مثبت‌تر می‌شود و viewLeft نسبت به مبدأ فضای کاری منفی‌تر می‌شود (تصور کنید مبدا فضای کار به صورت نقطه‌ای روی بوم با حرکت بوم به سمت راست می‌لغزد) . بنابراین اگر scrollX بخواهد absolutLeft را شامل شود، به نوعی مبدا فضای کاری را تغییر می دهد. این بدان معنی است که viewLeft به جای لبه سمت چپ فضای کاری، لبه سمت چپ blocklyDiv را نشان می دهد. | |
| پیمایش کنید | عدد | پیمایش عمودی فعلی در واحدهای پیکسل، نسبت به مبدأ فضای کاری جابه‌جا می‌شود. فکر کردن به یک منظره و یک بوم که در زیر آن منظره حرکت می کند مفید است. همانطور که بوم به سمت پایین حرکت می کند، این مقدار مثبت تر می شود و نمای اکنون قسمت بالایی بوم را "دیدن" می کند. با بالا رفتن بوم، این مقدار منفی تر می شود و نمای قسمت پایینی بوم را "دیدن" می کند. نکته گیج کننده در مورد این مقدار این است که این مقدار را شامل نمی شود و نباید offset absoluteTop را شامل شود. این به این دلیل است که برای محاسبه مقدار viewTop استفاده می شود. ViewTop نسبت به مبدا فضای کاری است (البته در واحد پیکسل). مبدا فضای کاری گوشه سمت چپ بالای فضای کاری است (حداقل زمانی که فعال باشد). از سمت چپ بالای blocklyDiv جابجا می شود تا زیر جعبه ابزار قرار نگیرد. وقتی فضای کاری فعال است، viewTop و مبدا فضای کاری در یک مکان Y هستند. با لغزش بوم به سمت پایین، این مقدار (scrollY) مثبت‌تر می‌شود و viewTop نسبت به مبدا فضای کار منفی‌تر می‌شود (تصویر در مبدا فضای کار به صورت نقطه‌ای روی بوم که با حرکت بوم به سمت پایین می‌لغزد). بنابراین، اگر ScrollY شامل AbsoluteTop باشد، به نوعی مبدا فضای کاری را تغییر می دهد. این بدان معنی است که viewTop به جای لبه بالای فضای کاری، لبه بالایی blocklyDiv را نشان می دهد. | |
| startScrollX | عدد | مقدار اسکرول افقی هنگام شروع پیمایش در واحد پیکسل. | |
| startScrollY | عدد | مقدار پیمایش عمودی هنگام شروع پیمایش در واحدهای پیکسل. | |
| svgBackground_ | SVGElement | ||
| svgBlockCanvas_ | SVGElement | ||
| svgBubbleCanvas_ | SVGElement | ||
| svgGroup_ | SVGElement | ||
| themeManager_ | protected | مدیریت تم | |
| سطل زباله | سطل زباله | خالی | سطل زباله فضای کار (در صورت وجود). | |
| zoomControls_ | ZoomControls | خالی |
مواد و روش ها
| روش | اصلاح کننده ها | شرح |
|---|---|---|
| addTopBlock(block) | یک بلوک را به لیست بلوک های برتر اضافه می کند. | |
| addTopBoundedElement(عنصر) | یک عنصر محدود را به لیست عناصر محدود بالا اضافه می کند. | |
| addTopComment (نظر) | یک نظر به لیست نظرات برتر اضافه می کند. | |
| centerOnBlock (ID, blockOnly) | فضای کاری را به مرکز بلوک داده شده اسکرول کنید. اگر بلوک دارای بلوک های دیگری در زیر آن باشد، فضای کاری روی پشته متمرکز می شود، مگر اینکه blockOnly درست باشد. | |
| پاک کردن() | با مرتب کردن تمام بلوک ها در یک ستون، فضای کاری را تمیز کنید. | |
| واضح () | با بهینه سازی برای جلوگیری از تغییر اندازه، تمام بلوک ها را در فضای کاری دور بریزید. | |
| createDom(opt_backgroundClass، injectionDiv) | عناصر DOM فضای کاری را ایجاد کنید. | |
| createVariable (نام، نوع_opt، opt_id) | یک متغیر جدید با نام داده شده ایجاد کنید. Flyout را به‌روزرسانی کنید تا متغیر جدید فوراً نشان داده شود. | |
| deleteVariableById(id) | حذف یک متغیر توسط شناسه ارسال شده Flyout را به روز کنید تا فوراً نشان دهید که متغیر حذف شده است. | |
| در معرض قرار دادن() | این فضای کاری را دور بریزید. برای جلوگیری از نشت حافظه، همه عناصر DOM را قطع کنید. | |
| getAllBlocks (سفارش شده) | همه بلوک ها را در فضای کاری پیدا کنید. بلوک ها به صورت اختیاری بر اساس موقعیت مرتب می شوند. از بالا به پایین (با کمی تعصب LTR یا RTL). | |
| getAudioManager() | مدیر صوتی این فضای کاری را دریافت کنید. | |
| getBlockById(id) | بلوک را در این فضای کاری با شناسه مشخص شده پیدا کنید. | |
| getBlocksBoundingBox() | کادر محدود کننده بلوک های فضای کاری را محاسبه کنید. سیستم مختصات: مختصات فضای کاری. | |
| getBubbleCanvas() | عنصر SVG را که سطح حباب را تشکیل می دهد، دریافت کنید. | |
| getButtonCallback (کلید) | برای کلیک بر روی دکمه‌ها و برچسب‌ها، تابع تماس مرتبط با یک کلید مشخص را دریافت کنید. | |
| getCanvas() | عنصر SVG را که سطح طراحی را تشکیل می دهد، دریافت کنید. | |
| getComponentManager() | مدیر مؤلفه این فضای کاری را دریافت می کند. | |
| getCursor() | مکان نما برای این فضای کاری. | |
| getDragTarget(e) | هدف کشیدن را برمی‌گرداند که رویداد نشانگر به پایان رسیده است. | |
| getFlyout (opt_own) | دریافت کننده برای پرواز مرتبط با این فضای کاری. بسته به پیکربندی جعبه ابزار ممکن است متعلق به جعبه ابزار یا فضای کاری باشد. در صورت عدم وجود پرواز باطل خواهد بود. | |
| getGrid() | شی grid را برای این فضای کاری دریافت کنید یا اگر وجود ندارد، آن را خالی کنید. | |
| getInverseScreenCTM() | دریافت کننده برای CTM صفحه معکوس. | |
| getMarkerManager() | مدیر نشانگر را برای این فضای کاری دریافت کنید. | |
| getMetricsManager() | مدیر معیارهای این فضای کاری را دریافت می کند. | |
| getParentSvg() | عنصر SVG را دریافت کنید که حاوی این فضای کاری است. توجه: ما فرض می کنیم که این فقط پس از تزریق فضای کاری به DOM فراخوانی می شود. | |
| getRenderer() | رندر بلوک متصل به این فضای کاری را دریافت کنید. | |
| getRootWorkspace() | ||
| getScale() | فاکتور بزرگنمایی فضای کاری را دریافت کنید. اگر فضای کاری دارای والد باشد، برای دریافت مقیاس فضای کاری به والد فراخوانی می کنیم. | |
| getSvgGroup() | گروه SVG را برای فضای کاری برمی گرداند. | |
| getTheme() | شی موضوع فضای کاری را دریافت کنید. | |
| getToolbox() | در صورت وجود، جعبه ابزار مرتبط با این فضای کاری را دریافت کنید. | |
| getToolboxCategoryCallback (کلید) | برای پر کردن دسته‌های جعبه ابزار سفارشی در این فضای کاری، تابع پاسخ به تماس مرتبط با یک کلید مشخص را دریافت کنید. | |
| getTopBlocks (سفارش شده) | بلوک های سطح بالا را پیدا کرده و آنها را برمی گرداند. بلوک ها به صورت اختیاری بر اساس موقعیت مرتب می شوند. از بالا به پایین (با کمی تعصب LTR یا RTL). | |
| getTopBoundedElements() | عناصر محدود شده سطح بالا را پیدا کرده و آنها را برمی گرداند. | |
| getWidth() | افست افقی فضای کاری را برمی گرداند. برای سازگاری LTR/RTL در XML در نظر گرفته شده است. | |
| hideChaff (فقط ClosePopups) | نکات ابزار، منوهای زمینه، انتخاب های کشویی و غیره را ببندید. | |
| hideComponents (فقطClosePopups) | هر مؤلفه‌ای که به‌طور خودکار پنهان می‌شوند (مانند flyout، trashcan و هر مؤلفه‌ای که کاربر ثبت کرده است) را پنهان کنید. | |
| highlightBlock(id, opt_state) | یک بلوک در فضای کاری را برجسته یا حذف کنید. برجسته سازی بلوک اغلب برای علامت گذاری بصری بلوک هایی که در حال حاضر اجرا می شوند استفاده می شود. | |
| isDraggable() | آیا این فضای کاری قابل کشیدن است؟ | |
| isDragging() | آیا کاربر در حال حاضر یک بلوک را می کشد یا در فضای پرواز/فضای کاری پیمایش می کند؟ | |
| isMovable() | آیا این فضای کاری متحرک است؟ این بدان معنی است که کاربر می تواند مختصات XY فضای کاری را از طریق ورودی تغییر مکان دهد. این می تواند از طریق نوارهای پیمایش، چرخ اسکرول، کشیدن، یا از طریق بزرگنمایی با چرخ پیمایش یا خرج کردن باشد (زیرا بزرگنمایی روی موقعیت ماوس متمرکز است). این شامل بزرگنمایی با کنترل‌های بزرگنمایی نمی‌شود، زیرا مختصات XY به صورت برنامه‌ریزی تعیین می‌شوند. | |
| isMovableHorizontally() | آیا این فضای کاری به صورت افقی قابل جابجایی است؟ | |
| isMovableVertically() | آیا این فضای کاری به صورت عمودی قابل جابجایی است؟ | |
| isVisible() | دریافت کننده برای isVisible | |
| markFocused() | این فضای کاری را به عنوان فضای کاری اصلی متمرکز فعلی علامت گذاری کنید. | |
| moveDrag(e) | کشیدن یک شی را در این فضای کاری ردیابی کنید. | |
| newBlock(PrototypeName, opt_id) | یک بلوک جدید ایجاد کنید. | |
| خمیر (حالت) | بلوک یا نظر فضای کاری ارائه شده را در فضای کاری جای‌گذاری می‌کند. بررسی نمی کند که آیا ظرفیت باقی مانده برای شی وجود دارد یا خیر، این باید قبل از فراخوانی این روش انجام شود. | |
| recordDragTargets() | فهرستی از تمام مناطق حذف شده برای این فضای کاری تهیه کنید. | |
| refreshTheme() | پس از به‌روزرسانی تم، همه بلوک‌های موجود در فضای کاری را بازخوانی کنید. | |
| registerButtonCallback (کلید، تابع) | برای کلیک بر روی دکمه‌ها و برچسب‌ها در پرواز، یک تابع تماس مرتبط با یک کلید مشخص را ثبت کنید. به عنوان مثال، دکمه ای که توسط XML مشخص شده است باید با یک فراخوانی به registerButtonCallback ("CREATE_VARIABLE"، yourCallbackFunction) مطابقت داده شود. | |
| registerToolboxCategoryCallback (کلید، تابع) | برای پر کردن دسته‌های جعبه ابزار سفارشی در این فضای کاری، یک تابع پاسخ به تماس مرتبط با یک کلید مشخص را ثبت کنید. به عنوان مثال، دسته بندی متغیر و رویه را ببینید. | |
| removeButtonCallback (کلید) | برای کلیک بر روی یک دکمه در پرواز، پاسخ تماس را حذف کنید. | |
| removeToolboxCategoryCallback (کلید) | برای کلیک بر روی نام دسته سفارشی در جعبه ابزار، پاسخ تماس را حذف کنید. | |
| removeTopBlock(block) | یک بلوک را از لیست بلوک های برتر حذف می کند. | |
| removeTopBoundedElement(عنصر) | یک عنصر محدود را از لیست عناصر محدود بالا حذف می کند. | |
| removeTopComment (نظر) | یک نظر را از لیست نظرات برتر حذف می کند. | |
| renameVariableById(id, newName) | با به روز رسانی نام متغیر در نقشه متغیر، نام آن را تغییر دهید. Flyout را به روز کنید تا متغیر تغییر نام داده شده را فوراً نشان دهید. | |
| ارائه دادن() | همه بلوک ها را در فضای کاری رندر کنید. | |
| تغییر اندازه () | تغییر اندازه و تغییر مکان تمام فضای کاری کروم (جعبه ابزار، سطل زباله، نوارهای پیمایش و غیره) زمانی که چیزی تغییر می کند که نیاز به محاسبه مجدد ابعاد و موقعیت های سطل زباله، بزرگنمایی، جعبه ابزار و غیره دارد (مثلاً تغییر اندازه پنجره) این مورد باید فراخوانی شود. | |
| scrollCenter() | فضای کار را در مرکز قرار دهید. | |
| setResizeHandlerWrapper(handler) | داده های کنترل کننده تغییر اندازه را ذخیره کنید تا بتوانیم بعداً آن را حذف کنیم. | |
| setResizesEnabled(فعال) | به‌روزرسانی کنید که آیا این فضای کاری تغییر اندازه را فعال کرده است یا خیر. در صورت فعال بودن، اندازه فضای کاری در صورت لزوم تغییر می کند. اگر غیرفعال باشد، اندازه فضای کاری تا زمانی که دوباره فعال نشود تغییر نخواهد کرد. برای جلوگیری از تغییر اندازه در طول عملیات دسته ای، برای عملکرد استفاده کنید. | |
| setScale (newScale) | ضریب بزرگنمایی فضای کاری را تنظیم کنید. | |
| setTheme (موضوع) | شی موضوع فضای کاری را تنظیم کنید. اگر هیچ طرح زمینه ای ارسال نشد، به طور پیش فرض طرح زمینه Classic را انتخاب کنید. | |
| setVisible (isVisible) | قابلیت مشاهده فضای کاری را تغییر می دهد. در حال حاضر فقط برای فضای کار اصلی در نظر گرفته شده است. | |
| startDrag(e، xy) | ردیابی کشیدن یک شی را در این فضای کاری شروع کنید. | |
| ترجمه (x، y) | این فضای کاری را به مختصات جدید ترجمه کنید. | |
| updateInverseScreenCTM() | CTM صفحه معکوس را به عنوان کثیف علامت بزنید. | |
| updateToolbox(toolboxDef) | درخت بلوک را در جعبه ابزار موجود تغییر دهید. | |
| بزرگنمایی (x، y، مقدار) | فضای کاری را نسبت به/مرکز مختصات داده شده (x,y) بزرگنمایی یا کوچکنمایی می‌کند. | |
| ZoomCenter(نوع) | بزرگنمایی بلوک ها در مرکز دید با بزرگنمایی یا کوچکنمایی. | |
| zoomToFit() | در صورت امکان بلوک‌ها را بزرگنمایی کنید تا در فضای کاری قرار بگیرند. |