Lớp 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().
Chữ ký:
export declare class BlockSvg extends Block implements IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode
Mở rộng: Khối
Triển khai: IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode
Hàm khởi tạo
Hàm dựng | Đối tượng sửa đổi | Mô tả |
---|---|---|
(constructor)(workspace, prototypeName, opt_id) | Tạo một thực thể mới của lớp BlockSvg |
Thuộc tính
Thuộc tính | Đối tượng sửa đổi | Loại | Mô tả |
---|---|---|---|
COLLAPSED_WARNING_ID |
|
(không khai báo) | Mã nhận cảnh báo "cảnh báo thu gọn". Cho phép chúng tôi xoá cảnh báo "cảnh báo bị thu gọn" mà không xoá bất kỳ cảnh báo nào thuộc khối. |
customContextMenu? | (p1: Array<ContextMenuOption | LegacyContextMenuOption>) => void | (Không bắt buộc) | |
phân tích? | (p1: Workspace) => BlockSvg | (Không bắt buộc) | |
height | số | Chiều cao của khối này, không bao gồm bất kỳ khối câu lệnh nào ở trên hoặc dưới. Chiều cao được tính bằng đơn vị không gian làm việc. | |
INLINE |
|
(không khai báo) | Hằng số để xác định những hàng sẽ được hiển thị nội tuyến. Đừng xung đột với Blockly.inputTypes. |
mutator | MutatorIcon | null | Biểu tượng đột biến của khối (nếu có). | |
nextConnection | RenderedConnection | ||
outputConnection | RenderedConnection | ||
previousConnection | RenderedConnection | ||
rendered | readonly |
(không khai báo) | Khối này có phải là BlockSVG không? |
saveConnections? | (rootBlock: BlockSvg) => void | (Không bắt buộc) Một phương thức không bắt buộc giúp lưu lại bản ghi các khối được kết nối với khối này để sau này có thể khôi phục sau khi khối này được kết hợp lại (được định cấu hình lại). Thường ghi lại các khối được kết nối trên các thuộc tính trên các khối trong trình sửa đổi thả nổi, để việc sắp xếp lại các khối thành phần đó sẽ tự động sắp xếp lại các khối được kết nối tương ứng trên khối này sau khi khối này được kết hợp lại. Để thông tin kết nối đã lưu luôn được cập nhật, MutatorIcon sắp xếp để một trình nghe sự kiện gọi phương thức này bất cứ khi nào trình sửa đổi bật lên và có thay đổi xảy ra trên không gian làm việc của khối này. |
|
style | BlockStyle | ||
width | số | Chiều rộng của khối này, bao gồm mọi khối giá trị được kết nối. Chiều rộng được tính bằng đơn vị không gian làm việc. | |
workspace | WorkspaceSvg |
Phương thức
Phương thức | Đối tượng sửa đổi | Mô tả |
---|---|---|
addClass(className) | Thêm một lớp CSS vào nhóm SVG của khối này. | |
addIcon(icon) | ||
addSelect() | Thêm hiệu ứng "chọn" trực quan vào khối, nhưng không thực sự chọn khối đó hoặc kích hoạt một sự kiện. | |
appendInput(input) | ||
bringToFront(blockOnly) | Di chuyển khối này lên đầu không gian làm việc có thể nhìn thấy. Thẻ |
|
bumpNeighbours() | Đẩy các khối không được kết nối ra khỏi vị trí. Hai khối không thực sự kết nối với nhau không được vô tình xếp thẳng hàng trên màn hình, vì điều đó sẽ khiến người dùng cuối bối rối. |
|
calculateContextMenuLocation(e) | protected |
Lấy vị trí để hiện trình đơn theo bối cảnh cho khối này. Sử dụng vị trí của một lượt nhấp nếu khối được nhấp, hoặc một vị trí dựa trên các trường của khối nếu không. |
canBeFocused() | Xem IFocusableNode.canBeFocused. | |
checkAndDelete() | Xoá một khối và ẩn nội dung không liên quan khi thực hiện thao tác này. Khối sẽ không bị xoá nếu nằm trong một trình đơn bật lên. Lệnh này được gọi từ trình đơn theo bối cảnh và phím tắt dưới dạng thao tác xoá hoàn toàn. Nếu bạn đang loại bỏ một khối khỏi không gian làm việc và không cần thực hiện các bước kiểm tra bảng điều khiển, xử lý việc nhóm sự kiện hoặc ẩn các khối không cần thiết, thì hãy sử dụng trực tiếp block.dispose() . |
|
dispose(healStack, animate) | Xoá khối này. | |
disposeInternal() | Huỷ khối này mà không thực hiện những việc mà khối trên cùng yêu cầu. Ví dụ: kích hoạt hiệu ứng giao diện người dùng, xoá các nút, v.v. | |
drag(newLoc, e) | Kéo khối đến vị trí đã cho. | |
endDrag(e) | Kết thúc thao tác kéo trên khối. | |
generateContextMenu(e) | protected |
Tạo trình đơn theo bối cảnh cho khối này. |
getBoundingRectangle() | Trả về toạ độ của một hộp giới hạn mô tả kích thước của khối này và mọi khối xếp chồng bên dưới. Hệ toạ độ: toạ độ không gian làm việc. | |
getBoundingRectangleWithoutChildren() | Trả về toạ độ của một khung hình chữ nhật mô tả kích thước của riêng khối này. Hệ toạ độ: toạ độ không gian làm việc. | |
getChildren(ordered) | Tìm tất cả các khối được lồng trực tiếp bên trong khối này. Bao gồm các giá trị và câu lệnh đầu vào, cũng như mọi câu lệnh tiếp theo. Không bao gồm mọi kết nối trên thẻ đầu ra hoặc mọi câu lệnh trước đó. Bạn có thể sắp xếp các khối theo vị trí (từ trên xuống dưới). | |
getColour() | Lấy màu của một khối. | |
getColourSecondary() | Lấy màu phụ của một khối. | |
getColourTertiary() | Lấy màu cấp ba của một khối. | |
getFocusableElement() | Xem IFocusableNode.getFocusableElement. | |
getFocusableTree() | Xem IFocusableNode.getFocusableTree. | |
getNextBlock() | Trả về khối câu lệnh tiếp theo được kết nối trực tiếp với khối này. | |
getPreviousBlock() | Trả về khối được kết nối với kết nối trước đó. | |
getRelativeToSurfaceXY() | Trả về toạ độ của góc trên cùng bên trái của khối này so với điểm gốc (0,0) của bề mặt vẽ, tính bằng đơn vị không gian làm việc. Nếu khối nằm trên không gian làm việc, thì (0, 0) là điểm gốc của hệ toạ độ không gian làm việc. Số lượng này không thay đổi theo quy mô của không gian làm việc. | |
getStyle() | Trả về đối tượng BlockStyle dùng để tạo kiểu cho khối này. | |
getSvgRoot() | Trả về nút gốc của SVG hoặc giá trị rỗng nếu không có nút nào. | |
initSvg() | Tạo và khởi chạy biểu thị SVG của khối. Có thể được gọi nhiều lần. | |
isCopyable() | Trả về liệu khối này có thể sao chép hay không. | |
isMovable() | Trả về liệu khối này có di chuyển được hay không. | |
jsonInit(json) | ||
markDirty() | Thông báo cho mọi dữ liệu đầu vào trên khối này để đánh dấu các trường của khối là chưa hoàn chỉnh. Trường bẩn là trường cần được kết xuất lại. | |
moveBy(dx, dy, reason) | Di chuyển một khối theo độ lệch tương đối. | |
moveNumberedInputBefore(inputIndex, refIndex) | Di chuyển một đầu vào được đánh số đến một vị trí khác trên khối này. | |
moveTo(xy, reason) | Di chuyển một khối đến một vị trí. | |
onNodeBlur() | Xem IFocusableNode.onNodeBlur. | |
onNodeFocus() | Xem IFocusableNode.onNodeFocus. | |
removeClass(className) | Xoá một lớp CSS khỏi nhóm SVG của khối này. | |
removeIcon(type) | ||
removeInput(name, opt_quiet) | Xoá một đầu vào khỏi khối này. | |
removeSelect() | Xoá hiệu ứng "chọn" trực quan khỏi khối, nhưng không thực sự bỏ chọn hoặc kích hoạt một sự kiện. | |
render() | Ngay lập tức bố trí và sắp xếp lại một khối dựa trên nội dung và chế độ cài đặt của khối đó. | |
revertDrag() | Di chuyển khối về vị trí ban đầu khi bắt đầu thao tác kéo. | |
scheduleSnapAndBump() | Chụp vào lưới, sau đó đẩy các khối lân cận ra xa ở cuối lần kết xuất tiếp theo. | |
select() | Chọn khối này. Làm nổi bật khối một cách trực quan. | |
setCollapsed(collapsed) | Đặt xem khối có bị thu gọn hay không. | |
setColour(colour) | Thay đổi màu của một khối. | |
setDeletable(deletable) | Thêm lớp blocklyNotDeletable khi khối không thể xoá hoặc xoá lớp khi khối có thể xoá | |
setDisabledReason(disabled, reason) | Thêm hoặc xoá lý do khiến khối có thể bị vô hiệu hoá. Nếu một khối có bất kỳ lý do nào khiến khối đó bị vô hiệu hoá, thì bản thân khối đó sẽ được coi là bị vô hiệu hoá. Một khối có thể bị vô hiệu hoá đồng thời vì nhiều lý do độc lập, chẳng hạn như khi người dùng tự vô hiệu hoá hoặc khối đó không hợp lệ. | |
setDragStrategy(dragStrategy) | Đặt chiến lược kéo cho khối này. | |
setEditable(editable) | Đặt xem khối này có thể chỉnh sửa hay không. | |
setHighlighted(highlighted) | Đặt xem khối có được đánh dấu hay không. Tính năng làm nổi bật khối thường được dùng để đánh dấu trực quan các khối đang được thực thi. | |
setInputsInline(newBoolean) | Đặt xem các giá trị đầu vào được sắp xếp theo chiều ngang hay chiều dọc. | |
setMovable(movable) | Đặt xem khối này có di chuyển được hay không. | |
setMutator(mutator) | Cung cấp cho khối này một hộp thoại đột biến. | |
setNextStatement(newBoolean, opt_check) | Đặt xem một khối khác có thể liên kết vào cuối khối này hay không. | |
setOutput(newBoolean, opt_check) | Đặt xem khối này có trả về giá trị hay không. | |
setPreviousStatement(newBoolean, opt_check) | Đặt xem khối này có thể liên kết với cuối một khối khác hay không. | |
setStyle(blockStyleName) | Đặt giá trị kiểu và màu của một khối. | |
setWarningText(text, id) | Đặt văn bản cảnh báo của khối này. | |
snapToGrid() | Di chuyển khối này đến điểm lưới gần nhất. | |
startDrag(e) | Bắt đầu kéo trên khối. | |
toCopyData() | Mã hoá một khối để sao chép. | |
toFlyoutInfo() | Trả về một biểu thị của khối này có thể xuất hiện trong một trình đơn bật lên. | |
translate(x, y) | Biến đổi một khối bằng cách đặt bản dịch trên thuộc tính biến đổi của SVG của khối. | |
unselect() | Bỏ chọn khối này. Huỷ làm nổi bật khối một cách trực quan. |