Możesz utworzyć obszar roboczy i wstrzyknąć go do DOM w pojedynczym wywołaniu lub utworzyć tylko obszar roboczy.
Wstrzyknięcie
Możesz utworzyć obszar roboczy Blockly i wstrzyknąć go do DOM za pomocą wywołania Blockly.inject(location, options). Pierwszy argument wskazuje Blockly, gdzie w DOM wstrzyknąć obszar roboczy. Drugi argument to obiekt zawierający opcje konfiguracyjne.
Więcej informacji znajdziesz w artykule Tworzenie workspace’a.
Tworzenie bezpośrednie
Możesz utworzyć obszar roboczy bezpośrednio, wywołując funkcję new Blockly.WorkspaceSvg(new
Blockly.Options(options)). Podczas wywoływania tej metody prześlij opcje konfiguracji w wywołaniu do new Blockly.Options(options) – konstruktor WorkspaceSvg nie może bezpośrednio przyjmować obiektu opcji konfiguracji.
Opcje konfiguracji
Obiekt konfiguracji implementuje interfejs Blockly.BlocklyOptions i ma te opcje: Pamiętaj, że wartość domyślna niektórych z tych opcji zmienia się w zależności od tego, czy podany zestaw narzędzi zawiera kategorie.
| Nazwa | Typ | Opis |
|---|---|---|
collapse
|
Wartość logiczna | Określa, czy menu kontekstowe bloków zawierają element umożliwiający zwijanie lub rozwijanie bloków. Jeśli narzędziownik zawiera kategorie, domyślna wartość to true, w przeciwnym razie false. |
comments
|
Wartość logiczna | Określ, czy menu kontekstowe blokowania mają zawierać opcję dodawania lub usuwania komentarzy. Jeśli toolbox ma kategorie, domyślnie jest to true, 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 | Określa, czy menu blokad kontekstowych zawierają opcję umożliwiającą wyłączenie lub włączenie blokad. Jeśli narzędziownik zawiera kategorie, domyślna wartość to true, 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} |
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”. |
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/". Zapoznaj się z artykułem Folder z mediami. |
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 ciągu znaków true mają być indeksowane od 1, a operacje na false – od 0. Domyślna wartość to true. |
plugins
|
obiekt | Nazwa typu rejestru obiektów mapująca nazwy klas zastępczych lub zarejestrowane nazwy klas zastępczych. Zobacz Wstawianie zajęć zastępczych. |
readOnly
|
Wartość logiczna | Jeśli true, uniemożliw użytkownikowi edytowanie. Pomija narzędziownik i kosz. Domyślna wartość to false. |
renderer
|
ciąg znaków | Określa renderowanie używane przez blockly. Wstępnie skompilowane mechanizmy renderowania to „geras” (domyślny), „thrasos” i „zelos” (mechanizm renderowania podobny do mechanizmu samodzielnego). |
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 wartość logiczna | 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 poddaniem 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 artykule 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 od lewej do prawej) 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. |
zoom |
obiekt | Konfiguruje zachowanie powiększania. Zobacz Powiększenie. |