blockly > Khối

Lớp khối

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

Chữ ký:

export declare class Block 

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 Block

Thuộc tính

Thuộc tính	Đối tượng sửa đổi	Loại	Mô tả
childBlocks_	protected	this[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	chuỗi	Mã nhận dạng không phân biệt ngôn ngữ được cấp cho trường thu gọn.
COLLAPSED_INPUT_NAME	static readonly	chuỗi	Mã nhận dạng không phân biệt ngôn ngữ được cấp cho dữ liệu đầu vào thu gọn.
colour_	protected	chuỗi	Màu của khối ở định dạng "#RRGGBB".
compose?		(rootBlock: Block) => void	(Không bắt buộc) Một phương thức 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 đối tượng sửa đổi.
contextMenu		boolean
data		string | null	Dữ liệu văn bản không bắt buộc, thực hiện hành trình khứ hồi giữa các khối và XML. Không có hiệu lực. Có thể được bên thứ ba sử dụng cho thông tin siêu dữ liệu.
phân ly?		(workspace: Workspace) => Chặn	(Không bắt buộc) Một hàm không bắt buộc sẽ điền sẵn trình đơn bật lên của công cụ sửa đổi bằng các khối đại diện cho cấu hình của khối này.
huỷ bỏ?		() => void	(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ỏ.
xử lý	protected	boolean	Khối hiện tại có đang trong quá trình bị loại bỏ không?
domToMutation?		(p1: Phần tử) => void	(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 từ XML. Bạn phải kết hợp với việc xác định mutationToDom.
getDeveloperVariables?		() => string[]	(Không bắt buộc) Một phương thức không bắt buộc để khai báo biến nhà phát triển, để trình tạo sử dụng. Biến dành cho nhà phát triển không bao giờ hiển thị cho người dùng, nhưng được khai báo dưới dạng biến toàn cục trong mã được tạo.
mũ?		chuỗi	(Không bắt buộc) Tên loại mũ.
helpUrl		string | (() => string) | null	Chuỗi cho phần trợ giúp về khối hoặc hàm trả về URL. Rỗng nếu không có trợ giúp.
biểu tượng		IIcon[]
id		chuỗi
init?		() => void	(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à điểm chèn.
loadExtraState?		(p1: any) => void	(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 bổ sung của khối (ví dụ: trạng thái đột biến) từ một nội dung 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: any[]) => Phầ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 sang XML. Bạn phải kết hợp với việc xác định domToMutation.
nextConnection		Kết nối | null
onchange?		((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 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 | null
outputShape_	protected	number | null
parentBlock_	protected	this | null
previousConnection		Kết nối | null
hiển thị	readonly	boolean	Khối này có phải là BlockSVG không?
RTL		boolean
saveExtraState?		(doFullSerialization?: boolean) => any	(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 bổ sung của khối (ví dụ: trạng thái đột biến) thành một nội dung 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	chuỗi	Tên của kiểu khối.
suppressPrefixSuffix		boolean | null	Một thuộc tính không bắt buộc để ngăn 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
type		chuỗi
workspace		Workspace

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 đệ quy xem tất cả các câu lệnh và giá trị đầu vào có được điền bằng các khối hay không. Ngoài ra, hãy 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 đầu vào giả.
appendEndRowInput(name)		Thêm một giá trị đầu vào kết thúc hàng.
appendInput(input)		Thêm hàng đầ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 một hàng nhập câu lệnh.
appendValueInput(name)		Thêm một hàng nhập giá trị.
bumpNeighbours()		Đẩy các khối không được kết nối ra khỏi vị trí căn chỉnh. Hai khối không thực sự kết nối với nhau không được tình cờ xếp hàng trên màn hình.
dispose(healStack)		Xoá khối này.
disposeInternal()	protected	Xoá 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ụ: 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 giá trị và dữ liệu đầu vào của câu lệnh, cũng như mọi câu lệnh theo sau. 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 theo vị trí (không bắt buộc); 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 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. Thêm khối này vào danh sách. Bao gồm giá trị và dữ liệu đầu vào câu lệnh, cũng như mọi câu lệnh theo sau. Không bao gồm bất kỳ kết nối nào 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 theo vị trí (không bắt buộc); từ trên xuống dưới.
getDisabledReasons()		Xem một số lý do khiến lệnh chặn hiện đang bị vô hiệu hoá (nếu có). Nếu bạn bật khối này, tập hợp này sẽ trống.
getField(name)		Trả về trường được đặt tên từ một khối.
getFields()		Trả về một trình tạo cung cấp mọi trường trên khối. Một trình tạo có thể dùng để lặp lại các trường trên khối.
getFieldValue(name)		Trả về giá trị không phân biệt ngôn ngữ của trường đã cho.
getHue()		Lấy giá trị sắc độ HSV của một khối. Rỗng nếu không đặt màu sắc.
getIcon(type)
getIcons()
getInheritedDisabled()		Xem liệu tính năng chặn có bị tắt do cha mẹ hay không. Hệ thống không xem xét thuộc tính bị tắt của chính khối.
getInput(name)		Tìm nạp đối tượng đầu vào được đặt tên.
getInputsInline()		Xem dữ liệu đầu vào giá trị được sắp xếp theo chiều ngang hay chiều dọc.
getInputTargetBlock(name)		Tìm nạp khối được đính kèm vào dữ liệu đầ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), tính 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ẹ bao quanh khối hiện tại hoặc 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 đó, 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.
hasDisabledReason(reason)		Xem liệu quy tắc chặn hiện có bị vô hiệu hoá vì lý do đã cung cấp hay không.
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. Bạn phải gọi initModel hoặc initSvg sau khi tạo một khối và trước khi tương tác lần đầu với khối đó. Các hoạt động tương tác bao gồm thao tác trên giao diện người dùng (ví dụ: nhấp và kéo) và sự kiện kích hoạt (ví dụ: tạo, xoá và thay đổi).
isCollapsed()		Xem liệu khối có bị thu gọn hay không.
isDeletable()		Xem liệu bạn có thể xoá khối này hay không.
isDisposed()		Trả về giá trị nếu khối này đã bị loại bỏ / xoá.
isDuplicatable()		Xem liệu khối có thể sao chép hay không. Nếu việc sao chép khối này và các khối con sẽ khiến khối này vượt quá dung lượng của không gian làm việc, thì bạn sẽ không thể sao chép khối này. Nếu việc sao chép khối này và các khối con sẽ đặt bất kỳ loại nào trên maxInstances của chúng, thì khối này sẽ không sao chép được.
isEnabled()		Xem liệu khối này có được bật hay không. Một khối được coi là đang bật nếu không có lý do nào khiến khối đó bị tắt. Một khối vẫn có thể bị tắt vì các lý do khác ngay cả khi người dùng cố gắng bật khối đó theo cách thủ công, chẳng hạn như khi khối đó ở vị trí không hợp lệ.
isInsertionMarker()		Xác định xem khối này có phải là khối điểm đánh dấu chèn hay không.
isOwnDeletable()		Trả về giá trị true hoặc false cho thuộc tính có thể xoá của khối này.
isOwnEditable()		Trả về giá trị true hoặc false cho biết thuộc tính có thể chỉnh sửa của khối này là true hay false.
isShadow()		Xem liệu khối này có phải là khối bóng hay không.
jsonInit(json)		Khởi tạo khối này bằng nội dung mô tả JSON đa nền tảng, 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ả giá trị nguyên mẫu. Điều này giúp đảm bảo rằng mixin / tiện ích không tương thích với các tính năng khối trong tương lai. Bạn có thể tắt tính năng kiểm tra này bằng cách truyền true làm đối số thứ hai.
moveBy(dx, dy, reason)		Di chuyển một khối theo độ dời tương đối.
moveInputBefore(name, refName)		Di chuyển dữ liệu đầu vào được đặt tên đến một vị trí khác trên khối này.
moveNumberedInputBefore(inputIndex, refIndex)		Di chuyển dữ liệu đầu vào được đánh số sang 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 khỏi khối.
removeInput(name, opt_quiet)		Xoá một dữ liệu đầu vào khỏi khối này.
renameVarById(oldId, newId)		Thông báo về việc đổi tên biế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ã nhận dạng đó.
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.
setCommentText(text)		Đặt văn bản nhận xét của khối này.
setDeletable(deletable)		Đặt xem bạn có thể xoá khối này hay không.
setDisabledReason(disabled, reason)		Thêm hoặc xoá lý do khiến lệnh chặn có thể bị vô hiệu hoá. Nếu một khối bị vô hiệu hoá vì bất kỳ lý do gì, thì chính khối đó sẽ được coi là bị vô hiệu hoá. Một khối có thể bị vô hiệu hoá cùng lúc vì nhiều lý do độc lập, chẳng hạn như khi người dùng vô hiệu hoá khối đó theo cách thủ công hoặc khối đó không hợp lệ.
setEditable(editable)		Thiết lập xem bạn có thể chỉnh sửa khối này hay không.
setFieldValue(newValue, name)		Đặt giá trị của trường đã cho cho khối này.
setHelpUrl(url)		Đặt URL của trang trợ giúp của khối này.
setInputsInline(newBoolean)		Đặt xem dữ liệu đầu vào giá trị được sắp xếp 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 được hay không.
setMutator(_mutator)		Đặt hộp thoại đối tượng sửa đổi cho khối này.
setNextStatement(newBoolean, opt_check)		Đặt xem một khối khác có thể tạo chuỗi vào cuối khối này hay không.
setOnChange(onchangeFn)		Đặt một hàm gọi lại để sử dụng bất cứ khi nào không gian làm việc mẹ của khối thay đổi, thay thế mọi trình xử lý onchange 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)		Đặ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ể tạo chuỗi vào cuối một khối khác hay không.
setStyle(blockStyleName)		Đặt kiểu và giá trị 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 theo các thuật ngữ dành cho nhà phát triển (tên loại và mã nhận dạng; chỉ tiếng Anh). Dùng trong nhật ký và lỗi của bảng điều khiển. 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 biểu thị khối này và mọi phần tử con mà con người có thể đọc được.
unplug(opt_healStack)		Rút khối này khỏi khối cấp trên. Nếu khối này là một câu lệnh, hãy kết nối lại khối bên dưới với khối ở trên cùng (không bắt buộc).