Vous pouvez créer un espace de travail et l'injecter dans le DOM en un seul appel, ou simplement créer un espace de travail.
Injection
Vous pouvez créer un espace de travail Blockly et l'injecter dans le DOM en appelant Blockly.inject(location, options). Le premier argument indique à Blockly où injecter l'espace de travail dans le DOM. Le deuxième argument est un objet contenant des options de configuration.
Pour en savoir plus, consultez Créer un espace de travail.
Création directe
Vous pouvez créer un espace de travail directement en appelant new Blockly.WorkspaceSvg(new
Blockly.Options(options)). Lorsque vous effectuez cet appel, veillez à transmettre vos options de configuration dans un appel à new Blockly.Options(options). Le constructeur WorkspaceSvg ne peut pas accepter directement votre objet d'options de configuration.
Options de configuration
L'objet de configuration implémente Blockly.BlocklyOptions et comporte les options suivantes. 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 |
booléen | Indique si les menus contextuels des blocs incluent un élément permettant de réduire ou de développer les blocs. La valeur par défaut est true si la boîte à outils comporte des catégories, ou false dans le cas contraire. |
comments |
booléen | Indique si les menus contextuels des blocs incluent un élément permettant d'ajouter ou de supprimer des commentaires. La valeur par défaut est true si la boîte à outils comporte des catégories,false sinon. |
css |
booléen | Si la valeur est "false", n'injectez pas de CSS (la responsabilité de fournir le CSS incombe au document). La valeur par défaut est true. |
disable |
booléen | Indique si les menus contextuels des blocs incluent un élément permettant de désactiver ou d'activer les blocs. La valeur par défaut est true si la boîte à outils comporte des catégories, ou false dans le cas contraire. |
grid |
objet | Configure une grille à laquelle les blocs peuvent s'accrocher. 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 |
Total | 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 les 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. Exemple : maxInstances: {'controls_if': 3, 'math_number': 42} |
maxTrashcanContents |
Total | Nombre maximal d'éléments supprimés qui s'affichent dans le menu volant de la corbeille. '0' désactive la fonctionnalité. La valeur par défaut est '32'. |
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/'. Consultez Dossier multimédia. |
modalInputs |
booléen | Si true, les éditeurs modaux s'affichent pour les champs de saisie de texte et leurs sous-classes sur les appareils mobiles, et un éditeur intégré sur ordinateur. Si false, un éditeur intégré s'affiche sur ordinateur et sur mobile. La valeur par défaut est true. |
move |
objet | Configure le comportement des utilisateurs lorsqu'ils se déplacent dans l'espace de travail. Consultez Déplacer. |
oneBasedIndex |
booléen | Si les opérations de liste et de chaîne true doivent indexer à partir de 1, si false indexer à partir de 0. La valeur par défaut est true. |
plugins |
objet | Objet qui mappe les noms de types d'enregistrement aux classes de remplacement ou aux noms enregistrés des classes de remplacement. Consultez Injecter votre classe de remplacement. |
readOnly |
booléen | Si true, empêchez l'utilisateur de modifier le fichier. Supprime la boîte à outils et la corbeille. La valeur par défaut est false. Voir également setIsReadOnly et isReadOnly. |
renderer |
chaîne | Détermine le moteur de rendu utilisé par Blockly. Les moteurs de rendu prépackagés incluent 'geras' (par défaut), 'thrasos' et 'zelos' (un moteur de rendu de type Scratch). Pour en savoir plus sur les renderers personnalisés, consultez Créer des renderers personnalisés. |
rtl |
booléen | Si la valeur est true, mettez en miroir l'éditeur (pour les paramètres régionaux en arabe ou en hébreu). Consultez la démonstration RTL. La valeur par défaut est false. |
scrollbars |
objet ou valeur booléenne | Définit si l'espace de travail comporte des barres de défilement verticales ou horizontales. Accepte un objet dont 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 Définir la boîte à outils. |
toolboxPosition |
chaîne | Si la boîte à outils 'start' se trouve en haut (si elle est horizontale) ou à 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, ou false dans le cas contraire. |
zoom |
objet | Configure le comportement du zoom. Consultez Zoom. |