Source: Scratch Wiki en français


Les commentaires de l'Éditeur



Attention
 Attention :
Ne doit pas être confondu avec Commentaires (site), les commentaires sur les projets, profils et studios.


Les commentaires dans l'éditeur sont des boîtes de texte de taille ajustables qui peuvent être attachées aux blocs de code ou être laissées flottantes.

Les commentaires peuvent être ajustés horizontalement et verticalement pour mettre le texte en page le mieux possible.

Il est possible de créer, supprimer et modifier des commentaires.

Histoire

Les commentaires ont été introduits dans la beta de la version 1.2 de Scratch. Ils pouvaient se placer comme commentaire entre les blocs, mais n'avaient aucun effet, car ils ne contenaient que du texte.

Ils furent donc d'abord présents sous forme de blocs, retirés peu après pour la version 1.2 (officielle) car ils portaient à confusion puis à nouveau remis et changés à partir de la version 1.3 pour rester sous la forme que nous connaissons maintenant.

Image montrant comment créer un commentaire, avec un clic droit sur un bloc.
Pendant le clic droit
Rendu d'un commentaire lié à un bloc, ici de mouvement.
Rendu du commentaire

Avec la mise à jour des Changements d'accessibilité du 28 Juin 2023, les commentaires ont un aspect désormais légèrement différent en mode contraste élevé.

Rendu d'un commentaire lié à un bloc, ici de mouvement, avec le Mode de couleur « Contraste élevé ».
Rendu du commentaire en contraste élevé.

Ajouter un commentaire

Flottant

Pour insérer un commentaire flottant (qui n'est rattaché à aucun bloc) dans l'éditeur scratch, il suffit de faire un clic droit (ou d'appuyer sur la touche majuscule) sur l'endroit ou la sélection que l'on veut commenter.

Ensuite, il faut cliquer sur « Ajouter un commentaire » comme précisé sur l'image du haut.

À un bloc

On peut aussi ajouter un commentaire sur un bloc spécifique.

Faites un clic-droit sur le bloc à commenter et cliquez sur « Ajouter un commentaire ».

Attention
 Attention :
Les commentaires ont une limite de 8000 caractères.

Ajuster la forme et la taille

Les commentaires ont 2 formes :

  • la dépliée, par défaut ;
  • la repliée, où le commentaire est réduit à son en-tête.


Deux commentaires repliés : en haut, mode de couleur original, en bas, contraste élevé.
Les commentaires repliés. En haut, mode de couleur original, en bas, contraste élevé.

Il est donc possible de replier le commentaire pour qu'il prenne moins de place.

Pour cela, il faut cliquer sur la flèche noire en haut à gauche de la zone de commentaire pointant vers le bas. Pour le déplier, il faut appuyer à nouveau sur le flèche pointant vers le haut.

On peut aussi ajuster leur largeur/hauteur en maintenant enfoncé et en glissant le bord inférieur droit du commentaire, le forçant à changer la disposition du texte. Cela est pratique quand il n'y a pas beaucoup d'explications à mettre, ou au contraire, quand on veut, par exemple, créer une documentation de son projet.

Déplacer un commentaire

Pour déplacer un commentaire, maintenez un clic sur la partie supérieure du commentaire et déplacez votre souris, tout en maintenant votre clic.

Supprimer un commentaire

Pour supprimer un commentaire, faites un clic-droit dessus et cliquez sur « Supprimer le commentaire ».

Idée
 Idée :
Il est aussi possible d'utiliser la croix en haut à droite du commentaire.

Utilité

Ajouter un commentaire sert à expliquer, détailler, informer, … sur un bloc ou sur le projet lui-même.

Vous pouvez faire des commentaires attachés au bloc (comme sur la seconde image) ou des commentaires flottants. Vous pouvez également déplacer les commentaires.


Info
 Info :
Un commentaire ne peut être lu que lorsque l'on est à l'intérieur du projet, il faut donc appuyer sur "voir à l'intérieur" pour voir un commentaire se trouvant dans l'éditeur. Et seul le créateur du projet peut ajouter des commentaires dans son projet.
Idée
 Idée :
Utiliser les commentaires pour détailler comment un projet a été réalisé ou ce qu'il reste à faire dans le projet peut être une très bonne idée.
LeSaviezVous
 LeSaviezVous :
Les commentaires, dans Scratch 1.2 ainsi que dans les versions antérieures, étaient des blocs.

Forum Scratch

Dans le Forum Scratch, vous pouvez intégrer des blocs Scratch grâce au BBCode. Saviez-vous que vous pouviez ajouter un commentaire dessus ? Voici le code nécessaire :

[scratchblocks] avancer de (10) pas // commentaire [/scratchblocks]
Ce qui donnera :

avancer de (10) pas // commentaire

Voir aussi