ความช่วยเหลือเกี่ยวกับการบล็อก

คุณสามารถให้ความช่วยเหลือเกี่ยวกับบล็อกในรูปแบบเคล็ดลับเครื่องมือและ URL ความช่วยเหลือ

เคล็ดลับเครื่องมือ

เคล็ดลับเครื่องมือจะให้ความช่วยเหลือทันทีเมื่อผู้ใช้วางเมาส์เหนือบล็อก หากข้อความยาว ระบบจะตัดข้อความให้โดยอัตโนมัติ

JSON

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

JavaScript

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

ใน JavaScript API คุณสามารถกําหนดเคล็ดลับเครื่องมือเป็นฟังก์ชันแทนสตริงแบบคงที่ได้ด้วย ซึ่งช่วยให้ได้รับความช่วยเหลือแบบไดนามิก ดูตัวอย่างเคล็ดลับเครื่องมือที่เปลี่ยนแปลงตามตัวเลือกเมนูแบบเลื่อนลงที่เลือกได้ที่ math_arithmetic

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];
    });
  }
};

เมื่อใช้ JavaScript API บล็อกจะระบุฟังก์ชันแทนสตริงแบบคงที่ซึ่งแสดงสตริงเคล็ดลับเครื่องมือได้ ซึ่งช่วยให้มีเคล็ดลับเครื่องมือแบบไดนามิก ดูตัวอย่างได้ที่ math_arithmetic

ปรับแต่งเฉพาะคน

นอกจากนี้ คุณยังปรับแต่งลักษณะของเคล็ดลับเครื่องมือได้ด้วยโดยระบุฟังก์ชันการแสดงผลที่กำหนดเอง สร้างฟังก์ชันที่รับพารามิเตอร์ 2 รายการ ดังนี้

• องค์ประกอบแรกคือองค์ประกอบ <div> ที่คุณจะใช้แสดงผลเนื้อหา
• ประการที่ 2 คือองค์ประกอบจริงที่ผู้ใช้วางเมาส์เหนือและคุณจะต้องแสดงเคล็ดลับเครื่องมือ

ในเนื้อหาของฟังก์ชัน คุณสามารถแสดงผลเนื้อหาที่ต้องการใน div ได้ หากต้องการรับสตริงเคล็ดลับเครื่องมือที่กําหนดไว้ในบล็อกที่วางเมาส์เหนือ คุณสามารถเรียกใช้ Blockly.Tooltip.getTooltipOfObject(element); โดยที่ element คือพารามิเตอร์ที่ 2 ด้านบน

สุดท้าย ให้ลงทะเบียนฟังก์ชันนี้เพื่อให้ Blockly เรียกใช้ในเวลาที่เหมาะสม

Blockly.Tooltip.setCustomTooltip(yourFnHere);

ดูตัวอย่างได้ที่เดโมเคล็ดลับเครื่องมือที่กําหนดเอง

URL ความช่วยเหลือ

บล็อกอาจมีหน้าความช่วยเหลือที่เชื่อมโยงอยู่ด้วย ผู้ใช้สามารถดูข้อมูลนี้ได้โดยคลิกขวาที่บล็อกแล้วเลือก "ความช่วยเหลือ" จากเมนูตามบริบท หากค่านี้คือ null ระบบจะไม่แสดงรายการ "ความช่วยเหลือ"

JSON

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

JavaScript

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

เมื่อใช้ JavaScript API บล็อกจะระบุฟังก์ชันแทนสตริงแบบคงที่ ซึ่งจะแสดงผลสตริง URL จึงช่วยให้ความช่วยเหลือแบบไดนามิกได้