Injection
Vous pouvez injecter un espace de travail Blockly avec un appel à Blockly.inject(location, options). Le premier argument indique à Blockly où injecter l'espace de travail dans le DOM. Le deuxième argument est un dictionnaire de paires nom-valeur utilisé pour la configuration. Le code d'injection analyse le dictionnaire d'options dans une instance de Blockly.Options.
Création directe
Vous pouvez également créer un espace de travail directement en appelant Blockly.WorkspaceSvg(new Blockly.Options(options)). Notez que vous devez appeler new Blockly.Options(options) en transmettant votre dictionnaire d'options. Le constructeur de l'espace de travail attend une instance de Blockly.Options, et non un dictionnaire d'options nu.
Dictionnaire d'options
Les options suivantes sont prises en charge. Notez que plusieurs de ces options modifient leur valeur par défaut selon que la boîte à outils fournie comporte des catégories ou non.
| Nom | Type | Description |
|---|---|---|
collapse
|
boolean | Permet de réduire ou de développer les blocs. La valeur par défaut est true si la boîte à outils contient des catégories, false dans le cas contraire. |
comments
|
boolean | Autorise l'ajout de commentaires aux blocs. La valeur par défaut est true si la boîte à outils contient des catégories,et false dans le cas contraire. |
css
|
boolean | Si la valeur est "false", n'injectez pas le code CSS (la fourniture du CSS devient la responsabilité du document). La valeur par défaut est true. |
disable
|
boolean | Permet de désactiver les blocages. La valeur par défaut est true si la boîte à outils contient des catégories, et false dans le cas contraire. |
grid |
objet | Configure une grille sur laquelle les blocs peuvent s'ancrer. Voir Grille. |
horizontalLayout
|
boolean | Si la boîte à outils true est horizontale, si la boîte à outils false est verticale. La valeur par défaut est false. |
maxBlocks
|
number | Nombre maximal de blocs pouvant être créés. Utile pour les
exercices des élèves. La valeur par défaut est Infinity. |
maxInstances
|
objet | Mappez des types de blocs au nombre maximal de blocs de ce type pouvant être créés. Les types non déclarés sont définis par défaut sur Infinity. |
media
|
chaîne | Chemin d'accès depuis la page (ou le frame) vers le répertoire multimédia Blockly.
La valeur par défaut est "https://blockly-demo.appspot.com/static/media/". |
move
|
objet | Configure le comportement des utilisateurs qui peuvent se déplacer dans l'espace de travail. Consultez Déplacer. |
oneBasedIndex
|
boolean | Si les opérations de liste et de chaîne true doivent être indexées à partir de 1, si l'index est false à partir de 0. La valeur par défaut est true. |
readOnly
|
boolean | Si la valeur est true, l'utilisateur ne peut pas apporter de modifications. Supprime la boîte à outils et la corbeille. La valeur par défaut est false. |
renderer
|
chaîne | Détermine le moteur de rendu utilisé par blockly. Les moteurs de rendu pré-empaquetés incluent "geras" (par défaut), "thrasos" et "zelos" (un moteur de rendu semblable à une rayure). |
rtl
|
boolean | Si la valeur est true, dupliquez l'éditeur (pour les paramètres régionaux en arabe ou en hébreu).
Consultez la démonstration de droite à gauche. La valeur par défaut est false. |
scrollbars
|
objet ou booléen | Détermine si l'espace de travail comporte des barres de défilement verticales ou horizontales. Utilise un objet dans lequel la propriété horizontal détermine si le défilement horizontal est activé et la propriété vertical détermine si le défilement vertical est activé. La transmission d'une valeur booléenne équivaut à transmettre un objet dont les propriétés horizontal et vertical sont toutes deux définies comme valeur. La valeur par défaut est true si la boîte à outils contient des catégories. |
sounds |
boolean | Si la valeur est false, désactive les sons. La valeur par défaut est true. |
theme
|
Thème | Si aucun thème n'est fourni, le thème classique est utilisé par défaut. Consultez Thèmes. |
toolbox
|
chaîne, XML ou JSON | Arborescence des catégories et des blocs disponibles pour l'utilisateur. Pour en savoir plus, consultez Définir la boîte à outils. |
toolboxPosition
|
chaîne | Si la boîte à outils "start" est en haut (si verticale) ou à gauche (si verticale et LTR) ou à droite (si verticale et RTL). Si la boîte à outils "end" se trouve de l'autre côté. La valeur par défaut est "start". |
trashcan
|
boolean | Affiche ou masque la corbeille. La valeur par défaut est true si la boîte à outils contient des catégories, et false dans le cas contraire. |
maxTrashcanContents
|
number | Nombre maximal d'éléments supprimés qui apparaîtront dans la corbeille. "0" désactive la fonctionnalité. La valeur par défaut est "32". |
plugins
|
objet | Mappage du type de plug-in au nom de la classe du plug-in ou du plug-in enregistré. Consultez la section Injecter des sous-classes. |
zoom |
objet | Configure le comportement de zoom. Consultez Zoom. |