blockly

gói blockly

Lớp

Lớp Mô tả
Chặn Lớp học cho một khối. Không thường xuyên được gọi trực tiếp, nên dùng workspace.newBlock().
BlockFlyoutInflater Lớp chịu trách nhiệm tạo các khối cho bảng chọn.
BlockNavigationPolicy Tập hợp các quy tắc kiểm soát thao tác điều hướng bằng bàn phím từ một khối.
BlockSvg Lớp cho biểu thị SVG của một khối. Không thường xuyên được gọi trực tiếp, nên dùng workspace.newBlock().
ButtonFlyoutInflater Lớp chịu trách nhiệm tạo các nút cho bảng chọn.
CodeGenerator Lớp cho một trình tạo mã dịch các khối thành một ngôn ngữ.
CollapsibleToolboxCategory Lớp cho một danh mục trong hộp công cụ có thể thu gọn.
ComponentManager Trình quản lý cho tất cả các mục đã đăng ký với không gian làm việc.
Kết nối Lớp cho mối kết nối giữa các khối.
ConnectionChecker Lớp cho logic kiểm tra loại kết nối.
ConnectionDB Cơ sở dữ liệu về các mối quan hệ. Các kết nối được lưu trữ theo thứ tự thành phần dọc. Bằng cách này, bạn có thể nhanh chóng tra cứu các kết nối trong một khu vực bằng cách sử dụng tìm kiếm nhị phân.
ConnectionNavigationPolicy Tập hợp các quy tắc kiểm soát thao tác điều hướng bằng bàn phím từ một kết nối.
ContextMenuRegistry Lớp cho sổ đăng ký các mục trong trình đơn ngữ cảnh. Đây là một singleton. Bạn không nên tạo một thực thể mới và chỉ truy cập vào lớp này từ ContextMenuRegistry.registry.
DeleteArea Lớp trừu tượng cho một thành phần có thể xoá một khối hoặc bong bóng được thả lên trên thành phần đó.
DragTarget Lớp trừu tượng cho một thành phần có hành vi tuỳ chỉnh khi một khối hoặc bong bóng được kéo qua hoặc thả lên trên thành phần đó.
FieldCheckbox Lớp cho trường hộp đánh dấu.
FieldDropdown Lớp cho trường thả xuống có thể chỉnh sửa.
FieldImage Lớp cho hình ảnh trên một khối.
FieldLabel Lớp cho trường văn bản không thể chỉnh sửa, không thể chuyển đổi tuần tự.
FieldLabelSerializable Lớp cho trường văn bản không thể chỉnh sửa, có thể chuyển đổi tuần tự.
FieldNavigationPolicy Tập hợp các quy tắc kiểm soát thao tác điều hướng bằng bàn phím từ một trường.
FieldNumber Lớp cho trường số có thể chỉnh sửa.
FieldTextInput Lớp cho một trường văn bản có thể chỉnh sửa.
FieldVariable Lớp cho trường thả xuống của một biến.
FlyoutButton Lớp cho nút hoặc nhãn trong bảng chọn.
FlyoutButtonNavigationPolicy Tập hợp các quy tắc kiểm soát thao tác điều hướng bằng bàn phím từ một nút bật lên.
FlyoutItem Biểu thị một mục xuất hiện trong một trình đơn bật lên.
FlyoutMetricsManager Tính toán các chỉ số cho không gian làm việc của bảng điều khiển dạng thu gọn. Các chỉ số này chủ yếu được dùng để định cỡ thanh cuộn cho bảng chọn.
FlyoutNavigationPolicy Chính sách điều hướng chung để di chuyển giữa các mục trong bảng chọn.
FlyoutNavigator
FlyoutSeparator Biểu thị khoảng trống giữa các phần tử trong một bảng chọn.
FlyoutSeparatorNavigationPolicy Tập hợp các quy tắc kiểm soát thao tác điều hướng bằng bàn phím từ dấu phân cách của trình đơn bật lên. Đây là phần giữ chỗ không có thao tác, vì bạn không thể chuyển đến các dấu phân cách của trình đơn bật lên.
FocusableTreeTraverser Một tiện ích trợ giúp cho các hoạt động triển khai IFocusableTree để hỗ trợ việc duyệt qua cây phổ biến.
FocusManager

Một singleton trên mỗi trang quản lý tiêu điểm Blockly trên một hoặc nhiều IFocusableTree và đồng bộ hoá tiêu điểm này với DOM theo cả hai hướng.

Những người gọi muốn thay đổi tiêu điểm đầu vào một cách rõ ràng cho các thành phần Blockly đã chọn trên trang nên sử dụng các hàm tiêu điểm trong trình quản lý này.

Trình quản lý chịu trách nhiệm xử lý các sự kiện lấy tiêu điểm từ DOM (có thể phát sinh khi người dùng nhấp vào các phần tử trên trang) và đảm bảo rằng các IFocusableNode tương ứng được đánh dấu rõ ràng là được làm nổi bật chủ động/thụ động theo cách mà điều này sẽ được biểu thị bằng các lệnh gọi đến focusNode().

Cử chỉ Lớp cho một cử chỉ.
Lưới Lớp cho lưới của không gian làm việc.
HorizontalFlyout Lớp cho một trình đơn bật lên.
Input Lớp cho một đầu vào có các trường không bắt buộc.
InsertionMarkerPreviewer
KeyboardNavigationController KeyboardNavigationController xử lý việc điều phối hành vi điều hướng bằng bàn phím trên toàn bộ Blockly, chẳng hạn như bật/tắt chế độ trực quan hoá con trỏ đầy đủ.
LabelFlyoutInflater Lớp chịu trách nhiệm tạo nhãn cho bảng chọn.
LineCursor Lớp cho con trỏ dòng.
Điểm đánh dấu Lớp cho một điểm đánh dấu. Thao tác này được dùng trong chế độ điều hướng bằng bàn phím để lưu một vị trí trong AST Blockly.
MarkerManager Lớp để quản lý nhiều điểm đánh dấu và con trỏ trên một không gian làm việc.
Thực đơn Một lớp trình đơn cơ bản.
MenuItem Lớp đại diện cho một mục trong trình đơn.
MetricsManager Người quản lý cho tất cả các phép tính chỉ số về không gian làm việc.
Tên Lớp cho cơ sở dữ liệu tên thực thể (biến, quy trình, v.v.).
Navigator Lớp chịu trách nhiệm xác định vị trí mà tiêu điểm sẽ di chuyển để phản hồi các lệnh điều hướng bằng bàn phím.
Lựa chọn Phân tích cú pháp các lựa chọn do người dùng chỉ định, sử dụng các giá trị mặc định hợp lý khi hành vi không được chỉ định.
RenderedConnection Lớp cho mối kết nối giữa các khối có thể được hiển thị trên màn hình.
Thanh cuộn Lớp cho một thanh cuộn SVG thuần tuý. Kỹ thuật này cung cấp một thanh cuộn đảm bảo hoạt động, nhưng có thể không giống với thanh cuộn của hệ thống về hình thức hoặc hành vi.
ScrollbarPair Lớp cho một cặp thanh cuộn. Ngang và dọc.
SeparatorFlyoutInflater Lớp chịu trách nhiệm tạo dấu phân cách cho bảng chọn.
ShortcutRegistry Lớp cho sổ đăng ký phím tắt. Đây là một singleton. Bạn không nên tạo một thực thể mới và chỉ truy cập vào lớp này từ ShortcutRegistry.registry.
Giao diện Lớp cho một giao diện.
ThemeManager Lớp để lưu trữ và cập nhật giao diện cũng như các thành phần giao diện người dùng của một không gian làm việc.
Thông báo nhanh Lớp cho phép hiển thị và đóng thông báo tạm thời.
Hộp công cụ Lớp cho Hộp công cụ. Tạo DOM của hộp công cụ.
ToolboxCategory Lớp cho một danh mục trong hộp công cụ.
ToolboxItem Lớp cho một mục trong hộp công cụ.
ToolboxSeparator Lớp cho dấu phân cách hộp công cụ. Đây là đường viền mỏng xuất hiện trên hộp công cụ. Mục này không tương tác được.
Trashcan Lớp cho thùng rác.
UnattachedFieldError Biểu thị một lỗi khi trường đang cố gắng truy cập vào khối hoặc thông tin về khối của trường trước khi trường thực sự được đính kèm vào khối đó.
VariableMap Lớp cho bản đồ biến. Thao tác này chứa một cấu trúc dữ liệu từ điển với các loại biến làm khoá và danh sách biến làm giá trị. Danh sách các biến là loại được chỉ định theo khoá.
VariableModel Lớp cho một mô hình biến. Lưu giữ thông tin cho biến, bao gồm tên, mã nhận dạng và loại.
VerticalFlyout Lớp cho một trình đơn bật lên.
Workspace Lớp học cho một không gian làm việc. Đây là một cấu trúc dữ liệu chứa các khối. Không có giao diện người dùng và có thể được tạo mà không cần giao diện.
WorkspaceAudio Lớp để tải, lưu trữ và phát âm thanh cho một không gian làm việc.
WorkspaceDragger Lớp cho một đối tượng kéo không gian làm việc. Thao tác này sẽ di chuyển không gian làm việc khi bạn kéo bằng chuột hoặc thao tác chạm.
WorkspaceNavigationPolicy Tập hợp các quy tắc kiểm soát thao tác điều hướng bằng bàn phím trong một không gian làm việc.
WorkspaceSvg Lớp học cho một không gian làm việc. Đây là một vùng trên màn hình có thùng rác, thanh cuộn, bong bóng và thao tác kéo (không bắt buộc).
ZoomControls Lớp cho các chế độ điều khiển thu phóng.

Lớp trừu tượng

Lớp trừu tượng Mô tả
Trường Lớp trừu tượng cho một trường có thể chỉnh sửa.
Flyout Lớp cho một trình đơn bật lên.

Bảng liệt kê

Liệt kê Mô tả
ConnectionType Liệt kê cho loại kết nối hoặc đầu vào.

Hàm

Chức năng Mô tả
getFocusManager() Hàm tiện lợi cho FocusManager.getFocusManager.
hasBubble(obj) Loại bảo vệ kiểm tra xem đối tượng đã cho có phải là IHasBubble hay không.
hideChaff(opt_onlyClosePopups) Đóng chú thích, trình đơn theo bối cảnh, lựa chọn trong trình đơn thả xuống, v.v.
inject(container, opt_options) Chèn một trình chỉnh sửa Blockly vào phần tử vùng chứa đã chỉ định (thường là một div).
isCopyable(obj)
isDeletable(obj) Trả về xem đối tượng đã cho có phải là IDeletable hay không.
isDraggable(obj) Trả về kết quả cho biết đối tượng đã cho có phải là IDraggable hay không.
isIcon(obj) Loại bảo vệ kiểm tra xem đối tượng đã cho có phải là IIcon hay không.
isPaster(obj)
isRenderedElement(obj)
isSelectable(obj) Kiểm tra xem đối tượng đã cho có phải là ISelectable hay không.
isSerializable(obj) Loại bảo vệ kiểm tra xem đối tượng đã cho có phải là ISerializable hay không.
isVariableBackedParameterModel(param) Trả về cho dù đối tượng đã cho có phải là một phần tử giữ biến hay không.
navigateBlock(current, delta) Trả về mục có thể điều hướng tiếp theo so với khối con được cung cấp.
navigateStacks(current, delta) Trả về ngăn xếp tiếp theo/trước đó so với ngăn xếp của phần tử đã cho.
setLocale(locale)

Đặt ngôn ngữ (tức là thông báo/văn bản chặn/v.v. đã được bản địa hoá) thành ngôn ngữ đã cho.

Điều này không hữu ích/cần thiết khi tải từ thẻ tập lệnh, vì các thông báo sẽ tự động được đưa vào đối tượng Blockly.Msg. Nhưng chúng tôi cung cấp nó trong cả ngữ cảnh thẻ tập lệnh và ngữ cảnh không phải thẻ tập lệnh để tscompiler có thể tạo đúng các tệp định nghĩa kiểu của chúng tôi.

Giao diện

Giao diện Mô tả
BlocklyOptions Các lựa chọn của Blockly.
FieldCheckboxConfig Các lựa chọn cấu hình cho trường hộp đánh dấu.
FieldCheckboxFromJsonConfig Các lựa chọn cấu hình fromJson cho trường hộp đánh dấu.
FieldConfig Các lựa chọn cấu hình bổ sung cho trường cơ sở.
FieldDropdownFromJsonConfig Cấu hình fromJson cho trường thả xuống.
FieldImageConfig Các lựa chọn cấu hình cho trường hình ảnh.
FieldImageFromJsonConfig Các lựa chọn cấu hình fromJson cho trường hình ảnh.
FieldLabelConfig Các lựa chọn cấu hình cho trường nhãn.
FieldLabelFromJsonConfig Các lựa chọn cấu hình fromJson cho trường nhãn.
FieldNumberConfig Các lựa chọn cấu hình cho trường số.
FieldNumberFromJsonConfig Các tuỳ chọn cấu hình fromJson cho trường số.
FieldTextInputFromJsonConfig Các lựa chọn cấu hình fromJson cho trường nhập văn bản.
FieldVariableConfig Các lựa chọn cấu hình cho trường biến.
FieldVariableFromJsonConfig Các lựa chọn cấu hình fromJson cho trường biến.
IAutoHideable Giao diện cho một thành phần có thể tự động ẩn.
IBoundedElement Một giao diện phần tử bị ràng buộc.
IBubble Giao diện bong bóng.
ICollapsibleToolboxItem Giao diện cho một mục trong hộp công cụ có thể thu gọn.
IComponent Giao diện cho một thành phần không gian làm việc có thể được đăng ký bằng ComponentManager.
IConnectionChecker Lớp cho logic kiểm tra loại kết nối.
IConnectionPreviewer Hiển thị "bản xem trước" trực quan về vị trí kết nối của một khối nếu khối đó được thả.
IContextMenu
ICopyable
IDeletable Giao diện cho một đối tượng có thể bị xoá.
IDeleteArea Giao diện cho một thành phần có thể xoá một khối hoặc bong bóng được thả lên trên thành phần đó.
IDraggable Biểu thị một đối tượng có thể được kéo.
IDragger
IDragStrategy
IDragTarget Giao diện cho một thành phần có hành vi tuỳ chỉnh khi một khối hoặc bong bóng được kéo qua hoặc thả lên trên thành phần đó.
IFlyout Giao diện cho một bảng chọn.
IFlyoutInflater
IFocusableNode Biểu thị mọi thứ có thể có tiêu điểm đầu vào.
IFocusableTree

Biểu thị một cây gồm các phần tử có thể lấy tiêu điểm với ngữ cảnh tiêu điểm đang hoạt động/thụ động riêng.

Xin lưu ý rằng tiêu điểm được FocusManager xử lý và các hoạt động triển khai cây có thể có tối đa một IFocusableNode được lấy tiêu điểm tại một thời điểm. Nếu chính cây có tiêu điểm, thì nút được lấy tiêu điểm của cây sẽ được coi là "đang hoạt động" ("thụ động" nếu một cây khác có tiêu điểm).

Tiêu điểm được chia sẻ giữa một hoặc nhiều cây, trong đó mỗi cây có thể có chính xác một nút đang hoạt động hoặc không hoạt động (và chỉ có thể có một nút đang hoạt động trên toàn bộ trang tại một thời điểm bất kỳ). Ý tưởng về tiêu điểm thụ động là cung cấp ngữ cảnh cho người dùng về vị trí tiêu điểm sẽ được khôi phục khi họ quay lại một cây đã được lấy làm tiêu điểm trước đó.

Xin lưu ý rằng nếu cần nút hiện tại được lấy tiêu điểm của cây (thụ động hoặc chủ động), bạn có thể dùng FocusableTreeTraverser.findFocusedNode.

Xin lưu ý rằng nếu cần truy xuất các nút cụ thể cho cây này, hãy sử dụng lookUpFocusableNode hoặc FocusableTreeTraverser.findFocusableNodeFor.

IHasBubble
IIcon
IKeyboardAccessible Một giao diện cho đối tượng xử lý phím tắt.
ImageProperties Định nghĩa về một lựa chọn trong trình đơn thả xuống hình ảnh mà con người có thể đọc được.
IMetricsManager Giao diện cho một trình quản lý chỉ số.
IMovable Giao diện cho một đối tượng có thể di chuyển.
INavigationPolicy Một bộ quy tắc chỉ định vị trí mà thao tác điều hướng bằng bàn phím sẽ diễn ra.
IPaster Một đối tượng có thể dán dữ liệu vào không gian làm việc.
IPositionable Giao diện cho một thành phần nằm ở trên cùng của không gian làm việc.
IRegistrable Giao diện cho một thành phần Blockly có thể được đăng ký.
IRenderedElement
ISelectable

Giao diện cho một đối tượng có thể chọn.

Thông thường, các hoạt động triển khai dự kiến sẽ sử dụng các hoạt động triển khai onNodeFocus() và onNodeBlur() để gọi setSelected() với chính chúng và giá trị rỗng, tương ứng, nhằm đảm bảo rằng các lựa chọn được cập nhật chính xác và sự kiện thay đổi lựa chọn được kích hoạt.

ISelectableToolboxItem Giao diện cho một mục có thể chọn trong hộp công cụ.
ISerializable
IStyleable Giao diện cho một đối tượng mà bạn có thể thêm kiểu vào.
IToolbox Giao diện cho hộp công cụ.
IToolboxItem Giao diện cho một mục trong hộp công cụ.
IVariableBackedParameterModel Giao diện cho một mô hình tham số chứa một mô hình biến.
IVariableMap

Bản đồ biến là các đối tượng vùng chứa chịu trách nhiệm lưu trữ và quản lý tập hợp các biến được tham chiếu trên một không gian làm việc.

Bất kỳ phương thức nào trong số này đều có thể xác định các bất biến về tên và loại hợp lệ, đồng thời gửi nếu không đáp ứng được.

IVariableModel
IVariableState Biểu thị trạng thái của một biến cụ thể.
ToastOptions Các lựa chọn hiển thị/cấu hình cho thông báo tạm thời.

Không gian tên

Không gian tên Mô tả
Chặn
blockAnimations
blockRendering
browserEvents
bong bóng
bumpObjects
clipboard
CollapsibleToolboxCategory
bình luận
common
ComponentManager
hằng số
ContextMenu
ContextMenuItems
ContextMenuRegistry
Css
dialog
dragging
Sự kiện
Tiện ích
fieldRegistry
geras
biểu tượng
ICopyable
inputs
layers
libraryBlocks
MetricsManager
Tên
Lựa chọn
Quy trình
registry
RenderedConnection
renderManagement
serialization
ShortcutItems
ShortcutRegistry
Giao diện
ThemeManager
Chủ đề
thrasos
Thông báo nhanh Các lựa chọn về mức độ đọc to thông báo của trình đọc màn hình. Các giá trị tương ứng với các giá trị cho aria-live.
ToolboxCategory
ToolboxSeparator
Chú giải công cụ
Thao tác nhấn
uiPosition
utils
Biến
VariablesDynamic
WidgetDiv
Xml
zelos

Biến

Biến Mô tả
Các quy tắc chặn Một mối liên kết giữa tên loại khối và đối tượng nguyên mẫu khối.
COLLAPSE_CHARS
COLLAPSED_FIELD_NAME
COLLAPSED_INPUT_NAME
config Đối tượng chứa tất cả các giá trị trên Blockly mà chúng tôi mong muốn nhà phát triển có thể thay đổi.
defineBlocksWithJsonArray Xác định các khối từ một mảng định nghĩa khối JSON, có thể do Công cụ cho nhà phát triển Blockly tạo.
DELETE_VARIABLE_ID
DropDownDiv
getMainWorkspace Trả về không gian làm việc chính. Trả về không gian làm việc chính được dùng gần đây nhất (dựa trên tiêu điểm). Cố gắng không sử dụng hàm này, đặc biệt nếu có nhiều phiên bản Blockly trên một trang.
getSelected Trả về đối tượng có thể sao chép hiện được chọn.
INPUT_VALUE
JavaScript
keyboardNavigationController Thực thể singleton của bộ điều khiển thao tác bằng bàn phím.
Msg Từ điển gồm các thông báo đã bản địa hoá.
NEXT_STATEMENT
OPPOSITE_TYPE
OUTPUT_VALUE
PREVIOUS_STATEMENT
PROCEDURE_CATEGORY_NAME Chuỗi để sử dụng trong thuộc tính "custom" của một danh mục trong XML hộp công cụ. Chuỗi này cho biết danh mục sẽ được tự động điền bằng các khối quy trình.
RENAME_VARIABLE_ID
setParentContainer Đặt vùng chứa mẹ. Đây là phần tử vùng chứa mà WidgetDiv, dropDownDiv và Chú thích được kết xuất vào lần đầu tiên Blockly.inject được gọi. Phương thức này là một NOP nếu được gọi sau Blockly.inject đầu tiên.
svgResize Điều chỉnh kích thước hình ảnh SVG sao cho lấp đầy hoàn toàn vùng chứa. Gọi phương thức này khi khung hiển thị thực sự thay đổi kích thước (ví dụ: khi thay đổi kích thước cửa sổ/hướng thiết bị). Xem workspace.resizeContents để đổi kích thước không gian làm việc khi nội dung thay đổi (ví dụ: khi một khối được thêm hoặc xoá). Ghi lại chiều cao/chiều rộng của hình ảnh SVG.
TOOLBOX_AT_BOTTOM
TOOLBOX_AT_LEFT
TOOLBOX_AT_RIGHT
TOOLBOX_AT_TOP
VARIABLE_CATEGORY_NAME Chuỗi để sử dụng trong thuộc tính "custom" của một danh mục trong XML hộp công cụ. Chuỗi này cho biết danh mục sẽ được điền động bằng các khối biến.
VARIABLE_DYNAMIC_CATEGORY_NAME Chuỗi để sử dụng trong thuộc tính "custom" của một danh mục trong XML hộp công cụ. Chuỗi này cho biết danh mục sẽ được điền động bằng các khối biến.
VERSION Phiên bản lõi Blockly. Hằng số này sẽ bị tập lệnh bản dựng (npm run build) ghi đè thành giá trị của phiên bản trong package.json. Việc này được thực hiện bằng Trình biên dịch đóng trong tác vụ gulp buildCompressed. Đối với các bản dựng cục bộ, bạn có thể truyền --define='Blockly.VERSION=X.Y.Z' đến trình biên dịch để ghi đè hằng số này.

Bí danh loại

Bí danh loại Mô tả
FieldCheckboxValidator Một hàm được gọi để xác thực các thay đổi đối với giá trị của trường trước khi các thay đổi đó được đặt.
FieldDropdownConfig Các lựa chọn cấu hình cho trường thả xuống.
FieldDropdownValidator Một hàm được gọi để xác thực các thay đổi đối với giá trị của trường trước khi các thay đổi đó được đặt.
FieldNumberValidator Một hàm được gọi để xác thực các thay đổi đối với giá trị của trường trước khi các thay đổi đó được đặt.
FieldTextInputConfig Các lựa chọn cấu hình cho trường nhập văn bản.
FieldTextInputValidator Một hàm được gọi để xác thực các thay đổi đối với giá trị của trường trước khi các thay đổi đó được đặt.
FieldValidator Một hàm được gọi để xác thực các thay đổi đối với giá trị của trường trước khi các thay đổi đó được đặt.
FieldVariableValidator Một hàm được gọi để xác thực các thay đổi đối với giá trị của trường trước khi các thay đổi đó được đặt.
ICopyData
MenuGenerator Một mảng các lựa chọn trong trình đơn hoặc một hàm tạo ra một mảng các lựa chọn trong trình đơn cho FieldDropdown hoặc các thành phần con của nó.
MenuGeneratorFunction Một hàm tạo ra một mảng các lựa chọn trong trình đơn cho FieldDropdown hoặc các thành phần con của nó.
MenuOption Một lựa chọn riêng lẻ trong trình đơn thả xuống. Có thể là chuỗi ký tự separator cho một mục phân cách trình đơn hoặc một mảng cho các mục trình đơn thao tác thông thường. Trong trường hợp thứ hai, phần tử đầu tiên là giá trị mà con người có thể đọc được (văn bản, đối tượng ImageProperties hoặc phần tử HTML) và phần tử thứ hai là giá trị không phụ thuộc vào ngôn ngữ.
ReturnEphemeralFocus

Khai báo kiểu để trả lại tiêu điểm cho FocusManager sau khi hoàn tất một luồng giao diện người dùng tạm thời (chẳng hạn như hộp thoại).

Hãy xem FocusManager.takeEphemeralFocus để biết thêm thông tin chi tiết.