Bloccare i commenti

I commenti bloccati consentono agli utenti di aggiungere commenti a un blocco. Come i commenti in un linguaggio di programmazione basato su testo, non influiscono sul comportamento di un blocco. Vengono aggiunti al codice generato (incluso il codice generato dai blocchi personalizzati) dai generatori di codice in linguaggio standard.

Un blocco if con un commento

L'icona del commento

Gli utenti inseriscono i commenti bloccati con l'editor di testo dell'icona dei commenti.

Per impostazione predefinita, l'icona del commento non viene visualizzata. Esistono due modi per visualizzarlo:

  • Chiama Block.setCommentText con una stringa non null.
  • Consenti all'utente di visualizzarlo facendo clic su"Aggiungi commento" nel menu contestuale del blocco.

Per rimuovere l'icona del commento:

  • Chiama Block.setCommentText con un null.
  • Consenti all'utente di rimuoverlo facendo clic su"Rimuovi commento" nel menu contestuale del blocco.

Tieni presente che "Aggiungi commento" e "Rimuovi commento" vengono visualizzati nel menu contestuale solo se:

  • Il blocco sia modificabile.
  • Il blocco non è compresso.
  • L'opzione di configurazione comments è impostata su true. Se non imposti esplicitamente questa opzione, il valore predefinito è true se la cassetta degli attrezzi ha categorie, false in caso contrario.

Utilizzare i commenti blocco in modo programmatico

Per inserire un commento blocco:

// Returns comment text or null if there is no comment.
myBlock.getCommentText();

Per impostare un commento blocco:

// Sets comment text and displays comment icon.
myBlock.setCommentText('My comment');

Per eliminare un commento blocco:

// Removes comment text and removes comment icon.
myBlock.setCommentText(null);

La possibilità di lavorare con i commenti in modo programmatico non è influenzata dallo stato del blocco (ad esempio se è modificabile o compresso) o dall'impostazione dell'opzione di configurazione comments.