インジェクション
Blockly ワークスペースは、Blockly.inject(location, options) を呼び出して挿入できます。最初の引数は、DOM のどこにワークスペースを挿入するかを Blockly に指示します。2 番目の引数は、構成に使用される名前と値のペアの辞書です。挿入コードは、オプション ディクショナリを解析して Blockly.Options のインスタンスに変換します。
直接作成
Blockly.WorkspaceSvg(new Blockly.Options(options)) を呼び出してワークスペースを直接作成することもできます。オプション辞書を渡して new Blockly.Options(options) を呼び出す必要があります。ワークスペース コンストラクタは、単なるオプション辞書ではなく、Blockly.Options のインスタンスを想定しています。
オプション辞書
次のオプションがサポートされています。これらのオプションのいくつかは、指定されたツールボックスにカテゴリがあるかどうかに応じてデフォルト値が変更されます。
| 名前 | 型 | 説明 |
|---|---|---|
collapse
|
boolean | ブロックを閉じたり開いたりできます。ツールボックスにカテゴリがある場合は true、それ以外の場合は false がデフォルトです。 |
comments
|
boolean | ブロックにコメントを追加できます。ツールボックスにカテゴリがある場合は true、それ以外の場合は false がデフォルトです。 |
css
|
boolean | false の場合、CSS を挿入しません（CSS の提供はドキュメントの責任となります）。デフォルトは true です。 |
disable
|
boolean | ブロックを無効にできます。ツールボックスにカテゴリがある場合は true、それ以外の場合は false がデフォルトです。 |
grid |
オブジェクト | ブロックがスナップできるグリッドを設定します。グリッドをご覧ください。 |
horizontalLayout
|
boolean | true ツールボックスが横向きの場合、false ツールボックスが縦向きの場合。デフォルト値は false です。 |
maxBlocks
|
数値 | 作成できるブロックの最大数。生徒の演習に役立ちます。デフォルトは Infinity です。 |
maxInstances
|
オブジェクト | ブロックタイプから、作成できるそのタイプのブロックの最大数にマッピングします。宣言されていない型はデフォルトで Infinity になります。例: maxInstances: {'controls_if': 3, 'math_number': 42} |
media
|
文字列 | ページ（またはフレーム）から Blockly メディア ディレクトリへのパス。デフォルトは "https://blockly-demo.appspot.com/static/media/" です。 |
move
|
オブジェクト | ユーザーがワークスペースを移動する方法の動作を構成します。移動をご覧ください。 |
oneBasedIndex
|
boolean | true リストと文字列オペレーションが 1 からインデックスを付ける場合、false が 0 からインデックスを付ける場合。デフォルトは true です。 |
readOnly
|
boolean | true の場合、ユーザーが編集できないようにします。ツールボックスとゴミ箱を非表示にします。デフォルトは false です。 |
renderer
|
文字列 | blockly で使用されるレンダラを決定します。事前パッケージ化されたレンダラには、「geras」（デフォルト）、「thrasos」、「zelos」（スクラッチのようなレンダラ）があります。 |
rtl
|
boolean | true の場合は、エディタをミラーリングします（アラビア語またはヘブライ語のロケールの場合）。RTL デモをご覧ください。デフォルト値は false です。 |
scrollbars
|
オブジェクトまたはブール値 | ワークスペースに垂直スクロールバーと水平スクロールバーのどちらを表示するかを設定します。オブジェクトを受け取ります。horizontal プロパティは水平スクロールが有効かどうかを決定し、vertical プロパティは垂直スクロールが有効かどうかを決定します。ブール値が渡された場合、それは horizontal プロパティと vertical プロパティの両方がその値として設定されたオブジェクトを渡すことと同じです。ツールボックスにカテゴリがある場合のデフォルトは true です。 |
sounds |
ブール値 | false の場合、音声を無効にします。デフォルトは true です。 |
theme
|
テーマ | テーマが指定されていない場合のデフォルトはクラシック テーマです。テーマをご覧ください。 |
toolbox
|
文字列、XML、JSON | ユーザーが使用できるカテゴリとブロックのツリー構造。詳細については、ツールボックスの定義をご覧ください。 |
toolboxPosition
|
文字列 | "start" ツールボックスが上（水平の場合）、左（垂直で LTR の場合）、右（垂直で RTL の場合）にあるかどうか。"end" ツールボックスが反対側にある場合。デフォルト値は "start" です。 |
trashcan
|
boolean | ゴミ箱を表示または非表示にします。ツールボックスにカテゴリがある場合は true、それ以外の場合は false がデフォルトです。 |
maxTrashcanContents
|
数値 | ゴミ箱のフライアウトに表示される削除済みアイテムの最大数。0 にすると、この機能は無効になります。デフォルトは 32 です。 |
plugins
|
オブジェクト | プラグイン タイプと、登録済みのプラグインまたはプラグイン クラスの名前のマップ。サブクラスの挿入をご覧ください。 |
zoom |
オブジェクト | ズーム動作を構成します。ズームをご覧ください。 |