Chặn bình luận

Tính năng bình luận về khối cho phép người dùng thêm bình luận vào một khối. Giống như các chú thích trong ngôn ngữ lập trình dựa trên văn bản, các chú thích này không ảnh hưởng đến hành vi của một khối. Các biến này được thêm vào mã được tạo (bao gồm cả mã do các khối tuỳ chỉnh tạo) bằng trình tạo mã ngôn ngữ chuẩn.

Một khối if có nhận xét

Biểu tượng nhận xét

Người dùng nhập các nhận xét chặn bằng trình chỉnh sửa văn bản của biểu tượng nhận xét.

Theo mặc định, biểu tượng bình luận sẽ không xuất hiện. Có hai cách để hiển thị thông báo:

  • Gọi Block.setCommentText bằng một chuỗi không rỗng.
  • Cho phép người dùng hiển thị nhận xét bằng cách nhấp vào "Thêm nhận xét" trong trình đơn theo ngữ cảnh của khối.

Cách xoá biểu tượng bình luận:

  • Gọi Block.setCommentText bằng null.
  • Cho phép người dùng xoá bằng cách nhấp vào "Xoá nhận xét" trong trình đơn theo ngữ cảnh của khối.

Xin lưu ý rằng mục "Thêm nhận xét" và "Xoá nhận xét" chỉ xuất hiện trong trình đơn theo bối cảnh nếu:

  • Khối này có thể chỉnh sửa.
  • Khối này không bị thu gọn.
  • Tuỳ chọn cấu hình comments được đặt thành true. Nếu bạn không đặt tuỳ chọn này một cách rõ ràng, tuỳ chọn này sẽ mặc định là true nếu hộp công cụ có các danh mục, nếu không thì sẽ là false.

Xử lý nhận xét chặn theo phương thức lập trình

Cách nhận nhận xét chặn:

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

Cách đặt nhận xét khối:

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

Cách xoá một nhận xét khối:

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

Khả năng xử lý các nhận xét theo phương thức lập trình không bị ảnh hưởng bởi trạng thái của khối (chẳng hạn như liệu khối đó có thể chỉnh sửa hay bị thu gọn) hoặc chế độ cài đặt của tuỳ chọn cấu hình comments.