blockly > Chặn

Chặn lớp học

Lớp cho một khối. Thông thường, không được gọi trực tiếp, workspace.newBlock() sẽ được ưu tiên.

Chữ ký:

export declare class Block implements IASTNodeLocation, IDeletable 

Triển khai: IASTNodeLocation, IDeletable

Hàm khởi tạo

Hàm dựng	Đối tượng sửa đổi	Nội dung mô tả
(constructor)(không gian làm việc, prototypeName, opt_id)		Tạo một thực thể mới của lớp Block

Thuộc tính

Tài sản	Đối tượng sửa đổi	Loại	Nội dung mô tả
childBlocks_	protected	này[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	string	Mã trung tính được cấp cho trường thu gọn.
COLLAPSED_INPUT_NAME	static readonly	string	Mã trung tính về ngôn ngữ được cấp cho dữ liệu đầu vào thu gọn.
colour_	protected	string	Màu của khối ở định dạng "#RRGGBB".
compose?		(p1: Chặn) => vô hiệu	(Không bắt buộc) Một hàm không bắt buộc có thể định cấu hình lại khối dựa trên nội dung của hộp thoại đối tượng biến đổi.
contextMenu		boolean
dữ liệu		chuỗi | giá trị rỗng	Dữ liệu văn bản không bắt buộc trả về giữa các khối và XML. Không có tác dụng. Bên thứ ba có thể sử dụng thông tin tổng hợp.
phân tách?		(p1: Không gian làm việc) => Chặn	(Không bắt buộc) Một hàm không bắt buộc điền sẵn các thành phần của khối này vào hộp thoại của trình biến đổi.
destroy?		() => khoảng trống	(Không bắt buộc) Một phương thức không bắt buộc được gọi trong quá trình loại bỏ.
domToMutation?		(p1: Phần tử) => khoảng trống	(Không bắt buộc) Một phương thức huỷ chuyển đổi tuần tự không bắt buộc để xác định cách giải tuần tự trạng thái đột biến từ XML. Điều này phải được kết hợp với việc xác định mutationToDom.
getDeveloperVariables?		() => string[]	(Không bắt buộc) Một thuộc tính không bắt buộc để khai báo biến dành cho nhà phát triển. Trả về danh sách tên biến để trình tạo sử dụng. Biến của nhà phát triển không bao giờ hiển thị cho người dùng nhưng được khai báo là biến toàn cục trong mã được tạo.
mũ?		string	(Không bắt buộc) Tên của loại mũ.
helpUrl		string | Function | null	Chuỗi trợ giúp chặn hoặc hàm trả về URL. Rỗng khi không có sự trợ giúp.
biểu tượng		IIcon[]
id		string
init?		() => khoảng trống	(Không bắt buộc) Một phương thức không bắt buộc được gọi trong quá trình khởi chạy.
inputList		Dữ liệu đầu vào[]
inputsInline?		boolean	(Không bắt buộc)
inputsInlineDefault?		boolean	(Không bắt buộc)
isInFlyout		boolean
isInMutator		boolean
isInsertionMarker_	protected	boolean	"True" nếu khối này là một điểm đánh dấu chèn.
loadExtraState?		(p1: bất kỳ) => vô hiệu	(Không bắt buộc) Phương thức chuyển đổi tuần tự không bắt buộc để xác định cách giải tuần tự trạng thái bổ sung của khối (ví dụ: trạng thái đột biến) từ trạng thái tương thích với JSON. Điều này phải được kết hợp với việc xác định saveExtraState.
mutationToDom?		(...p1: bất kỳ[]) => Phần tử	(Không bắt buộc) Phương thức chuyển đổi tuần tự không bắt buộc để xác định cách chuyển đổi tuần tự trạng thái đột biến thành XML. Điều này phải được kết hợp với việc xác định domToMutation.
nextConnection		Kết nối | rỗng
không thay đổi?		((p1: Abstract) => void) | null	(Không bắt buộc) Một phương thức gọi lại (không bắt buộc) để sử dụng bất cứ khi nào không gian làm việc chính của khối thay đổi. Hàm này thường chỉ được gọi từ hàm khởi tạo, hàm khởi tạo kiểu khối hoặc hàm khởi tạo tiện ích.
outputConnection		Kết nối | rỗng
outputShape_	protected	số | giá trị rỗng
parentBlock_	protected	này | giá trị rỗng
previousConnection		Kết nối | rỗng
đã kết xuất		boolean | null
RTL		boolean
saveExtraState?		(doFullSerialization?: boolean) => bất kỳ	(Không bắt buộc) Phương thức chuyển đổi tuần tự không bắt buộc để xác định cách chuyển đổi tuần tự trạng thái bổ sung của khối (ví dụ: trạng thái đột biến) thành trạng thái tương thích với JSON. Điều này phải được kết hợp với việc xác định loadExtraState.
styleName_	protected	string	Tên của kiểu khối.
suppressPrefixSuffix		boolean | null	Một thuộc tính không bắt buộc để chặn việc thêm STATEMENT_PREFIX và STATEMENT_SUFFIX vào mã được tạo.
chú giải công cụ		Tooltip.TipInfo
loại		string
không gian làm việc		Không gian làm việc

Phương thức

Phương thức	Đối tượng sửa đổi	Nội dung mô tả
addIcon(icon)		Thêm biểu tượng đã cho vào khối.
allInputsFilled(opt_shadowBlocksAreFilled)		Kiểm tra định kỳ xem tất cả đầu vào câu lệnh và giá trị có được điền bằng các khối hay không. Đồng thời kiểm tra tất cả khối câu lệnh sau trong ngăn xếp này.
appendDummyInput(name)		Thêm một hàng nhập giả.
appendEndRowInput(name)		Thêm một giá trị đầu vào kết thúc hàng.
appendInput(input)		Thêm hàng dữ liệu đầu vào đã cho. Cho phép thêm dữ liệu đầu vào tuỳ chỉnh vào khối.
appendStatementInput(name)		Thêm hàng nhập câu lệnh.
appendValueInput(name)		Thêm một hàng nhập giá trị.
bumpNeighbours()		Huỷ các khối chưa được kết nối ra khỏi căn chỉnh. Hai khối không thực sự được kết nối với nhau không được xếp ngẫu nhiên trên màn hình.
dispose(healStack)		Hãy vứt bỏ khối này.
disposeInternal()	protected	Loại bỏ khối này mà không thực hiện những việc theo yêu cầu của khối trên cùng. Ví dụ: không kích hoạt sự kiện, rút phích cắm khối, v.v.
doInit_()	protected	Gọi hàm init() và xử lý việc kích hoạt sự kiện liên quan, v.v.
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 đầu vào giá trị và câu lệnh, cũng như bất kỳ câu lệnh nào sau đây. Loại trừ mọi kết nối trên thẻ đầu ra hoặc bất kỳ câu lệnh nào trước đó. Các khối được sắp xếp tuỳ ý theo vị trí; từ trên xuống dưới.
getColour()		Lấy màu của một khối.
getCommentText()		Trả về nhận xét trong khối này (hoặc rỗng nếu không có nhận xét nào).
getDescendants(ordered)		Hãy tìm tất cả các khối được lồng trực tiếp hoặc gián tiếp bên trong khối này. Đưa khối này vào danh sách. Bao gồm giá trị đầu vào và câu lệnh, cũng như bất kỳ câu lệnh nào sau đây. Loại trừ mọi kết nối trên thẻ đầu ra hoặc mọi câu lệnh trước đó. Các khối được sắp xếp tuỳ ý theo vị trí; từ trên xuống dưới.
getField(name)		Trả về trường được đặt tên từ một khối.
getFieldValue(name)		Trả về giá trị trung tính về ngôn ngữ của trường cho trước.
getHue()		Lấy giá trị sắc độ HSV của một khối. Rỗng nếu màu không được đặt.
getIcon(type)
getIcons()
getInheritedDisabled()		Xem chế độ chặn có bị vô hiệu hoá hay không là do cha mẹ. Tài sản vô hiệu hoá của chính khối đó sẽ không được xem xét.
getInput(name)		Tìm nạp đối tượng đầu vào đã đặt tên.
getInputsInline()		Xem giá trị đầu vào được sắp xếp theo chiều ngang hay chiều dọc.
getInputTargetBlock(name)		Tìm nạp khối đính kèm với giá trị đầu vào được đặt tên.
getInputWithBlock(block)		Trả về dữ liệu đầu vào kết nối với khối đã chỉ định.
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.
getOutputShape()		Lấy hình dạng đầu ra của khối.
getParent()		Trả về khối mẹ hoặc giá trị rỗng nếu khối này ở cấp cao nhất. Khối mẹ là khối được kết nối với kết nối trước đó (đối với khối câu lệnh) hoặc khối được kết nối với kết nối đầu ra (đối với khối giá trị).
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 gốc của bề mặt vẽ (0,0) theo đơn vị không gian làm việc.
getRootBlock()		Trả về khối trên cùng trong cây của khối này. Thao tác này sẽ tự trả về nếu khối này ở cấp cao nhất.
getStyleName()		Lấy tên của kiểu khối.
getSurroundParent()		Return the parent block that surrounds the current block, or null if this block has no surrounding block. Khối cha có thể chỉ là câu lệnh trước, trong khi khối xung quanh là câu lệnh if, vòng lặp while, v.v.
getTooltip()		Trả về văn bản chú giải công cụ cho khối này.
getVars()		Trả về tất cả biến được tham chiếu bởi khối này.
hasIcon(type)
initModel()		Gọi initModel trên tất cả các trường trong khối. Có thể được gọi nhiều lần. Phải gọi initModel hoặc initSvg sau khi tạo một khối và trước lần tương tác đầu tiên với khối đó. Hoạt động tương tác bao gồm các hành động trên giao diện người dùng (ví dụ: nhấp và kéo) và kích hoạt sự kiện (ví dụ: tạo, xóa và thay đổi).
isCollapsed()		Biết được khối có được thu gọn hay không.
isDeletable()		Xem có thể xoá khối này hay không.
isDisposed()		Trả về nếu khối này đã bị huỷ bỏ / bị xoá.
isDuplicatable()		Nhận xem khối có trùng lặp hay không. Nếu sao chép khối này và các thành phần con sẽ đặt khối này lên dung lượng của không gian làm việc, khối này không thể sao chép được. Nếu sao chép khối này và các thành phần con cháu sẽ đặt bất kỳ loại nào vào maxInstances của chúng, khối này không thể sao chép được.
isEnabled()		Xem tính năng chặn này đã được bật hay chưa.
isInsertionMarker()		Xem khối này có phải là một khối đánh dấu chèn hay không.
isOwnDeletable()		Trả về giá trị cho biết thuộc tính có thể xoá của khối này là true (đúng) hay false (sai).
isOwnEditable()		Trả về giá trị xem thuộc tính có thể chỉnh sửa của chính khối này là true (đúng) hay false (sai).
isShadow()		Nhận biết xem khối này có phải là một khối bóng đổ hay không.
jsonInit(json)		Hãy khởi động khối này bằng nội dung mô tả JSON phù hợp với thị trường quốc tế và nhiều nền tảng.
mixin(mixinObj, opt_disableCheck)		Thêm khoá/giá trị từ mixinObj vào đối tượng khối này. Theo mặc định, phương thức này sẽ kiểm tra để đảm bảo rằng các khoá trong mixinObj sẽ không ghi đè các giá trị hiện có trong khối, bao gồm cả giá trị nguyên mẫu. Điều này cung cấp một số bảo hiểm chống lại hiện tượng không tương thích kết hợp / tiện ích với các tính năng khối trong tương lai. Bạn có thể tắt quy trình kiểm tra này bằng cách truyền giá trị true làm đối số thứ hai.
moveBy(dx; dy, lý do)		Di chuyển khối theo độ lệch tương đối.
moveInputBefore(name, refName)		Di chuyển một dữ liệu đầu vào đã đặt tên sang một vị trí khác trong khối này.
moveNumberedInputBefore(inputIndex, refIndex)		Di chuyển giá trị đầu vào được đánh số đến vị trí khác trong khối này.
removeIcon(type)		Xoá biểu tượng có getType khớp với kiểu iconType đã cho khỏi khối.
removeInput(name, opt_quiet)		Hãy xoá một dữ liệu đầu vào khỏi khối này.
renameVarById(oldId, newId)		Thông báo cho biết một biến đang được đổi tên. Nếu mã nhận dạng khớp với một trong các biến của khối này, hãy đổi tên mã đó.
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.
setCommentText(text)		Đặt văn bản nhận xét của khối này.
setDeletable(deletable)		Thiết lập xem bạn có thể xoá khối này hay không.
setEditable(editable)		Thiết lập xem khối này có thể chỉnh sửa hay không.
setEnabled(enabled)		Thiết lập xem bạn có bật tính năng chặn hay không.
setFieldValue(newValue, name)		Đặt giá trị của trường đã cho cho khối này.
setHelpUrl(url)		Đặt URL cho trang trợ giúp của quy tắc chặn này.
setInputsInline(newBoolean)		Thiết lập để sắp xếp giá trị đầu vào theo chiều ngang hay chiều dọc.
setMovable(movable)		Thiết lập xem khối này có thể di chuyển hay không.
setMutator(_mutator)		Cung cấp cho khối này một hộp thoại biến đổi.
setNextStatement(newBoolean, opt_check)		Thiết lập xem một khối khác có thể xâu chuỗi vào phần dưới cùng của khối này hay không.
setOnChange(onchangeFn)		Thiết lập hàm callback để sử dụng bất cứ khi nào không gian làm việc chính của khối thay đổi, thay thế bất kỳ trình xử lý onchange nào trước đó. Hàm này thường chỉ được gọi từ hàm khởi tạo, hàm khởi tạo kiểu khối hoặc hàm khởi tạo tiện ích.
setOutput(newBoolean, opt_check)		Thiết lập xem khối này có trả về một giá trị hay không.
setOutputShape(outputShape)		Đặt hình dạng đầu ra của khối.
setPreviousStatement(newBoolean, opt_check)		Thiết lập xem khối này có thể xâu chuỗi vào phần dưới cùng của 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.
setTooltip(newTip)		Đặt chú giải công cụ cho khối này.
setWarningText(_text, _opt_id)		Đặt văn bản cảnh báo của khối này.
toDevString()		Phương thức này trả về một chuỗi mô tả Khối này trong điều khoản của nhà phát triển (tên loại và mã nhận dạng, chỉ có bằng tiếng Anh). Dành để sử dụng trong nhật ký bảng điều khiển và lỗi. Nếu bạn cần một chuỗi sử dụng ngôn ngữ bản địa của người dùng (bao gồm văn bản khối, giá trị trường và khối con), hãy sử dụng [toString()].
toString(opt_maxLength, opt_emptyToken)		Tạo bản trình bày văn bản con người có thể đọc được của khối này và của bất kỳ thành phần con nào.
unplug(opt_healStack)		Rút khối này ra khỏi khối cao cấp. Nếu khối này là một câu lệnh, tuỳ ý kết nối lại khối bên dưới với khối ở trên cùng.