Opcje wstrzykiwania

Wstrzyknięcie

Możesz wstrzyknąć obszar roboczy Blockly za pomocą wywołania funkcji Blockly.inject(location, options). Pierwszy argument wskazuje Blockly, gdzie w DOM wstrzyknąć obszar roboczy. Drugi argument to słownik par nazwa-wartość, który służy do konfiguracji. Kod wstrzyknięcia analizuje słownik opcji i tworzy instancję Blockly.Options.

Tworzenie bezpośrednie

Możesz też utworzyć obszar roboczy bezpośrednio, dzwoniąc na numer Blockly.WorkspaceSvg(new Blockly.Options(options)). Pamiętaj, że musisz wywołać funkcję new Blockly.Options(options), przekazując słownik opcji – konstruktor workspace oczekuje wystąpienia Blockly.Options, a nie zwykłego słownika opcji.

Słownik opcji

Obsługiwane są te opcje: Pamiętaj, że wartość domyślna niektórych z tych opcji zmienia się w zależności od tego, czy udostępniony zestaw narzędzi zawiera kategorie.

Nazwa	Typ	Opis
collapse	wartość logiczna	Umożliwia zwijanie i rozwijanie bloków. Domyślnie true, jeśli narzędziownik zawiera kategorie, w przeciwnym razie false.
comments	wartość logiczna	Umożliwia dodawanie komentarzy do bloków. Domyślnie true, jeśli toolbox zawiera kategorie, w przeciwnym razie false.
css	wartość logiczna	Jeśli ma wartość fałsz, nie wstrzykuj kodu CSS (za jego dostarczenie odpowiada dokument). Domyślna wartość to true.
disable	wartość logiczna	Umożliwia wyłączenie blokad. Domyślnie true, jeśli toolbox zawiera kategorie, w przeciwnym razie false.
grid	obiekt	Konfiguruje siatkę, do której mogą przylegać bloki. Patrz sekcja Siatka.
horizontalLayout	wartość logiczna	Jeśli true jest poziomy, a false – pionowy. Domyślna wartość to false.
maxBlocks	liczba	Maksymalna liczba bloków, które można utworzyć. Przydatne w przypadku ćwiczeń dla uczniów. Domyślna wartość to Infinity.
maxInstances	obiekt	Mapowanie typów bloków na maksymalną liczbę bloków tego typu, które można utworzyć. Niedeklarowane typy mają domyślnie wartość Infinity. Przykład: maxInstances: {'controls_if': 3, 'math_number': 42}
media	ciąg znaków	Ścieżka od strony (lub ramki) do katalogu multimediów Blockly. Domyślna wartość to "https://blockly-demo.appspot.com/static/media/".
modalInputs	wartość logiczna	Jeśli true, na urządzeniach mobilnych wyświetlaj edytory modalne dla pól tekstowych i ich podklas, a na komputerach – edytor wbudowany. Jeśli false, wyświetlaj edytor w ramce zarówno na komputerach, jak i na urządzeniach mobilnych. Domyślna wartość to true.
move	obiekt	Konfiguruje sposób poruszania się użytkowników po przestrzeni roboczej. Zobacz Przenieś.
oneBasedIndex	wartość logiczna	Jeśli operacje na listach i ciagłym ciągu znaków true mają być indeksowane od 1, a jeśli false – od 0. Domyślna wartość to true.
readOnly	wartość logiczna	Jeśli true, uniemożliw użytkownikowi edytowanie. Pomijania sekcji toolbox i kosz. Domyślna wartość to false.
renderer	ciąg znaków	Określa renderowanie używane przez blockly. Wśród gotowych rendererów znajdują się 'geras' (domyślny), 'thrasos' i 'zelos' (renderer typu scratch).
rtl	wartość logiczna	Jeśli true, odwróć edytor (w przypadku języka arabskiego lub hebrajskiego). Zobacz prezentację RTL. Domyślna wartość to false.
scrollbars	obiekt lub boolean	Określa, czy pasek przewijania w obszarze roboczym ma być pionowy czy poziomy. Przyjmuje obiekt, w którym właściwość horizontal określa, czy przewijanie poziome jest włączone, a właściwość vertical określa, czy przewijanie pionowe jest włączone. Podanie wartości logicznej jest równoznaczne z przekazaniem obiektu z właściwościami horizontal i vertical ustawionymi na tę wartość. Jeśli toolbox zawiera kategorie, domyślnie przyjmuje się wartość true.
sounds	wartość logiczna	Jeśli false, wyłącza dźwięki. Domyślna wartość to true.
theme	Motyw	Jeśli nie zostanie podany żaden motyw, domyślnie zostanie użyty motyw klasyczny. Zobacz Motywy.
toolbox	ciąg znaków, XML lub JSON	Struktura drzewa kategorii i bloków dostępnych dla użytkownika. Więcej informacji znajdziesz w sekcji definiowanie zestawu narzędzi.
toolboxPosition	ciąg znaków	Jeśli "start" znajduje się u góry (w przypadku orientacji poziomej) lub po lewej (w przypadku orientacji pionowej i pisowni lewostronnej) albo po prawej (w przypadku orientacji pionowej i pisowni od prawej do lewej). Jeśli "end"skrzynka narzędzi znajduje się po drugiej stronie. Domyślna wartość to "start".
trashcan	wartość logiczna	Wyświetla lub ukrywa kosz. Domyślnie true, jeśli toolbox zawiera kategorie, w przeciwnym razie false.
maxTrashcanContents	liczba	Maksymalna liczba usuniętych elementów, które będą widoczne w wyskakującym okienku kosza. Wartość „0” powoduje wyłączenie tej funkcji. Domyślna wartość to „32”.
plugins	obiekt	Mapowanie typu wtyczki na nazwę zarejestrowanej wtyczki lub klasy wtyczki. Zobacz wstrzykiwanie podklas.
zoom	obiekt	Konfiguruje zachowanie powiększania. Zobacz Powiększenie.