المساعدة بشأن الحظر

يمكنك تقديم مساعدة بشأن الحظر في شكل نصائح وعنوان 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، يمكن للوحدات تحديد دالة بدلاً من سلسلة static التي تُعيد سلسلة التلميح. يتيح ذلك عرض نصائح ديناميكية. يمكنك الاطّلاع على math_arithmetic مثلاً.

تخصيص

يمكنك أيضًا تخصيص مظهر نصائح التلميح من خلال توفير دالة معالجة مخصّصة. أنشئ دالة تقبل مَعلمتَين:

• أولاً، عنصر <div> الذي سيتم عرض المحتوى عليه
• ثانيًا، العنصر الفعلي الذي يتم تمرير مؤشر الماوس فوقه والذي سيتم عرض معلومات التلميح له

في نص الدالة، يمكنك عرض أي محتوى تريده في العنصر DIV. للحصول على سلسلة التلميح الموضّح المحدّدة في الكتلة التي يتم تمرير مؤشر الماوس فوقها، يمكنك استدعاء Blockly.Tooltip.getTooltipOfObject(element); حيث يكون element هو المَعلمة الثانية أعلاه.

أخيرًا، سجِّل هذه الدالة لكي تتمكّن 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، يمكن للوحدات تحديد دالة بدلاً من سلسلة static ، والتي تعرض سلسلة عنوان URL، ما يتيح تقديم مساعدة ديناميكية.