Blockly | Google for Developers

Bản khảo sát nghiên cứu: Cho chúng tôi biết trải nghiệm của bạn khi sử dụng Blockly

Trang này được dịch bởi Cloud Translation API.

Lớp BlockSvg

Lớp để biểu diễn SVG của một khối. Thường không được gọi trực tiếp, workspace.newBlock() sẽ được ưu tiên.

Chữ ký:

export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable<BlockCopyData>, IDraggable, IDeletable

Mở rộng: Chặn

Triển khai: IASTNodeLocationSvg, IBoundedElement, ICopyable<BlockCopyData>, IDraggable, IDeletable

Hàm khởi tạo

Hàm dựng	Đối tượng sửa đổi	Mô tả
(hàm khởi tạo)(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	`static` `readonly`	(chưa khai báo)	Mã nhận dạng cung cấp "cảnh báo đã thu gọn" . Cho phép chúng tôi xoá "cảnh báo đã thu gọn" mà không xoá bất kỳ cảnh báo nào thuộc về khối.
customContextMenu?		(p1: Array<ContextMenuOption \| LegacyContextMenuOption>) => trống	(Không bắt buộc)
phân huỷ?		(p1: Không gian làm việc) => BlockSvg	(Không bắt buộc)
height (chiều cao)		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 bên dưới. Chiều cao được tính theo đơn vị không gian làm việc.
INLINE	`static` `readonly`	(chưa khai báo)	Hằng số để xác định các hàng sẽ hiển thị nội tuyến. Không được xung đột với Blockly.inputTypes.
người biến đổi		MutatorIcon \| rỗng	Biểu tượng trình thay đổi của khối (nếu có).
nextConnection		RenderedConnection
outputConnection		RenderedConnection
previousConnection		RenderedConnection
được kết xuất	`readonly`	(chưa khai báo)	Liệu tệp này có chặn một BlockSVG không?
saveConnections?		(p1: BlockSvg) => trống	(Không bắt buộc)
kiểu		BlockStyle
chiều rộng		số	Chiều rộng của khối này, bao gồm cả mọi khối giá trị đã kết nối. Chiều rộng được tính bằng đơn vị không gian làm việc.
không gian làm việc		WorkspaceSvg

Phương thức

Phương thức	Đối tượng sửa đổi	Mô tả
addIcon(icon)
addSelect()		Thêm hình ảnh "chọn" đối với 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)
bumpNeighbours()		Đẩy các khối chưa được kết nối không thẳng hàng. Hai khối không thực sự kết nối với nhau không nên xuất hiện ngẫu nhiên trên màn hình vì điều này sẽ gây nhầm lẫn cho người dùng cuối.
checkAndDelete()		Xoá một khối và ẩn bớt nội dung khi thực hiện. Khối sẽ không bị xoá nếu ở chế độ bay. Thao tác 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 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 kiểm tra bay ra, xử lý nhóm sự kiện hoặc ẩn chaff, hãy sử dụng trực tiếp `block.dispose()`.
dispos(healStack, animate)		Vứt bỏ khối này.
disposeInternal()		Loại bỏ khối này mà không làm theo yêu cầu của khối trên cùng. Ví dụ: kích hoạt hiệu ứng giao diện người dùng, xoá nút, v.v.
kéo(newLoc; e)		Kéo khối tới vị trí đã cho.
endDrag(e)		Kết thúc việc kéo khối.
generateContextMenu()	`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 được xếp chồng bên dưới khối đó. 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 mục nhập giá trị và câu lệnh cũng như bất kỳ câu lệnh nào sau đây. 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 đó. Các quy tắc chặn được sắp xếp theo vị trí; trên cùng xuống dưới cùng.
getColour()		Lấy màu của một khối.
getColourSecondary()		Lấy màu cấp hai của khối.
getColourTertiary()		Lấy màu thứ ba của một khối.
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 đã 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 gốc của bề mặt vẽ (0,0), theo đơn vị không gian làm việc. Nếu khối nằm trên không gian làm việc, (0, 0) là điểm gốc của hệ toạ độ không gian làm việc. Điều này không thay đổi theo quy mô không gian làm việc.
getSvgRoot()		Trả về nút gốc của SVG hoặc nút rỗng nếu không có nút nào.
initSvg()		Tạo và khởi chạy bản trình bày SVG của khối. Có thể được gọi nhiều lần.
isMovable()		Trả về việc khối này có thể di chuyển được hay không.
markDirty()		Thông báo cho mọi đầu vào trên khối này để đánh dấu các trường của khối là bẩn. Trường bẩn là trường cần được kết xuất lại.
moveBy(dx; dy; lý do)		Di chuyển một khối theo độ lệch tương đối.
moveNumberedInputBefore(inputIndex, refIndex)		Di chuyển mục nhập được đánh số đến một vị trí khác trên khối này.
moveTo(xy; lý do)		Di chuyển một khối đến một vị trí.
removeIcon(type)
removeInput(name, opt_quiet)		Xoá một giá trị nhập khỏi khối này.
removeSelect()		Xoá thao tác "chọn" hình ảnh từ khối này nhưng không thực sự bỏ chọn nó hoặc kích hoạt một sự kiện.
render()		Ngay lập tức bố trí và chỉnh lại luồng dựa trên nội dung và chế độ cài đặt của khối đó.
revertDrag()		Di chuyển khối trở về vị trí khi bắt đầu kéo.
scheduleSnapAndBump()		Bám theo lưới rồi kéo các khối lân cận ra xa vào cuối lần hiển thị 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ó được thu gọn hay không.
setColour(colour)		Thay đổi màu của một khối.
setDisabledReason(disabled, reason)		Thêm hoặc xoá lý do có thể khiến chặn. Nếu một quy tắc chặn có bất kỳ lý do nào để bị vô hiệu hoá, thì chính quy tắc chặn đó sẽ được coi là bị vô hiệu hoá. Bạn có thể tắt một quy tắc chặn vì nhiều lý do độc lập cùng lúc, chẳng hạn như khi người dùng tắt tính năng đó theo cách thủ công hoặc quy tắc chặn không hợp lệ.
setDragStrategy(dragStrategy)		Đặt chiến lược kéo cho khối này.
setEditable(editable)		Đặt liệu khối này có thể chỉnh sửa được hay không.
setEnabled(enabled)
setHighlighted(highlighted)		Đặt xem khối có được đánh dấu hay không. Tính năng đánh dấu khối thường dùng để đánh dấu trực quan các khối hiện đang được thực thi.
setInputsInline(newBoolean)		Thiết lập để sắp xếp các giá trị đầu vào theo chiều ngang hay chiều dọc.
setMovable(movable)		Đặt liệu khối này có thể di chuyển được hay không.
setMutator(mutator)		Tạo hộp thoại biến đổi cho khối này.
setNextStatement(newBoolean, opt_check)		Đặt xem một khối khác có thể liên kết vào đáy của 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ào đáy của một khối khác hay không.
setStyle(blockStyleName)		Đặt giá trị kiểu và màu cho một khối.
setWarningText(text, id)		Đặt văn bản cảnh báo của khối này.
snapToGrid()		Gắn khối này vào điểm lưới gần nhất.
startDrag(e)		Bắt đầu một lượt kéo trên khối.
(bắt đầu, tiến)		Mở trường TextInput tiếp theo (hoặc trước đó).
toCopyData()		Mã hoá một khối để sao chép.
toFlyoutInfo()		Trả về một giá trị đại diện của khối này, khối có thể hiển thị trong một trình đơn thả xuống.
dịch(x; y)		Chuyển đổi một khối bằng cách đặt bản dịch cho thuộc tính biến đổi trong SVG của khối.
bỏ chọn()		Bỏ chọn khối này. Bỏ đánh dấu blockv một cách trực quan.
updateMarkers_()	`protected`	Vẽ lại mọi điểm đánh dấu hoặc svg con trỏ đính kèm nếu cần.