インジェクション
Blockly.inject(location, options)
の呼び出しを使用して、Blockly ワークスペースを挿入できます。最初の引数は 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 になります。 |
media
|
文字列 | ページ(またはフレーム)から Blockly メディア ディレクトリへのパス。
デフォルトは "https://blockly-demo.appspot.com/static/media/" です。 |
move
|
オブジェクト | ユーザーがワークスペース内を移動する方法を設定します。移動をご覧ください。 |
oneBasedIndex
|
ブール値 | true のリスト操作と文字列オペレーションが 1 からインデックスする必要がある場合、false は 0 からインデックスを作成します。デフォルトは true です。 |
readOnly
|
ブール値 | true の場合、ユーザーが編集できないようにします。ツールボックスとごみ箱を非表示にします。デフォルトは false です。 |
renderer
|
文字列 | Blockly で使用されるレンダラを指定します。事前にパッケージ化されたレンダラには、「geras」(デフォルト)、「thrasos」、「zelos」(スクラッチのようなレンダラ)があります。 |
rtl
|
ブール値 | true の場合、エディタをミラーリングします(アラビア語またはヘブライ語の言語 / 地域向け)。
RTL のデモをご覧ください。デフォルトでは false に設定されます。 |
scrollbars
|
オブジェクトまたは ブール値 | ワークスペースに垂直スクロールバーと水平スクロールバーのどちらを使用するかを設定します。水平方向のスクロールが有効かどうかを horizontal プロパティによって判断し、垂直スクロールが有効かどうかを vertical プロパティによって判断するオブジェクトを取得します。ブール値が渡された場合は、horizontal プロパティと vertical プロパティの両方をその値として設定したオブジェクトを渡すのと同じ結果になります。ツールボックスにカテゴリがある場合、デフォルトは true です。 |
sounds |
boolean | false の場合、サウンドを無効にします。デフォルトは true です。 |
theme
|
テーマ | テーマが指定されていない場合、デフォルトはクラシック テーマになります。 テーマをご覧ください。 |
toolbox
|
文字列、XML、JSON | ユーザーが利用できるカテゴリとブロックのツリー構造。詳細については、ツールボックスの定義をご覧ください。 |
toolboxPosition
|
文字列 | "start" ツールボックスが上部(水平の場合)、左側(垂直と LTR の場合)、または右側(垂直と RTL の場合)の場合。"end" ツールボックスが反対側にある場合は、デフォルトでは "start" に設定されます。 |
trashcan
|
ブール値 | ゴミ箱の表示と非表示を切り替えます。ツールボックスにカテゴリがある場合はデフォルトで true 、それ以外の場合は false になります。 |
maxTrashcanContents
|
数値 | ゴミ箱フライアウトに表示される削除済みアイテムの最大数。「0」は機能を無効にします。デフォルトは「32」です。 |
plugins
|
オブジェクト | プラグイン タイプと登録済みのプラグインまたはプラグイン クラスの名前のマッピング。サブクラスの挿入をご覧ください。 |
zoom |
オブジェクト | ズーム動作を設定します。Zoom をご覧ください。 |