Engellemeyle ilgili yardım

İpucu ve yardım URL'si biçiminde engelleme yardımı sağlayabilirsiniz.

İpuçları

İpuçları, kullanıcı fareyle bloğun üzerine geldiğinde anında yardım sunar. Metin uzunsa otomatik olarak kaydırılır.

JSON

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

JavaScript

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

JavaScript API'de ipuçları, statik dize yerine işlev olarak da tanımlanabilir. Bu sayede dinamik yardım alabilirsiniz. Hangi açılır liste seçeneğinin seçildiğine bağlı olarak değişen bir ipucu örneği için math_arithmetic bölümüne bakı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];
    });
  }
};

JavaScript API'sini kullanarak bloklar, ipucu dizesini döndüren statik bir dize yerine bir işlev belirtebilir. Bu sayede dinamik ipuçları gösterilebilir. Örnek için bkz. math_arithmetic.

Özelleştirme

Özel bir oluşturma işlevi sağlayarak ipucularınızın görünümünü de özelleştirebilirsiniz. İki parametre kabul eden bir işlev oluşturun:

• ilk olarak, içeriği oluşturacağınız bir <div> öğesi
• ikincisi, fareyle üzerine gelinen ve ipucu gösterilecek öğe

İşlevin gövdesinde, div içine istediğiniz içeriği oluşturabilirsiniz. Fareyle üzerine gelinen blokta tanımlanan ipucu dizesini almak için Blockly.Tooltip.getTooltipOfObject(element); işlevini çağırabilirsiniz. Burada element, yukarıdaki ikinci parametredir.

Son olarak, Blockly'nin uygun zamanda çağırabilmesi için bu işlevi kaydedin:

Blockly.Tooltip.setCustomTooltip(yourFnHere);

Örnek için Özel ipucu demosuna bakın.

Yardım URL'si

Blokların ilişkili bir yardım sayfası olabilir. Kullanıcılar, bloğu sağ tıklayıp içerik menüsünden "Yardım"ı seçerek bu yardım sayfasına ulaşabilir. Bu değer null ise "Yardım" öğesi gösterilmez.

JSON

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

JavaScript

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

JavaScript API'sini kullanarak bloklar, URL dizesi döndüren statik bir dize yerine bir işlev belirtebilir ve böylece dinamik yardıma izin verebilir.