ब्लॉक करने से जुड़ी सहायता

टूलटिप और सहायता यूआरएल के तौर पर, ब्लॉक करने से जुड़ी मदद दी जा सकती है.

टूलटिप

जब उपयोगकर्ता ब्लॉक पर कर्सर घुमाता है, तो टूलटिप तुरंत मदद करते हैं. अगर टेक्स्ट लंबा है, तो वह अपने-आप रैप हो जाएगा.

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 देखें.

पसंद के मुताबिक बनाना

कस्टम रेंडरिंग फ़ंक्शन देकर, टूलटिप के लुक को भी पसंद के मुताबिक बनाया जा सकता है. ऐसा फ़ंक्शन बनाएं जो दो पैरामीटर स्वीकार करता हो:

• सबसे पहले, <div> एलिमेंट, जहां आपको कॉन्टेंट रेंडर करना है
• दूसरा, वह असल एलिमेंट जिस पर कर्सर घुमाया जा रहा है और जिसके लिए आपको टूलटिप दिखाना है

फ़ंक्शन के मुख्य हिस्से में, अपनी पसंद का कॉन्टेंट div में रेंडर किया जा सकता है. माउस घुमाने पर जिस ब्लॉक पर कर्सर जाता है उस पर तय की गई टूलटिप स्ट्रिंग पाने के लिए, Blockly.Tooltip.getTooltipOfObject(element); को कॉल किया जा सकता है. यहां element, ऊपर दिया गया दूसरा पैरामीटर है.

आखिर में, इस फ़ंक्शन को रजिस्टर करें, ताकि Blockly इसे सही समय पर कॉल कर सके:

Blockly.Tooltip.setCustomTooltip(yourFnHere);

उदाहरण के लिए, कस्टम टूलटिप का डेमो देखें.

सहायता यूआरएल

ब्लॉक के साथ एक सहायता पेज हो सकता है. उपयोगकर्ता, ब्लॉक पर राइट क्लिक करके और कॉन्टेक्स्ट मेन्यू से "सहायता" चुनकर, इस सुविधा का इस्तेमाल कर सकते हैं. अगर यह वैल्यू null है, तो "सहायता" आइटम नहीं दिखता.

JSON

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

JavaScript

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

JavaScript API का इस्तेमाल करके, ब्लॉक में स्टैटिक स्ट्रिंग के बजाय कोई फ़ंक्शन तय किया जा सकता है. यह फ़ंक्शन, यूआरएल स्ट्रिंग दिखाता है, ताकि डाइनैमिक मदद मिल सके.