chặn > Chặn

Chặn lớp học

Lớp cho 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 Block implements IASTNodeLocation 

Triển khai: IASTNodeLocation

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 Block

Thuộc tính

Thuộc tính	Đối tượng sửa đổi	Loại	Mô tả
childBlocks_	protected	nội dung này[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	string	Mã nhận dạng trung lập về ngôn ngữ được cung cấp cho trường thu gọn.
COLLAPSED_INPUT_NAME	static readonly	string	Mã nhận dạng trung lập về ngôn ngữ được cung cấp cho nội dung nhập được thu gọn.
colour_	protected	string	Màu của khối trong "#RRGGBB" .
soạn thư không?		(p1: Chặn) => trống	(Không bắt buộc) Một hàm không bắt buộc giúp định cấu hình lại khối dựa trên nội dung của hộp thoại biến đổi.
contextMenu		boolean
dữ liệu		chuỗi | rỗng	Dữ liệu văn bản không bắt buộc chuyển đổi giữa các khối và XML. Không có tác dụng. Có thể bên thứ ba sử dụng siêu thông tin này.
phân huỷ?		(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 các thành phần của khối này vào hộp thoại của biến đổi.
huỷ bỏ?		() => 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ỏ.
loại bỏ	protected	boolean	Quy tắc chặn hiện tại có đang trong quá trình được xử lý không?
domToMutation?		(p1: Phần tử) => trống	(Không bắt buộc) Một phương thức huỷ 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. Bạn phải kết hợp với việc xác định mutationToDom.
getDeveloperVariables?		() => chuỗi[]	(Không bắt buộc) Thuộc tính không bắt buộc để khai báo biến của 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ị với 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		chuỗi | Hàm | rỗng	Chuỗi trợ giúp về khối hoặc hàm trả về một URL. Rỗng không có sự trợ giúp.
biểu tượng		IIcon[]
id		string
init?		() => 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		Đầ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	Đúng nếu khối này là một điểm đánh dấu chèn.
loadExtraState?		(p1: bất kỳ) => trống	(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) so với trạng thái tương thích với JSON. Bạn phải kết hợp với việc xác định saveExtraState.
mutationToDom?		(...p1: bất kỳ[]) => Nguyên tố	(Không bắt buộc) Một 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. Bạn phải kết hợp với việc xác định domToMutation.
nextConnection		Kết nối | rỗng
thay đổi?		((p1: Abstract) => khoảng trống) | rỗng	(Không bắt buộc) 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 mẹ 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ố | rỗng
parentBlock_	protected	này | rỗng
previousConnection		Kết nối | rỗng
được kết xuất	readonly	boolean	Liệu tệp này có chặn một BlockSVG không?
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 một trạng thái tương thích với JSON. Bạn phải 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 | rỗng	Thuộc tính không bắt buộc để loại bỏ việc thêm STATEMENT_PREFIX và STATEMENT_HOWMANY vào mã đã 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	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ả dữ liệu đầu vào giá trị và câu lệnh có được điền bằng các khối hay không. Đồng thời kiểm tra tất cả cá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 mục nhập kết thúc hàng.
appendInput(input)		Thêm hàng đã nhập. Cho phép thêm mục nhập tuỳ chỉnh vào khối.
appendStatementInput(name)		Thêm một hàng nhập câu lệnh.
appendValueInput(name)		Thêm một hàng nhập giá trị.
bumpNeighbours()		Đổ 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ự liên kết với nhau sẽ không trùng khớp xuất hiện trên màn hình.
dispose(healStack)		Vứt bỏ khối này.
disposeInternal()	protected	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ụ: không kích hoạt các 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 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.
getCommentText()		Trả về nhận xét trên khối này (hoặc rỗng nếu không có nhận xét).
getDescendants(ordered)		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 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.
getDisabledReasons()		Xem một số lý do khiến việc chặn hiện đang bị vô hiệu hoá, nếu có. Nếu chặn được bật, nhóm này sẽ trống.
getField(name)		Trả về trường được đặt tên từ một khối.
getFieldValue(name)		Trả về giá trị ngôn ngữ trung lập của trường đã cho.
getHue()		Lấy giá trị màu HSV của một khối. Giá trị rỗng nếu không được thiết lập màu sắc.
getIcon(type)
getIcons()
getInheritedDisabled()		Biết được liệu tính năng chặn có bị tắt do cha mẹ hay không. Thuộc tính bị vô hiệu hoá của riêng khối không được xem xét.
getInput(name)		Tìm nạp đối tượng đầu vào đã đặt tên.
getInputsInline()		Biết được liệu các 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 đi kèm với dữ liệu đầu vào đã đặt tên.
getInputWithBlock(block)		Trả về dữ liệu đầu vào kết nối với khối được 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 đã 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. Hàm 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()		Trả về khối mẹ xung quanh khối hiện tại hoặc trả về giá trị rỗng nếu khối này không có khối xung quanh. Khối mẹ có thể chỉ là câu lệnh trước, còn 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ả các biến được khối này tham chiếu.
hasDisabledReason(reason)		Kiểm tra xem quy tắc chặn hiện đã bị tắt hay chưa vì lý do đã nêu.
hasIcon(type)
initModel()		Gọi initModel trên tất cả các trường trên khối. Có thể được gọi nhiều lần. Phải gọi initModel hoặc initSvg sau khi tạo khối và trước lượt tương tác đầu tiên với khối đó. Các 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) cũng như kích hoạt các sự kiện (ví dụ: tạo, xoá và thay đổi).
isCollapsed()		Biết được liệu khối có được thu gọn hay không.
isDeletable()		Biết được liệu khối này có thể xoá được hay không.
isDisposed()		Trả về nếu khối này đã bị loại bỏ / xoá.
isDuplicatable()		Biết liệu khối có thể 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 trên dung lượng của không gian làm việc, thì khối này sẽ không thể trùng lặp. Nếu bạn sao chép khối này và các thành phần con sẽ đặt bất kỳ kiểu nào lên maxInstances của chúng, thì khối này sẽ không thể trùng lặp.
isEnabled()		Biết được liệu khối này có được bật hay không. Một quy tắc chặn được coi là đã bật nếu không có lý do nào khiến quy tắc đó bị vô hiệu hoá. Tính năng chặn vẫn có thể bị tắt vì những lý do khác ngay cả khi người dùng cố gắng bật tính năng đó theo cách thủ công, chẳng hạn như khi quy tắc chặn nằm ở một vị trí không hợp lệ.
isInsertionMarker()		Kiểm tra xem khối này có phải là khối đánh dấu chèn hay không.
isOwnDeletable()		Trả về xem thuộc tính có thể xoá của riêng khối này là true hay false.
isOwnEditable()		Trả về xem thuộc tính có thể chỉnh sửa của chính khối này là true hay false.
isShadow()		Biết được khối này có phải là khối bóng hay không.
jsonInit(json)		Khởi động khối này bằng cách sử dụng nội dung mô tả JSON phù hợp với nhiều nền tảng và phù hợp với quốc tế hoá.
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ả các giá trị nguyên mẫu. Điều này giúp đảm bảo tính không tương thích giữa trộn / tiện ích với các tính năng chặn trong tương lai. Bạn có thể tắt chế độ 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 một khối theo độ lệch tương đối.
moveInputBefore(name, refName)		Di chuyển mục nhập đã đặt tên đến một vị trí khác trên khối này.
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.
removeIcon(type)		Xoá biểu tượng có getType khớp với loại iconType cho trước khỏi khối.
removeInput(name, opt_quiet)		Xoá một giá trị nhập khỏi khối này.
renameVarById(oldId; newId)		Thông báo cho biết một biến đang đổ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)		Đặt xem khối này có thể xoá được hay không.
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ệ.
setEditable(editable)		Đặt liệu khối này có thể chỉnh sửa được hay không.
setEnabled(enabled)
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 khối này.
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.
setOnChange(onchangeFn)		Đặt một 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 trước đó nào. 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)		Đặt xem khối này có trả về giá trị hay không.
setOutputShape(outputShape)		Đặt hình dạng đầu ra của khối.
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.
setTooltip(newTip)		Đặt chú thích cho quy tắc chặn 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ả Chặn này trong cụm từ dành cho nhà phát triển (tên loại và mã nhận dạng; chỉ có bằng tiếng Anh). Nhằm 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ữ gốc của người dùng (bao gồm cả 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 một văn bản đại diện mà con người có thể đọc được của khối này và bất kỳ phần tử con nào.
unplug(opt_healStack)		Rút khối này ra khỏi khối cấp trên. Nếu khối này là một câu lệnh, bạn có thể tuỳ ý kết nối lại khối ở bên dưới với khối ở trên cùng.