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