Przestrzeń nazw zmiennych
Funkcje
| Funkcja | Opis |
|---|---|
| allDeveloperVariables(workspace) | Znajdź wszystkie zmienne dewelopera używane przez bloki w obszarze roboczym. Zmienne dewelopera nigdy nie są widoczne dla użytkownika, ale są deklarowane jako zmienne globalne w wygenerowanym kodzie. Aby zadeklarować zmienne dewelopera, zdefiniuj w bloku funkcję getDeveloperVariables i zwróć listę nazw zmiennych. Do użytku generatorów. |
| allUsedVarModels(ws) | Znajdź wszystkie zmienne utworzone przez użytkowników, które są używane w obszarze roboczym. Do użytku generatorów. Aby uzyskać listę wszystkich zmiennych w obszarze roboczym, w tym nieużywanych, wywołaj metodę getAllVariables. |
| createVariableButtonHandler(workspace, opt_callback, opt_type) | Obsługuje przycisk „Utwórz zmienną” w kategorii narzędzia „Domyślne zmienne”. Pojawi się prośba o podanie nazwy zmiennej, w tym ponowne, jeśli nazwa jest już używana w zmiennych obszaru roboczego. Obsługa niestandardowych przycisków może korzystać z tej funkcji, co umożliwia stosowanie różnych typów zmiennych i przetwarzanie po utworzeniu. Bardziej złożone dostosowywanie (np. wyświetlanie prompta dotyczącego typu zmiennej) wykracza poza zakres tej funkcji. |
| deleteVariable(workspace, variable, triggeringBlock) | usunąć zmienną i wszystkie jej zastosowania z danego obszaru roboczego. Może poprosić użytkownika o potwierdzenie. |
| flyoutCategory(workspace, useXml) | |
| flyoutCategory(workspace, useXml) | |
| flyoutCategoryBlocks(workspace) | Utwórz bloki wymagane przez wyskakujące okienko dla kategorii zmiennych. |
| generateUniqueName(workspace) | Zwraca nową nazwę zmiennej, która nie jest jeszcze używana. Na początek spróbuje wygenerować nazwy zmiennych z 1 litery w zakresie od „i” do „z”. Jeśli nie uda się znaleźć unikalnej nazwy, system spróbuje użyć kolejno „i”–„z”, „a”–„h”, „i2”–„z2” itd., pomijając „l”. |
| generateUniqueNameFromOptions(startChar, usedNames) | Zwraca niepowtarzalną nazwę, która nie występuje w tablicy usedNames. Spowoduje to wygenerowanie nazw jednoliterowych z zakresu a–z (pomijanie litery l). Zacznie się od znaku przekazanego do startChar. |
| generateVariableFieldDom(variableModel) | Generowanie obiektów DOM reprezentujących pole zmienne. |
| getOrCreateVariablePackage(workspace, id, opt_name, opt_type) | Funkcja pomocnicza do wyszukiwania lub tworzenia zmiennej w danym obszarze roboczym. Jeśli zmienna nie istnieje, tworzy ją i zwraca. |
| getVariable(workspace, id, opt_name, opt_type) | Wyszukiwanie zmiennej w danym obszarze roboczym. Zawsze sprawdza obszar roboczy główny, zanim sprawdzi obszar roboczy wysuwanego okienka. Wyszukiwanie według identyfikatora jest zawsze preferowane przed wyszukiwaniem według nazwy i typu. |
| getVariableUsesById(workspace, id) | Znajdź wszystkie miejsca, w których używana jest zmienna o nazwie. |
| nameUsedWithAnyType(name, workspace) | Sprawdź, czy istnieje zmienna o danej nazwie dowolnego typu. |
| promptName(promptText, defaultText, callback) | Zapytaj użytkownika o nazwę nowej zmiennej. |
| renameVariable(workspace, variable, opt_callback) | Otwiera prompt, który umożliwia użytkownikowi wpisanie nowej nazwy zmiennej. Jeśli nowa nazwa jest prawidłowa, powoduje zmianę nazwy. W przeciwnym razie wyświetli się ponowne prompt. |
Zmienne
| Zmienna | Opis |
|---|---|
| CATEGORY_NAME | Ciąg znaków do użycia w atrybucie „custom” kategorii w pliku XML toolbox. Ten ciąg znaków wskazuje, że kategoria powinna być wypełniana dynamicznie za pomocą bloków zmiennych. Zobacz też Blockly.Procedures.CATEGORY_NAME i Blockly.VariablesDynamic.CATEGORY_NAME. |
| TEST_ONLY | |
| VAR_LETTER_OPTIONS |