Wejścia wbudowane a zewnętrzne

Dane wejściowe mogą być renderowane w treści lub zewnętrznie. Określa, czy złącza wejść wartości są renderowane wewnątrz bloku (w linii) czy na zewnętrznej krawędzi (zewnętrznej), a także czy wejścia są renderowane w tym samym czy w różnych wierszach.

Warianty bloków „count with x from value to value do statement” (zliczaj od x do wartości do wartości wykonaj instrukcję) w formie wbudowanej i zewnętrznej. W wersji wbudowanej blok ma 2 wiersze: w górnym wierszu znajduje się tekst „count with x from value to value” (zliczaj x od wartości do wartości), a w dolnym – „do statement” (wykonaj instrukcję). Dane wejściowe mają kształt elementów układanki wyciętych z wewnętrznej części górnego wiersza. W zewnętrznej odmianie blok ma 4 wiersze: „count with x”, „from value”, „to value” i „do statement”. Wejścia wartości znajdują się na końcach drugiego i trzeciego rzędu i wyglądają jak żeńskie złącza puzzli.

Definicja bloku może zawierać opcjonalną wartość logiczną określającą, czy dane wejściowe są wstawione w tekście.

JSON

{
  // ...,
  "inputsInline": true
}

JavaScript

init: function() {
  // ...
  this.setInputsInline(true);
}

Gdy ta wartość logiczna ma wartość true (dane wejściowe w tekście):

  • Złącza do wprowadzania wartości są renderowane w bloku.
  • Dane wejściowe instrukcji są renderowane w osobnym wierszu.
  • Dane wejściowe typu „dummy”, „end-of-row” i „value” są renderowane w tym samym wierszu, z wyjątkiem danych wejściowych, które następują po instrukcji lub danych wejściowych typu „end-of-row”. Są one renderowane w nowym wierszu.

Gdy jest ustawiona na false (wejścia zewnętrzne):

  • Złącza do wprowadzania wartości są renderowane na zewnętrznej krawędzi bloku.
  • Wszystkie dane wejściowe są renderowane w osobnych wierszach, z wyjątkiem danych wejściowych końca wiersza, które następują po danych wejściowych zastępczych i są renderowane w tym samym wierszu co dane wejściowe zastępcze.

Jeśli masz problem z wyobrażeniem sobie tego, utwórz bloki w narzędziach dla programistów Blockly i wybierz różne ustawienia w menu inputs (automatic, external, inline).

Jeśli ta wartość logiczna nie jest zdefiniowana, Blockly użyje heurystyki, aby odgadnąć, który tryb jest najlepszy. Jeśli Blockly podejmie właściwą decyzję, lepiej pozostawić to pole niezdefiniowane, ponieważ różne tłumaczenia mogą automatycznie mieć różne tryby. Zobacz przykład "set %1 to %2" (wejścia zewnętrzne) i "put %2 in %1" (wejścia w tekście) w sekcji Kolejność tokenów interpolacji.

Używaj elementów wejściowych w tekście, gdy blok prawdopodobnie będzie zawierać małe elementy wejściowe, takie jak liczby. Użytkownik może włączyć lub wyłączyć tę opcję w menu kontekstowym.