Wartość
Wszystkie pola muszą mieć wartość, która jest źródłem danych zgodnych z tym polem. Może to być dowolny typ (ciąg znaków, liczba, tablica, data itp.). Pola mogą używać walidatorów do ograniczania wartości lub tłumaczenia do formatu zrozumiałego dla komputera (np. normalizowania formatów dat).
Tekst
Wszystkie pola zawierają tekst, który jest prostym, zrozumiałym dla człowieka ciągiem znaków, który reprezentuje wartość pola. Nie musi to oznaczać, że są one identyczne. Na przykład tekst w polu wartości logicznej może być włączony lub wyłączony, a jego wartość to „true” (prawda) lub „false” (fałsz).
Ten tekst jest wyświetlany, gdy blok jest zwinięty, na potrzeby ułatwień dostępu i opcjonalnie może być częścią wyświetlacza na bloku.
Pola do edycji i pola, których nie można edytować
Ogólnie rzecz biorąc, pola z możliwością edycji umożliwiają użytkownikowi wprowadzanie zmian w kodzie, a pola, których nie można edytować, zawierają informacje o bloku. Po kliknięciu pól do edycji może wyświetlać się edytor sformatowany.
Pola, które można edytować, obejmują:
Pola, których nie można edytować:
Serializacja
Wartość pola możliwego do serializacji jest kodowana w formacie zapisu (JSON lub XML). Wszystkie pola do edycji można szeregować, ponieważ ich wartości są dynamiczne. Wartości pól, których nie można edytować, zwykle nie są dynamiczne, więc zwykle nie są zserializowane.
Zserializowane pola obejmują:
Pola niezserializowane obejmują:
Zwróć uwagę, że pole „Etykieta można serializować” nie jest edytowalne, ale można je serializować. Oznacza to, że można ją edytować tylko automatycznie, a nie za pomocą interfejsu widocznego dla użytkownika. Po wprowadzeniu zmian jej wartość jest kodowana w wygenerowanym formacie JSON/XML.
Generowanie kodu
Oprócz łączenia i rozłączania bloków jedynym sposobem, w jaki użytkownik może kontrolować kod generowany przez Blockly, są pola. Edytor dostępny w polu umożliwia użytkownikowi modyfikowanie wartości zapisanej w tym polu. Dzięki temu generator bloku może uzyskać dostęp do wartości pola i wykorzystać ją w wygenerowanym kodzie.
Więcej informacji o używaniu wartości pola w generatorze znajdziesz w artykule o generowaniu kodu pola.
Ekran blokowy
Wyświetlanie w bloku pola to zbiór elementów SVG reprezentujących wartość pola. Zajmują miejsce na bryle, a przy zmianie rozmiaru wymuszają na niej zmianę rozmiaru. Wyświetlanie bloków pola może być proste lub złożone – w zależności od potrzeb.
Oto kilka przykładów różnych wyświetlaczy blokowych uporządkowanych według rosnącego złożoności.
| Typ pola | Opis |
|---|---|
| Etykieta | Zawiera tylko element tekstowy. |
| Kąt | Zawiera prostokątny tło, element tekstowy i symbol stopnia. |
| Żółw | Zawiera prostokątne tło, element tekstowy i wiele elementów SVG używanych do utworzenia grafiki z żółwiem. |
Widok edytora
Gdy użytkownik kliknie pole możliwe do edytowania, może się ono wyświetlić w maksymalnie złożonym edytorze.
Oto kilka przykładów różnych edytorów w kolejności ich rosnącego złożoności.
| Typ pola | Opis |
|---|---|
| Pole wyboru | Brak edytora po kliknięciu. Sposób wyświetlania na ekranie jest aktualizowany. |
| Pole do wpisania liczby | Edytor tekstu nałożony nad wyświetlaczem. Użytkownicy mogą pisać. Edytor może zmienić kolor, aby wskazać nieprawidłowe wartości. |
| Selektor kąta | Selektor kąta zawiera zarówno edytor tekstu do wpisywania liczb, jak i przeciągany edytor do wizualnego wybierania kątów. |
Inne tryby wyświetlania
Tryb zwinięty: użytkownik zwija blok.Blok wyświetla wartości reprezentujące tekst przy użyciu tekstu zwróconego przez poszczególne pola.
Tryb ułatwień dostępu: do interakcji z Blockly użytkownicy mogą używać czytnika ekranu lub podobnej technologii. Treść pola może zostać odczytana użytkownikowi.