Options d'injection

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 brut.

Dictionnaire des options

Les options suivantes sont acceptées. Notez que plusieurs de ces options changent de valeur par défaut selon que la boîte à outils fournie comporte des catégories ou non.

Nom	Type	Description
collapse	booléen	Permet de réduire ou de développer des blocs. La valeur par défaut est true si la boîte à outils comporte des catégories, false dans le cas contraire.
comments	booléen	Permet d'ajouter des commentaires aux blocs. La valeur par défaut est true si la boîte à outils comporte des catégories,false dans le cas contraire.
css	booléen	Si la valeur est "false", n'injectez pas de CSS (la fourniture de CSS devient la responsabilité du document). La valeur par défaut est true.
disable	booléen	Permet de désactiver les blocs. La valeur par défaut est true si la boîte à outils comporte des catégories, false dans le cas contraire.
grid	objet	Configure une grille à laquelle les blocs peuvent s'ancrer. Voir Grille.
horizontalLayout	booléen	Si la boîte à outils true est horizontale, si la boîte à outils false est verticale. La valeur par défaut est false.
maxBlocks	Nombre	Nombre maximal de blocs pouvant être créés. Utile pour les exercices des élèves. La valeur par défaut est Infinity.
maxInstances	objet	Mappage des types de blocs sur le nombre maximal de blocs de ce type pouvant être créés. Les types non déclarés sont par défaut Infinity. Exemple : maxInstances: {'controls_if': 3, 'math_number': 42}
media	chaîne	Chemin d'accès de la page (ou du frame) au 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 dans l'espace de travail. Consultez la section Déplacer.
oneBasedIndex	booléen	Si les opérations de liste et de chaîne true doivent être indexées à partir de 1, si l'index false est à partir de 0. La valeur par défaut est true.
readOnly	booléen	Si true, empêchez l'utilisateur de modifier le contenu. 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éemballés incluent "geras" (par défaut), "thrasos" et "zelos" (un moteur de rendu semblable à Scratch).
rtl	booléen	Si la valeur est true, l'éditeur est mis en miroir (pour les paramètres régionaux arabe ou hébreu). Consultez la démo RTL. La valeur par défaut est false.
scrollbars	objet ou booléen	Définit si l'espace de travail comporte des barres de défilement verticales ou horizontales. Prend un objet où 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é. Si une valeur booléenne est transmise, cela équivaut à transmettre un objet dont les propriétés horizontal et vertical sont définies sur cette valeur. La valeur par défaut est true si la boîte à outils comporte des catégories.
sounds	booléen	Si la valeur est false, les sons sont désactivés. 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	Structure arborescente des catégories et des blocs disponibles pour l'utilisateur. Pour en savoir plus, consultez la section Définir la boîte à outils.
toolboxPosition	chaîne	Si la boîte à outils "start" se trouve en haut (si elle est horizontale), à gauche (si elle est verticale et LTR) ou à droite (si elle est verticale et RTL). Si la boîte à outils "end" se trouve de l'autre côté. La valeur par défaut est "start".
trashcan	booléen	Affiche ou masque la corbeille. La valeur par défaut est true si la boîte à outils comporte des catégories, false dans le cas contraire.
maxTrashcanContents	Nombre	Nombre maximal d'éléments supprimés qui s'affichent dans le pop-up de la corbeille. La valeur "0" désactive la fonctionnalité. La valeur par défaut est "32".
plugins	objet	Mappage du type de plug-in sur le nom du plug-in ou de la classe de plug-in enregistrés. Consultez la section Injecter des sous-classes.
zoom	objet	Configure le comportement de zoom. Voir Zoom.