Blockly | Google for Developers

調査アンケート: Blockly のご利用体験についてお聞かせください

このページは Cloud Translation API によって翻訳されました。

ブロックのクラス

1 つのブロックのクラス。通常、直接呼び出されることはありませんが、workspace.newBlock() が推奨されます。

署名:

export declare class Block implements IASTNodeLocation

実装: IASTNodeLocation

コンストラクタ

コンストラクタ	修飾子	説明
(structor)(workspace, promptName, opt_id)		`Block` クラスの新しいインスタンスを作成します。

プロパティ

プロパティ	修飾子	タイプ	説明
childBlocks_	`protected`	こちら []
collapsed_	`protected`	ブール値
COLLAPSED_FIELD_NAME	`static` `readonly`	文字列	折りたたまれたフィールドに付与される、言語に依存しない ID。
COLLAPSED_INPUT_NAME	`static` `readonly`	文字列	折りたたまれた入力に与えられる言語に依存しない ID。
colour_	`protected`	文字列	「#RRGGBB」のブロックの色使用できます。
作成？		(p1: ブロック) =>無効	（省略可）ミューテータダイアログの内容に基づいてブロックを再構成するオプションの関数。
contextMenu		ブール値
データ		文字列 \|null	ブロックと XML の間を往復するテキストデータ（省略可）。効果なしサードパーティによってメタ情報に使用される場合があります。
どうでしょうか。		（p1: ワークスペース）=>ブロック	（省略可）このブロックのコンポーネントをミューテータのダイアログに追加するオプションの関数。
破棄しますか？		() =>無効	（省略可）廃棄時に呼び出されるオプションのメソッド。
廃棄	`protected`	ブール値	現在のブロックは現在破棄中ですか？
domToMutation?		（p1：要素）=>無効	（省略可）XML からミューテーション状態をシリアル化解除する方法を定義するためのシリアル化解除メソッド（省略可）。これは、`mutationToDom` の定義と組み合わせる必要があります。
getDeveloperVariables?		() =>文字列 []	（省略可）デベロッパー変数を宣言するためのオプションのプロパティ。ジェネレータで使用する変数名のリストを返します。デベロッパー変数はユーザーには表示されませんが、生成されたコードではグローバル変数として宣言されます。
		文字列	（省略可）帽子の種類の名前。
helpUrl		文字列 \|機能 \|null	ブロックヘルプの文字列、または URL を返す関数。ヘルプなしの場合は Null です。
アイコン		IIcon[]
id		文字列
init?		() =>無効	（省略可）初期化中に呼び出されるオプションのメソッド。
inputList		入力[]
inputsInline?		ブール値	（省略可）
inputsInlineDefault?		ブール値	（省略可）
isInFlyout		ブール値
isInMutator		ブール値
isInsertionMarker_	`protected`	ブール値	このブロックが挿入マーカーの場合は true。
loadExtraState?		(p1: any) =>無効	（省略可）ブロックの追加状態（ミューテーション状態など）を JSON 互換の状態からシリアル化解除する方法を定義するためのシリアル化メソッド（省略可）。これは、`saveExtraState` の定義と組み合わせる必要があります。
mutationToDom?		(...p1: any[]) =>要素	（省略可）ミューテーション状態を XML にシリアル化する方法を定義するためのシリアル化メソッド（省略可）。これは、`domToMutation` の定義と組み合わせる必要があります。
nextConnection		つながり \|null
		((p1: 抽象) => void) \|null	（省略可）ブロックの親ワークスペースが変更されたときに使用するコールバックメソッド（省略可）。これは通常、コンストラクタ、ブロック型イニシャライザ関数、または拡張イニシャライザ関数からのみ呼び出されます。
outputConnection		つながり \|null
outputShape_	`protected`	数値 \|null
parentBlock_	`protected`	この \|null
previousConnection		つながり \|null
レンダリング	`readonly`	ブール値	このブロックは BlockSVG ですか？
RTL		ブール値
saveExtraState?		(doFullSerialization?: boolean) =>すべて	（省略可）ブロックの追加状態（ミューテーション状態など）を JSON 互換にシリアル化する方法を定義するためのシリアル化メソッド（省略可）。これは、`loadExtraState` の定義と組み合わせる必要があります。
styleName_	`protected`	文字列	ブロックスタイルの名前。
suppressPrefixSuffix		boolean \|null	生成されたコードへの STATEMENT_PREFIX と STATEMENT_SUFFIX の追加を抑制するためのオプションのプロパティ。
ツールチップ		Tooltip.TipInfo
type		文字列
ワークスペース		Google Workspace

メソッド

メソッド	修飾子	説明
addIcon(icon)		指定されたアイコンをブロックに追加します。
allInputsFilled(opt_shadowBlocksAreFilled)		すべてのステートメントと値の入力がブロックで満たされているかどうかを再帰的にチェックします。このスタック内の後続のステートメントブロックもすべてチェックします。
appendDummyInput(name)		ダミーの入力行を追加します。
appendEndRowInput(name)		行を終了する入力を追加します。
appendInput(input)		指定された入力行を追加します。カスタム入力をブロックに追加できます。
appendStatementInput(name)		ステートメント入力行を追加します。
appendValueInput(name)		値の入力行を追加します。
bumpNeighbours()		接続されていないブロックの位置をずれます。実際には接続されていない 2 つのブロックが画面上に偶然に並んではなりません。
dispose(healStack)		このブロックを破棄します。
disposeInternal()	`protected`	トップブロックで必要な処理を行わずに、このブロックを破棄します。例:イベントを発生させない、ブロックを外すなど。
doInit_()	`protected`	init() 関数を呼び出し、関連するイベントの呼び出しなどを処理します。
getChildren(ordered)		この内部に直接ネストされているブロックをすべて検索します。価値、主張、および次の文章が含まれます。出力タブまたは先行するステートメント上の接続は除外されます。ブロックは必要に応じて位置で並べ替えられます。表します。
getColour()		ブロックの色を取得する。
getCommentText()		このブロックのコメントを返します（コメントがない場合は null）。
getDescendants(ordered)		この内部に直接的または間接的にネストされているブロックをすべて検索します。このブロックをリストに追加します。価値、主張、および次の記述が含まれます。出力タブ上の接続またはそれ以前のステートメントはすべて除外されます。ブロックは必要に応じて位置で並べ替えられます。表します。
getDisabledReasons()		ブロックが現在無効になっている理由のセットを取得します（ある場合）。ブロックが有効になっている場合、このセットは空になります。
getField(name)		ブロックから名前付きフィールドを返します。
getFieldValue(name)		指定されたフィールドの言語に依存しない値を返します。
getHue()		ブロックの HSV 色相値を取得します。hue が設定されていない場合は null です。
getIcon(type)
getIcons()
getInheritedDisabled()		保護者が原因でブロックが無効になっているかどうかがわかります。ブロック自体の無効なプロパティは考慮されません。
getInput(name)		指定された入力オブジェクトを取得します。
getInputsInline()		値の入力が横方向と縦方向のどちらに配置されているかを取得します。
getInputTargetBlock(name)		指定された入力に接続されているブロックをフェッチします。
getInputWithBlock(block)		指定されたブロックに接続する入力を返します。
getNextBlock()		このブロックに直接接続されている次のステートメントブロックを返します。
getOutputShape()		ブロックの出力シェイプを取得します。
getParent()		親ブロックを返します。最上位ブロックの場合は null を返します。親ブロックは、前の接続に接続されたブロック（statement ブロックの場合）、または出力接続に接続されているブロック（value ブロックの場合）です。
getPreviousBlock()		前の接続に接続されているブロックを返します。
getRelativeToSurfaceXY()		描画サーフェスの原点（0,0）を基準とするこのブロックの左上隅の座標を、ワークスペース単位で返します。
getRootBlock()		このブロックのツリーの最上位ブロックを返します。このブロックが最上位にある場合、このメソッドは自身を返します。
getStyleName()		ブロックスタイルの名前を取得します。
getSurroundParent()		現在のブロックを囲む親ブロックを返します。周囲にブロックがない場合は null を返します。親ブロックが前のステートメントのみの場合もあれば、周囲のブロックが if ステートメントや while ループなどである場合もあります。
getTooltip()		このブロックのツールチップテキストを返します。
getVars()		このブロックが参照するすべての変数を返します。
hasDisabledReason(reason)		指定された理由でブロックが現在無効かどうかを取得します。
hasIcon(type)
initModel()		ブロックのすべてのフィールドで initModel を呼び出す。複数回呼び出される場合があります。initModel または initSvg は、ブロックを作成した後、かつ最初の操作を行う前に呼び出す必要があります。操作には、UI アクション（クリックやドラッグなど）やイベントの呼び出し（作成、削除、変更など）が含まれます。
isCollapsed()		ブロックが折りたたまれたかどうかを確認します。
isDeletable()		このブロックが削除可能かどうかを確認します。
isDisposed()		このブロックが廃棄または削除されたかどうかを返します。
isDuplicatable()		ブロックが複製可能かどうかを取得する。このブロックと子孫を複製すると、ワークスペースの容量を超えてこのブロックが複製される場合、このブロックは複製できません。このブロックおよび子孫が maxInstances を超える型を置く場合、このブロックは複製できません。
isEnabled()		このブロックが有効かどうかを取得します。ブロックが無効になる理由がない場合、そのブロックは有効とみなされます。ブロックが無効な場所にある場合など、ユーザーが手動で有効にしようとしても、他の理由でブロックが無効になることがあります。
isInsertionMarker()		このブロックが挿入マーカーブロックかどうかを取得します。
isOwnDeletable()		このブロック自身の削除可能プロパティが true または false かどうかを返します。
isOwnEditable()		このブロックの編集可能なプロパティが true または false かどうかを返します。
isShadow()		このブロックがシャドウブロックかどうかを取得します。
jsonInit(json)		クロスプラットフォームで、国際化に適した JSON 記述を使用して、このブロックを初期化します。
mixin(mixinObj, opt_disableCheck)		MixinObj の Key-Value をこのブロックオブジェクトに追加します。デフォルトでは、このメソッドにより、mixinObj 内のキーがブロック内の既存の値（プロトタイプ値を含む）を上書きしないかどうかがチェックされます。これにより、今後のブロック機能とのミックスイン / 拡張機能の非互換性に対する保証が提供されます。このチェックを無効にするには、2 番目の引数として true を渡します。
moveBy(dx, dy, reason)		相対オフセットでブロックを移動します。
moveInputBefore(name, refName)		名前付き入力をこのブロックの別の場所に移動します。
moveNumberedInputBefore(inputIndex, refIndex)		番号付きの入力をこのブロックの別の場所に移動します。
removeIcon(type)		getType が指定された iconType と一致するアイコンをブロックから削除します。
removeInput(name, opt_quiet)		このブロックから入力を削除します。
renameVarById(oldId, newId)		変数名の変更に関する通知。ID がこのブロックの変数のいずれかと一致する場合は、名前を変更します。
setCollapsed(collapsed)		ブロックを折りたたむかどうかを設定します。
setColour(colour)		ブロックの色を変更する。
setCommentText(text)		このブロックのコメントテキストを設定します。
setDeletable(deletable)		このブロックを削除できるかどうかを設定します。
setDisabledReason(disabled, reason)		ブロックが無効になる理由を追加または削除します。ブロックを無効にする理由がある場合、そのブロック自体も無効と見なされます。ブロックは、ユーザーが手動でブロックした、またはブロックが無効になったなど、複数の独立した理由で同時に無効になることがあります。
setEditable(editable)		このブロックを編集可能にするかどうかを設定します。
setEnabled(enabled)
setFieldValue(newValue, name)		このブロックの指定されたフィールドの値を設定します。
setHelpUrl(url)		このブロックのヘルプページの URL を設定します。
setInputsInline(newBoolean)		値の入力を横方向と縦方向のどちらに配置するかを設定します。
setMovable(movable)		このブロックを移動可能にするかどうかを設定します。
setMutator(_mutator)		このブロックにミューテータダイアログを設定します。
setNextStatement(newBoolean, opt_check)		他のブロックをこのブロックの下部に連結できるかどうかを設定します。
setOnChange(onchangeFn)		ブロックの親ワークスペースが変更されるたびに使用するコールバック関数を設定し、以前の onchange ハンドラを置き換えます。これは通常、コンストラクタ、ブロック型イニシャライザ関数、または拡張イニシャライザ関数からのみ呼び出されます。
setOutput(newBoolean, opt_check)		このブロックが値を返すかどうかを設定します。
setOutputShape(outputShape)		ブロックの出力シェイプを設定します。
setPreviousStatement(newBoolean, opt_check)		このブロックを別のブロックの下に連結できるかどうかを設定します。
setStyle(blockStyleName)		ブロックのスタイルと色の値を設定します。
setTooltip(newTip)		このブロックのツールチップを設定します。
setWarningText(_text, _opt_id)		このブロックの警告テキストを設定します。
toDevString()		このメソッドは、このブロックをデベロッパー用語で記述した文字列を返します（型名と ID、英語のみ）。コンソールのログとエラーで使用することを目的としています。ユーザーの母国語を使用する文字列（ブロックテキスト、フィールド値、子ブロックなど）が必要な場合は、[toString()] を使用します。
toString(opt_maxLength, opt_emptyToken)		このブロックとすべての子について、人が読める形式のテキスト表現を作成します。
unplug(opt_healStack)		このブロックを上位のブロックから取り外します。このブロックがステートメントの場合は、必要に応じて、下のブロックと一番上のブロックを再接続します。