Trợ giúp về tính năng chặn

Bạn có thể cung cấp thông tin trợ giúp về việc chặn dưới dạng chú giải công cụ và URL trợ giúp.

Chú thích

Chú giải công cụ cung cấp trợ giúp tức thì khi người dùng di chuột qua khối. Nếu văn bản dài, văn bản đó sẽ tự động xuống dòng.

JSON

{
  // ...,
  "tooltip": "Tooltip text."
}

JavaScript

init: function() {
  this.setTooltip("Tooltip text.");
}

Trong API JavaScript, chú giải công cụ cũng có thể được xác định là một hàm thay vì một chuỗi tĩnh. Điều này cho phép trợ giúp động. Hãy xem math_arithmetic để biết ví dụ về chú giải công cụ thay đổi tuỳ thuộc vào tuỳ chọn trình đơn thả xuống đã được chọn.

JavaScript

Blockly.Blocks['math_arithmetic'] = {
  init: function() {
    // ...

    // Assign 'this' to a variable for use in the tooltip closure below.
    var thisBlock = this;
    this.setTooltip(function() {
      var mode = thisBlock.getFieldValue('OP');
      var TOOLTIPS = {
        'ADD': Blockly.Msg['MATH_ARITHMETIC_TOOLTIP_ADD'],
        'MINUS': Blockly.Msg['MATH_ARITHMETIC_TOOLTIP_MINUS'],
        'MULTIPLY': Blockly.Msg['MATH_ARITHMETIC_TOOLTIP_MULTIPLY'],
        'DIVIDE': Blockly.Msg['MATH_ARITHMETIC_TOOLTIP_DIVIDE'],
        'POWER': Blockly.Msg['MATH_ARITHMETIC_TOOLTIP_POWER']
      };
      return TOOLTIPS[mode];
    });
  }
};

Khi sử dụng API JavaScript, các khối có thể chỉ định một hàm thay vì một chuỗi tĩnh để trả về chuỗi chú giải công cụ. Điều này cho phép tạo chú giải công cụ động. Hãy xem math_arithmetic để biết ví dụ.

Tùy chỉnh theo yêu cầu

Bạn cũng có thể tuỳ chỉnh giao diện của chú giải công cụ bằng cách cung cấp một hàm kết xuất tuỳ chỉnh. Tạo một hàm chấp nhận hai tham số:

• trước tiên, một phần tử <div> nơi bạn sẽ hiển thị nội dung
• thứ hai, thành phần thực tế đang được di chuột qua và bạn sẽ hiển thị chú giải công cụ cho thành phần đó

Trong phần nội dung của hàm, bạn có thể hiển thị bất kỳ nội dung nào bạn muốn vào div. Để lấy chuỗi chú giải công cụ được xác định trên khối đang di chuột qua, bạn có thể gọi Blockly.Tooltip.getTooltipOfObject(element);, trong đó element là tham số thứ hai ở trên.

Cuối cùng, hãy đăng ký hàm này để Blockly có thể gọi hàm này vào thời điểm thích hợp:

Blockly.Tooltip.setCustomTooltip(yourFnHere);

Để biết ví dụ, hãy xem Bản minh hoạ về chú giải công cụ tuỳ chỉnh.

URL trợ giúp

Các khối có thể có trang trợ giúp liên kết với chúng. Người dùng có thể sử dụng tính năng này bằng cách nhấp chuột phải vào khối và chọn "Trợ giúp" trong trình đơn theo bối cảnh. Nếu giá trị này là null, thì mục "Trợ giúp" sẽ không hiển thị.

JSON

{
  // ...,
  "helpUrl": "https://en.wikipedia.org/wiki/For_loop"
}

JavaScript

init: function() {
  // ...
  this.setHelpUrl('https://en.wikipedia.org/wiki/For_loop');
}

Khi sử dụng API JavaScript, các khối có thể chỉ định một hàm thay vì một chuỗi tĩnh để trả về một chuỗi URL, nhờ đó cho phép trợ giúp động.