ব্লক সাহায্য

আপনি টুলটিপ এবং একটি সাহায্য URL আকারে ব্লক সহায়তা প্রদান করতে পারেন।

টুলটিপস

যখন ব্যবহারকারী ব্লকের উপর তাদের মাউস ঘোরায় তখন টুলটিপ তাৎক্ষণিক সহায়তা প্রদান করে। টেক্সট দীর্ঘ হলে, এটি স্বয়ংক্রিয়ভাবে মোড়ানো হবে।

JSON

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

জাভাস্ক্রিপ্ট

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

JavaScript API-এ, টুলটিপগুলিকে স্ট্যাটিক স্ট্রিংয়ের পরিবর্তে একটি ফাংশন হিসাবেও সংজ্ঞায়িত করা যেতে পারে। এটি গতিশীল সাহায্যের জন্য অনুমতি দেয়। একটি টুলটিপের উদাহরণের জন্য math_arithmetic দেখুন যা ড্রপডাউন বিকল্পটি বেছে নেওয়া হয়েছে তার উপর নির্ভর করে পরিবর্তিত হয়।

জাভাস্ক্রিপ্ট

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> উপাদান যেখানে আপনি বিষয়বস্তু রেন্ডার করবেন
  • দ্বিতীয়ত, আসল উপাদান যাকে মাউস করা হচ্ছে এবং যেটির জন্য আপনি টুলটিপ দেখাবেন

ফাংশনের বডিতে, আপনি ডিভ-এ আপনার পছন্দের বিষয়বস্তু রেন্ডার করতে পারেন। মাউস ওভার করা ব্লকে টুলটিপ স্ট্রিং সংজ্ঞায়িত করার জন্য, আপনি Blockly.Tooltip.getTooltipOfObject(element); যেখানে element উপরের দ্বিতীয় প্যারামিটার।

অবশেষে, এই ফাংশনটি নিবন্ধন করুন যাতে ব্লকলি এটিকে উপযুক্ত সময়ে কল করতে পারে:

Blockly.Tooltip.setCustomTooltip(yourFnHere);

একটি উদাহরণের জন্য, কাস্টম টুলটিপ ডেমো দেখুন।

সাহায্য URL

ব্লক তাদের সাথে যুক্ত একটি সাহায্য পৃষ্ঠা থাকতে পারে. ব্লকটিতে ডান-ক্লিক করে এবং প্রসঙ্গ মেনু থেকে "সহায়তা" নির্বাচন করে এটি ব্যবহারকারীদের জন্য উপলব্ধ। যদি এই মানটি null হয় তবে "সহায়তা" আইটেমটি দেখানো হয় না।

JSON

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

জাভাস্ক্রিপ্ট

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

JavaScript API ব্যবহার করে, ব্লকগুলি স্ট্যাটিক স্ট্রিংয়ের পরিবর্তে একটি ফাংশন নির্দিষ্ট করতে পারে, যা একটি URL স্ট্রিং প্রদান করে, এইভাবে গতিশীল সাহায্যের জন্য অনুমতি দেয়।