blockly > Chặn

Chặn lớp

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

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 Nội dung 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

Tài sản Đối tượng sửa đổi Loại Nội dung mô tả
childBlocks_ protected nội dung này[]
collapsed_ protected boolean
COLLAPSED_FIELD_NAME

static

readonly

 string Mã trung lập về ngôn ngữ được cấp cho trường thu gọn.
COLLAPSED_INPUT_NAME

static

readonly

 string Mã trung lập 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 đị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 | giá trị rỗng Dữ liệu văn bản không bắt buộc đi vòng quanh giữa các khối và XML. Không có tác dụng. Có thể được bên thứ ba sử dụng cho thông tin meta.
phân huỷ hơn không? (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 biến thể.
destroy? () => 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ỏ.
xử lý protected boolean Khối hiện tại có đang trong quá trình được tiêu huỷ không?
DomToMutation? (p1: Phần tử) => trống (Không bắt buộc) 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. Mã 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 cho nhà phát triển. Trả về danh sách tên biế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ã đã 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. Trống không cần 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ỳ) => 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. Mã 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. Mã này phải được kết hợp với việc xác định domToMutation.
nextConnection Kết nối | giá trị rỗng
không? ((p1: Abstract) => void) | null (Không bắt buộc) Phương pháp gọi lại không bắt buộc mà bạn có thể sử dụng mỗi khi 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 | giá trị rỗng
outputShape_ protected số | giá trị rỗng
parentBlock_ protected này | rỗng
previousConnection Kết nối | giá trị rỗng
đã kết xuất readonly boolean Đây có phải là khối 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 trạng thái tương thích với JSON. Mã 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 để ngăn việc thêm STATEMENT_PREFIX và STATEMENT_NAMES 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ả các đầu vào câu lệnh và giá trị có được điền các khối hay không. Đồng thời kiểm tra tất cả khối lệnh sau trong ngăn xếp này.
appendDummyInput(name) Thêm một hàng dữ liệu đầu vào giả.
appendEndRowInput(name) Thêm dữ liệu đầ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() Làm bật 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 không được tình cờ thẳng hàng trên màn hình.
dispose(healStack) Hãy vứt bỏ khối này.
disposeInternal() protected Xử lý 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 vào trong khối này. Bao gồm giá trị đầu vào và bảng sao kê, 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() Nhận 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 vào 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ư các câu lệnh 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 tuỳ ý theo vị trí; từ trên xuống dưới.
getDisabledReasons() Xem một nhóm lý do khiến tính năng chặn hiện đang bị vô hiệu hoá, nếu có. Nếu bạn bật quy tắc chặn, tập hợp 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ị trung tính về ngôn ngữ của trường đã cho.
getHue() Lấy giá trị sắc độ HSV của một khối. Có giá trị là rỗng nếu chưa đặt màu.
getIcon(type)
getIcons()
getInheritedDisabled() Biết được tính năng chặn có bị vô hiệu hoá hay không là do cha mẹ. Thuộc tính bị vô hiệu hoá của chính khối đó không được xem xét.
getInput(name) Tìm nạp đối tượng đầu vào được đặt tên.
getInputsInline() Nhận biết liệu 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 đượ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 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ẹ có thể 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 đó.
getAudienceToSurfaceXY() Trả về toạ độ của góc trên cùng bên trái 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. 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 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 tính năng chặn có bị vô hiệu hoá vì lý do đã nêu hay không.
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 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() Xem khối có được thu gọn hay không.
isDeletable() Biết được khối này có thể xoá hay không.
isDisposed() Trả về nếu khối này đã bị huỷ bỏ / xoá.
isDuplicatable() Biết được khối có trùng lặp hay không. Nếu việc sao chép khối này và các thành phần con sẽ đặt khối này vượt quá hạn mức của không gian làm việc, khối này không thể trùng lặp. Nếu việc sao chép khối này và các thành phần con sẽ đặt mọi kiểu vào maxInstances, khối này không thể trùng lặp.
isEnabled() Biết được tính năng chặn này đã được bật hay chưa. Tính năng chặn được coi là đã bật nếu không có lý do nào khiến khối đó bị vô hiệu hoá. Thao tác chặn vẫn có thể bị vô hiệu hoá vì các lý do khác, ngay cả khi người dùng cố gắng bật tuỳ chọn đó theo cách thủ công, chẳng hạn như khi quy tắc chặn ở vị trí không hợp lệ.
isInsertionMarker() Xác định xem khối này có phải là khối đánh dấu chèn hay không.
isOwnDeletable() Trả về giá trị xem thuộc tính có thể xoá của chính khối này là đúng hay 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 hay false.
isShadow() Biết được khối này có phải là 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 nhiều nền tảng và phù hợp với việc 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 pháp 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 chống lại sự không tương thích của kết hợp / tiện ích với các tính năng chặn 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 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 dữ liệu đầu vào đã đặt tên đến 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 loại 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 biến đó.
setCollapsed(collapsed) Thiết lập 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 nội dung nhận xét của khối này.
setDeletable(deletable) Thiết lập xem khối này có thể xoá hay không.
setDisabledReason(disabled, reason) Thêm hoặc xoá lý do khiến tính năng chặn có thể bị vô hiệu hoá. Nếu một khối có lý do nào đó để bị vô hiệu hoá, thì chính khối đó sẽ được coi là đã bị vô hiệu hoá. Một quy tắc chặn 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 vô hiệu hoá quy tắc theo cách thủ công hoặc quy tắc chặn không hợp lệ.
setEditable(editable) Thiết lập xem khối này có thể chỉnh sửa 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 xem giá trị đầu vào đượ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ó di chuyển được 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) Đặ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 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ả Chặn này trong các thuật ngữ của nhà phát triển (tên loại và mã; chỉ có bằng tiếng Anh).

Mục đích để 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 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 đại diện bằng văn bản mà con người có thể đọc được của khối này và bất kỳ thành phần con nào.
unplug(opt_healStack) Rút phích cắm khối này khỏi khối cấp cao. Nếu khối này là một câu lệnh, thì bạn có thể tuỳ ý kết nối khối bên dưới với khối ở trên cùng.