Wartość
Wszystkie pola muszą mieć wartość, która jest źródłem wiarygodnych informacji o danych w polu. 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 ich na format czytelny 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 reprezentującym wartość pola. Nie oznacza to jednak, że są one takie same. Na przykład tekst w polu logicznym może mieć wartość „Włączone” lub „Wyłączone”, a jego wartość to true lub false.
Ten tekst jest wyświetlany, gdy blok jest zwinięty, aby ułatwić dostęp, i może być opcjonalnie częścią wyświetlania w bloku.
Pola, które można edytować, i pola, których nie można edytować
Ogólnie rzecz biorąc, pola edytowalne umożliwiają użytkownikowi wprowadzanie zmian w kodzie, a pola nieedytowalne wyświetlają informacje o bloku. Po kliknięciu pól, które można edytować, może pojawić się edytor tekstu sformatowanego.
Pola, które można edytować:
Pola, których nie można edytować:
Publikacja w odcinkach
Wartość pola serializowalnego jest kodowana w formacie zapisu (JSON lub XML). Wszystkie pola, które można edytować, są serializowane, ponieważ ich wartości są dynamiczne. Wartości pól, których nie można edytować, zwykle nie są dynamiczne, więc nie są serializowane.
Pola serializowane:
Pola nieserializowane:
Zwróć uwagę, że pola Label Serializable nie można edytować, ale można je serializować. Oznacza to, że można go edytować tylko programowo, a nie za pomocą interfejsu widocznego dla użytkownika. Po edycji wartość jest kodowana w wygenerowanym pliku JSON/XML.
Generowanie kodu
Oprócz łączenia i rozłączania bloków pola są jedynym sposobem, w jaki użytkownik może kontrolować kod generowany przez Blockly. Edytor udostępniany przez pole umożliwia użytkownikowi modyfikowanie wartości przechowywanej w polu. Generator bloku może wtedy uzyskać dostęp do wartości pola, aby użyć jej w wygenerowanym kodzie.
Więcej informacji o używaniu wartości pola w generatorze znajdziesz w artykule o generowaniu kodu pola.
Wyświetlacz na bloku
Wyświetlanie pola w bloku to zbiór elementów SVG reprezentujących wartość pola. Zajmują one miejsce w bloku i gdy zmieniają rozmiar, wymuszają zmianę rozmiaru bloku. Wyświetlanie pola w bloku może być proste lub złożone, w zależności od potrzeb.
Oto kilka przykładów różnych wyświetleń w bloku w kolejności rosnącej złożoności.
| Typ pola | Opis |
|---|---|
| Etykieta | zawiera tylko element tekstowy. |
| Kąt | Zawiera prostokąt tła, element tekstowy i symbol stopnia. |
| Żółw | Zawiera prostokąt tła, element tekstowy i wiele elementów SVG używanych do tworzenia grafiki żółwia. |
Wyświetlanie w edytorze
Gdy użytkownik kliknie pole z możliwością edycji, może się w nim wyświetlić dowolnie złożony edytor.
Oto przykłady różnych edytorów w kolejności rosnącej złożoności:
| Typ pola | Opis |
|---|---|
| Pole wyboru | Po kliknięciu nie otwiera się edytor. Wyświetlacz na bloku zostanie zaktualizowany. |
| Wpisywanie liczb | Edytor tekstu nałożony na wyświetlacz urządzenia. Użytkownicy mogą wpisywać wartości. Edytor może zmieniać kolor, aby wskazywać nieprawidłowe wartości. |
| Selektor kąta | Selektor kąta ma edytor tekstu do wpisywania liczb i edytor z możliwością przeciągania do wizualnego wybierania kątów. |
Inne tryby wyświetlania
Tryb zwinięty: użytkownik zwija blok.Blok wyświetla tekstową reprezentację swoich wartości, korzystając z tekstu zwróconego przez poszczególne pola.
Tryb ułatwień dostępu: użytkownicy mogą korzystać z czytnika ekranu lub podobnej technologii do interakcji z Blockly. Tekst w polu może być odczytywany użytkownikowi.