حزمة بشكل كتل
صفوف
دورات تدريبية | الوصف |
---|---|
ASTNode | فئة عقدة AST. يُنصح باستخدام إحدى طرق createNode بدلاً من إنشاء عقدة مباشرةً. |
BasicCursor | فئة للمؤشر الأساسي. يتيح ذلك للمستخدم الانتقال إلى جميع العُقد في AST من خلال النقر على "التالي" أو "السابق". |
حظر | صف لمبنى واحد لا يستدعي عادةً هذا الإجراء مباشرةً، يُفضَّل استخدام workspace.newBlock() . |
BlockDragger | فئة لسحب الكتل فهي تحرّك الكتل حول مساحة العمل عند سحبها بالماوس أو اللمس. |
BlockSvg | فئة تمثيل SVG للكتلة لا يستدعي عادةً هذا الإجراء مباشرةً، يُفضَّل استخدام workspace.newBlock() . |
BubbleDragger | صف لسحب الفقاعات. إنها تحرّك الأشياء على لوحة الفقاعة حول مساحة العمل عند سحبها بالماوس أو اللمس. يمكن أن تكون حظر التعليقات أو أدوات التغيير أو التحذيرات أو تعليقات مساحة العمل. |
CodeGenerator | صف حول أداة إنشاء رموز يترجم الكتل إلى لغة |
CollapsibleToolboxCategory | فئة لفئة في مربّع أدوات يمكن تصغيره. |
ComponentManager | مدير لجميع العناصر المسجَّلة في مساحة العمل |
الاتصال | فئة للاتصال بين الكتل |
ConnectionChecker | فئة للتحقق المنطقي من نوع الاتصال |
ConnectionDB | قاعدة بيانات الاتصالات. يتم تخزين الاتصالات بترتيب مكونها الرأسي. بهذه الطريقة، قد يتم البحث عن الاتصالات في إحدى المناطق بسرعة باستخدام بحث ثنائي. |
ContextMenuRegistry | صف لتسجيل عناصر قائمة السياق. ومن المفترض أن تكون هذه الجملة مفردة. يجب ألا تنشئ مثيلاً جديدًا، وأن تصل فقط إلى هذه الفئة من Context MenuRegistry.registry. |
المؤشر | فئة للمؤشر. يتحكّم المؤشر في كيفية انتقال المستخدِم في شريط تمرير AST في Blockly. |
DeleteArea | فئة مجردة لمكوِّن يمكنه حذف كتلة أو فقاعة تم إسقاطها فوقه. |
DragTarget | فئة مجردة لمكوِّن لديه سلوك مخصّص عند سحب كتلة أو فقاعة أو إسقاطها فوقهما. |
FieldAngle | فئة لحقل زاوية قابل للتعديل. |
FieldCheckbox | صف لحقل مربع اختيار. |
FieldColour | فئة لحقل إدخال اللون. |
FieldDropdown | صف لحقل قائمة منسدلة قابلة للتعديل. |
FieldImage | صف لصورة في مربّع. |
FieldLabel | فئة لحقل نصي غير قابل للتعديل وغير متسلسل. |
FieldLabelSerializable | فئة لحقل نصي غير قابل للتعديل والمتسلسل. |
FieldMultilineInput | فئة لحقل نص مربّع قابل للتعديل. |
FieldNumber | فئة لحقل رقم قابل للتعديل. |
FieldTextInput | فئة لحقل نصي قابل للتعديل. |
FieldVariable | فئة حقل القائمة المنسدلة لمتغير. |
FlyoutButton | فئة لزرّ أو تسمية في القائمة المنبثقة. |
FlyoutMetricsManager | تحسب المقاييس الخاصة بمساحة عمل القائمة المنبثقة. تُستخدم المقاييس بشكل أساسي لتغيير حجم أشرطة التمرير في القائمة المنبثقة. |
الإيماءة | صف لإيماءة واحدة |
شبكة | صف لشبكة مساحة عمل. |
HorizontalFlyout | فئة لفتح قائمة منبثقة. |
الإدخال | فئة لمدخل يتضمن حقول اختيارية. |
InsertionMarkerManager | فئة تتحكَّم في تحديثات الاتصالات أثناء عمليات السحب. إنّها مسؤول بشكل أساسي عن العثور على أقرب اتصال مؤهل وإبرازه أو إلغاء تمييزه حسب الحاجة أثناء السحب. |
InsertionMarkerPreviewer | |
محدِّد الموقع | صف لعلامة. يُستخدَم هذا الحقل أثناء التنقّل باستخدام لوحة المفاتيح لحفظ موقع جغرافي في سياسة Looker-Fi. |
MarkerManager | صف لإدارة العلامات المتعددة والمؤشر على مساحة عمل. |
القائمة | فئة قائمة طعام أساسية. |
MenuItem | فئة تمثل عنصرًا في قائمة. |
MetricsManager | المدير لجميع العمليات الحسابية لمقاييس مساحة العمل. |
أسماء الحسابات | فئة قاعدة بيانات أسماء الكيانات (المتغيرات والإجراءات وما إلى ذلك). |
الخيارات | تحليل الخيارات التي يحدِّدها المستخدم باستخدام إعدادات تلقائية معقولة حيث لا يتم تحديد السلوك. |
RenderedConnection | فئة للاتصال بين القطع التي يمكن عرضها على الشاشة. |
شريط التمرير | فئة شريط التمرير SVG الخالص يوفّر هذا الأسلوب شريط تمرير يمكن ضمان عمله، ولكنه قد لا يبدو أو يعمل مثل أشرطة التمرير في النظام. |
ScrollbarPair | فئة لشريطي تمرير. أفقي وعمودي. |
ShortcutRegistry | صف لتسجيل اختصارات لوحة المفاتيح. ومن المفترض أن تكون هذه الجملة مفردة. يجب ألا تنشئ مثيلاً جديدًا، وأن تصل فقط إلى هذه الفئة من ShortcutRegistry.registry. |
TabNavigateCursor | مؤشر للتنقّل بين الحقول التي يمكن التنقّل فيها باستخدام علامات التبويب |
الموضوع | صف حول موضوع ما |
ThemeManager | صف لتخزين مكوّنات واجهة المستخدم ومظاهر مساحة العمل وتعديلها |
مجموعة الأدوات | فئة مجموعة الأدوات. تُنشئ نموذج العناصر في المستند (DOM) لصندوق الأدوات. |
ToolboxCategory | فئة لفئة في مربّع أدوات. |
ToolboxItem | فئة عنصر في مربع الأدوات. |
ToolboxSeparator | فئة فاصل صندوق الأدوات. هذا هو الخط المرئي الدقيق الذي يظهر على مربع الأدوات. هذا العنصر غير قابل للتفاعل. |
المهملات | صف لسلة المهملات. |
UnattachedFieldError | يمثل هذا الخيار خطأ يحاول فيه الحقل الوصول إلى مجموعته أو معلومات حول القطعة قبل إرفاقها فعليًا بالكتلة المذكورة. |
VariableMap | فئة لخريطة متغيرة. يحتوي هذا على هيكل بيانات معجم بأنواع متغيرات كمفاتيح وقوائم المتغيرات كقيم. قائمة المتغيرات هي النوع الذي يشير إليه المفتاح. |
VariableModel | فئة نموذج متغيّر. يحتفظ بمعلومات عن المتغيّر، بما في ذلك الاسم والمعرّف والنوع. |
VerticalFlyout | فئة لفتح قائمة منبثقة. |
مساحة العمل | صف لإنشاء مساحة عمل هذا هيكل بيانات يحتوي على كتل. لا توجد واجهة مستخدم ويمكن إنشاؤها بلا واجهة مستخدم رسومية. |
WorkspaceAudio | صف لتحميل المحتوى الصوتي وتخزينه وتشغيله في مساحة عمل |
WorkspaceComment | صف لتعليق على مساحة العمل |
WorkspaceCommentSvg | صف لتمثيل تمثيل SVG لتعليق على مساحة العمل |
WorkspaceDragger | صف حول السحب في Workspace. كما أنه حرك مساحة العمل عند سحبها بالماوس أو اللمس. |
WorkspaceSvg | صف لإنشاء مساحة عمل هذه منطقة على الشاشة بها سلة قمامة اختيارية وأشرطة تمرير وفقاعات التفسيرية وميزة السحب. |
ZoomControls | فئة لعناصر التحكم في التكبير/التصغير. |
صفوف تجريدية
فئة تجريدية | الوصف |
---|---|
فقاعة محادثة | فئة الفقاعة المنبثقة المنبثقة. يؤدي ذلك إلى إنشاء واجهة مستخدم تشبه فقاعة تفسيرية كلامية، حيث يحتوي على "ذيل" يشير إلى القطعة، و "رأس" يعرض عناصر svg عشوائية. |
الحقل | فئة تجريدية لحقل قابل للتعديل. |
القائمة المنبثقة | فئة لفتح قائمة منبثقة. |
التعدادات
التعداد | الوصف |
---|---|
ConnectionType | تعداد نوع الاتصال أو الإدخال. |
inputTypes | تعداد نوع الاتصال أو الإدخال. |
الدوال
الوظيفة | الوصف |
---|---|
hasBubble(obj) | اكتب guard للتحقق مما إذا كان الكائن المحدّد عبارة عن IHasBubble. |
hideChaff(opt_onlyClosePopups) | إغلاق التلميحات وقوائم السياق والاختيارات المنسدلة وما إلى ذلك |
inject(container, opt_options) | أدخل محرر Bookly في عنصر الحاوية المحدد (عادةً ما يكون div). |
isCopyable(obj) | |
isIcon(obj) | اكتب حماية للتحقّق مما إذا كان العنصر المحدّد عبارة عن رمز IIcon. |
isPaster(obj) | |
isSerializable(obj) | اكتب حماية تتحقق مما إذا كان العنصر المحدد قابلاً للتسلسل. |
isVariableBackedParameterModel(param) | لعرض ما إذا كان الكائن المحدد هو حامل متغيّر أم لا. |
واجهات
الواجهة | الوصف |
---|---|
BlocklyOptions | خيارات سياسة الحظر |
FieldAngleConfig | خيارات ضبط إضافية لحقل الزاوية. |
FieldAngleFromJsonConfig | خيارات تكوين fromJson لحقل الزاوية. |
FieldCheckboxConfig | خيارات الضبط لحقل مربّع الاختيار. |
FieldCheckboxFromJsonConfig | خيارات تهيئة fromJson لحقل مربع الاختيار. |
FieldColourConfig | خيارات ضبط حقل اللون |
FieldColourFromJsonConfig | خيارات تهيئة fromJson لحقل اللون. |
FieldConfig | خيارات ضبط إضافية للحقل الأساسي |
FieldDropdownFromJsonConfig | fromJson config لحقل القائمة المنسدلة. |
FieldImageConfig | خيارات الضبط لحقل الصورة. |
FieldImageFromJsonConfig | خيارات تهيئة fromJson لحقل اللون. |
FieldLabelConfig | خيارات الضبط لحقل التصنيف. |
FieldLabelFromJsonConfig | خيارات تهيئة fromJson لحقل التصنيف. |
FieldMultilineInputConfig | خيارات الضبط لحقل الإدخال المتعدد الأسطر. |
FieldMultilineInputFromJsonConfig | خيارات تهيئة fromJson لحقل الإدخال متعدد السطور. |
FieldNumberConfig | خيارات ضبط حقل الأرقام |
FieldNumberFromJsonConfig | خيارات تهيئة fromJson لحقل الأرقام. |
FieldTextInputFromJsonConfig | خيارات تهيئة fromJson لحقل إدخال النص. |
FieldVariableConfig | خيارات الضبط لحقل المتغيّر |
FieldVariableFromJsonConfig | خيارات تكوين fromJson للحقل المتغير. |
IASTNodeLocation | واجهة موقع عقدة AST. |
IASTNodeLocationSvg | واجهة SVG لموقع عقدة AST |
IASTNodeLocationWithBlock | يشير ذلك المصطلح إلى موقع عقدة AST مرتبط بكتلة. |
IAutoHideable | واجهة لمكوِّن يمكن إخفاؤه تلقائيًا. |
IBlockDragger | واجهة سحب كتل |
IBoundedElement | واجهة عنصر محدود |
IBubble | واجهة فقاعة. |
ICollapsibleToolboxItem | واجهة لعنصر في مربّع الأدوات يمكن تصغيره |
IComponent | واجهة مكون في مساحة العمل التي يمكن تسجيلها في ComponentManager. |
IConnectionChecker | فئة للتحقق المنطقي من نوع الاتصال |
IConnectionPreviewer | تعرِض "معاينات" مرئية للمكان الذي سيتم ربط الجزء فيه في حال إسقاطه. |
IContextMenu | |
ICopyable | |
IDeletable | الواجهة لعنصر يمكن حذفه. |
IDeleteArea | واجهة لمكوِّن يمكنه حذف كتلة أو فقاعة يتم إسقاطها فوقها. |
IDraggable | الواجهة لكائن يمكن سحبه. |
IDragTarget | واجهة لمكوِّن لديه سلوك مخصّص عند سحب كتلة أو فقاعة أو إسقاطها فوقها |
IFlyout | واجهة لقائمة منبثقة. |
IHasBubble | |
IIcon | |
IKeyboardAccessible | يشير ذلك المصطلح إلى واجهة لكائن يعالج اختصارات لوحة المفاتيح. |
IMetricsManager | واجهة لمدير المقاييس |
IMovable | واجهة لكائن يمكن نقله. |
IPaster | يشير ذلك المصطلح إلى كائن يمكنه لصق البيانات في مساحة عمل. |
IPositionable | واجهة لمكوِّن يتم وضعه أعلى مساحة العمل. |
IRegistrable | واجهة مكوِّن بشكل حظر يمكن تسجيله |
ISelectable | الواجهة لكائن يمكن اختياره. |
ISelectableToolboxItem | واجهة لعنصر في مربّع الأدوات يمكن اختيارها |
ISerializable | |
IStyleable | واجهة لكائن يمكن إضافة نمط إليه. |
IToolbox | واجهة لصندوق الأدوات. |
IToolboxItem | واجهة لعنصر في صندوق الأدوات |
IVariableBackedParameterModel | واجهة لنموذج مَعلمات يحتوي على نموذج متغيّر |
مساحات الاسم
المتغيرات
متغير | الوصف |
---|---|
ALIGN_CENTRE | |
ALIGN_LEFT | |
ALIGN_RIGHT | |
عمليات الحظر | تعيين أسماء أنواع الكتل لحظر كائنات النماذج الأوّلية. |
COLLAPSE_CHARS | |
COLLAPSED_FIELD_NAME | |
COLLAPSED_INPUT_NAME | |
الضبط | عنصر يتضمن جميع القيم على Blockly والتي نتوقّع أن يتمكّن المطوّرون من تغييرها. |
connectionTypes | |
defineBlocksWithJsonArray | يمكنك تحديد الوحدات من مصفوفة من تعريفات مجموعات JSON، كما قد يتم إنشاؤها بواسطة أدوات مطوّري برامج Openly. |
DELETE_VARIABLE_ID | |
DRAG_STACK | |
DropDownDiv | |
DUMMY_INPUT | |
getMainWorkspace | تعرض مساحة العمل الرئيسية. تعرض آخر مساحة عمل رئيسية تم استخدامها (بناءً على التركيز). حاوِل عدم استخدام هذه الدالة، لا سيّما إذا كانت هناك عدة مثيلات لحظر المحتوى على إحدى الصفحات. |
getSelected | لعرض العنصر القابل للنسخ المحدّد حاليًا. |
INPUT_VALUE | |
JavaScript | |
الرسالة | قاموس للرسائل المترجَمة. |
NEXT_STATEMENT | |
OPPOSITE_TYPE | |
OUTPUT_VALUE | |
PREVIOUS_STATEMENT | |
PROCEDURE_CATEGORY_NAME | سلسلة للاستخدام في السمة "custom" لفئة معيّنة في ملف XML الخاص بمربع الأدوات. تشير هذه السلسلة إلى أنه يجب تعبئة الفئة ديناميكيًا بكتل الإجراءات. |
RENAME_VARIABLE_ID | |
setLocale | لضبط اللغة (أي الرسائل المترجَمة/block-text أو غيرها) على اللغة المحدّدة. هذا الإجراء ليس مفيدًا أو ضروريًا عند التحميل من علامة نص برمجي، لأن الرسائل يتم توصيلها تلقائيًا بالكائن Blockly.Msg. لكننا نقدّمها في سياقَي علامة النص البرمجي وسياق النص الذي لا يحمل علامة نصيّة، وذلك لكي يتمكّن برنامج التجميع العنقودي من إنشاء ملفات تعريف النوع بشكل صحيح. |
setParentContainer | اضبط الحاوية الرئيسية. هذا هو عنصر الحاوية الذي يتم عرض عناصره WidgetDiv وdropDownDiv وتلميح الأداة عند استدعاء Blockly.inject للمرة الأولى. تكون هذه الطريقة عبارة عن رقم NOP إذا تم استدعاؤه بعد أوّل Blockly.inject . |
svgResize | اضبط حجم صورة الرسومات الموجّهة التي يمكن تغيير حجمها (SVG) لملء حاويتها بالكامل. عليك استدعاء هذه الدالة عندما يتم تغيير أحجام العرض فعليًا (على سبيل المثال، عند تغيير حجم النافذة/تغيير اتجاه الجهاز). يمكنك الانتقال إلى workspace.resizeContents لتغيير حجم مساحة العمل عند تغيير محتواها (على سبيل المثال، عند إضافة كتلة أو إزالتها). سجِّل ارتفاع/عرض صورة SVG. |
TOOLBOX_AT_BOTTOM | |
TOOLBOX_AT_LEFT | |
TOOLBOX_AT_RIGHT | |
TOOLBOX_AT_TOP | |
VARIABLE_CATEGORY_NAME | سلسلة للاستخدام في السمة "custom" لفئة معيّنة في ملف XML الخاص بمربع الأدوات. تشير هذه السلسلة إلى أنه يجب تعبئة الفئة ديناميكيًا بكتل متغيرة. |
VARIABLE_DYNAMIC_CATEGORY_NAME | سلسلة للاستخدام في السمة "custom" لفئة معيّنة في ملف XML الخاص بمربع الأدوات. تشير هذه السلسلة إلى أنه يجب تعبئة الفئة ديناميكيًا بكتل متغيرة. |
النسخة | إصدار أساسي محظور يتجاهل النص البرمجي للإصدار (npm run version) هذا الثابت إلى قيمة الإصدار في package.json. يتم ذلك بواسطة Closure Compiler في مهام المضمنة gulp (البلاع المضغوط). بالنسبة إلى الإصدارات المحلية، يمكنك تمرير --define='Blockly.VERSION=X.Y.Z' إلى المحول البرمجي لتجاوز هذا الثابت. |
الأسماء المستعارة للنوع
النوع البديل | الوصف |
---|---|
FieldAngleValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldCheckboxValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldColourValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldDropdownConfig | خيارات الضبط لحقل القائمة المنسدلة. |
FieldDropdownValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldMultilineInputValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldNumberValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldTextInputConfig | خيارات الضبط لحقل إدخال النص |
FieldTextInputValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
FieldVariableValidator | يشير ذلك المصطلح إلى دالة تستدعي التحقّق من صحة التغييرات التي تم إجراؤها على قيمة الحقل قبل تحديدها. |
MenuGenerator | تكون هذه القيمة إما مصفوفة من خيارات القائمة أو دالة تنشئ مصفوفة من خيارات القائمة لتطبيق Fielddropdown أو عناصرها الفرعية. |
MenuGeneratorFunction | دالة تُنشئ مصفوفة من خيارات القائمة في FieldDropdown أو عناصرها الفرعية. |
MenuOption | خيار فردي في القائمة المنسدلة العنصر الأول هو القيمة التي يمكن للإنسان قراءتها (نص أو صورة)، والعنصر الثاني هو القيمة المحايدة اللغة. |