封鎖留言

使用者可透過區塊註解,在區塊中新增註解。就像文字式程式語言中的註解一樣,這些註解不會影響區塊的行為。標準語言程式碼產生器會將這些屬性加入產生的程式碼 (包括自訂區塊產生的程式碼)。

帶有註解的 if 區塊

附註圖示

使用者可透過留言圖示的文字編輯器輸入區塊留言。

根據預設,系統不會顯示留言圖示。顯示方式有兩種:

  • 使用非空值字串呼叫 Block.setCommentText
  • 讓使用者在區塊的內容選單中按一下「新增註解」即可顯示註解。

如要移除留言圖示,請按照下列步驟操作:

  • 使用 null 呼叫 Block.setCommentText
  • 讓使用者在區塊的內容選單中按一下「移除留言」即可移除。

請注意,「新增註解」和「移除註解」只會在下列情況下顯示在內容選單中:

  • 這個區塊可編輯
  • 區塊未收合。
  • comments 設定選項已設為 true。如果您未明確設定這個選項,如果工具箱有類別,則預設為 true;否則為 false

透過程式碼使用區塊註解

如要取得區塊註解:

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

如要設定區塊註解:

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

如何刪除區塊註解:

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

以程式輔助方式處理註解的能力不會受到區塊狀態 (例如是否可編輯或已摺疊) 或 comments 設定選項的影響。