Değer
Tüm alanların, alan verileri için doğru kaynağı temsil eden bir değere sahip olması gerekir. Bu, herhangi bir türde (dize, sayı, dizi, tarih vb.) olabilir. Alanlar, değerleri kısıtlamak veya makine tarafından okunabilir bir biçime çevirmek için doğrulayıcılar kullanabilir (ör. tarih biçimlerini normalleştirme).
Metin
Tüm alanlar, alanın değerini temsil eden basit ve okunabilir bir dize olan metin içerir. Bu, mutlaka aynı oldukları anlamına gelmez. Örneğin, bir Boole alanındaki metin "Açık" veya "Kapalı" olabilirken değeri true veya false olur.
Bu metin, erişilebilirlik için blok daraltıldığında gösterilir ve isteğe bağlı olarak blok içi gösterimin bir parçası olabilir.
Düzenlenebilir ve düzenlenemez alanlar
Genel olarak, düzenlenebilir alanlar kullanıcının kodda değişiklik yapmasına olanak tanırken düzenlenemeyen alanlar, kullanıcıya blokla ilgili bilgileri gösterir. Düzenlenebilir alanlar tıklandığında zengin düzenleyici gösterilebilir.
Düzenlenebilir alanlar şunlardır:
Düzenlenemeyen alanlar şunlardır:
Serileştirme
Serileştirilebilir bir alanın değeri, kaydetme biçiminde (JSON veya XML) kodlanır. Değerleri dinamik olduğundan, düzenlenebilir tüm alanlar serileştirilebilir. Düzenlenemeyen alanların değerleri genellikle dinamik olmadığından genellikle serileştirilmez.
Serileştirilmiş alanlar şunlardır:
Serileştirilmemiş alanlar şunlardır:
Etiketlenebilir alanının düzenlenemediğini ancak etiketlenebilir olduğunu unutmayın. Bu nedenle, kullanıcı tarafından görülebilen bir kullanıcı arayüzü aracılığıyla değil, yalnızca programatik olarak düzenlenebilir. Düzenlendikten sonra değeri, oluşturulan JSON/XML'de kodlanır.
Kod oluşturma
Alanlar, blokları bağlama ve blokların bağlantısını kaldırmanın yanı sıra kullanıcının Blockly tarafından oluşturulan kodu kontrol edebileceği tek yöntemdir. Bir alan tarafından sağlanan düzenleyici, kullanıcının alan tarafından depolanan değeri değiştirmesine olanak tanır. Bloğun oluşturucusu, oluşturulan kodda kullanılmak üzere alanın değerine erişebilir.
Bir alanın değerini oluşturucuda kullanma hakkında daha fazla bilgi için alan kodu oluşturma başlıklı makaleyi inceleyin.
Blok içi ekran
Bir alanın blok içi gösterimi, alanın değerini temsil eden SVG öğelerinden oluşan bir koleksiyondur. Bunlar blokta yer kaplar ve boyutları değiştiğinde bloğun boyutunu değiştirmeye zorlar. Bir alanın blok içi gösterimi, ihtiyaçlarına bağlı olarak basit veya karmaşık olabilir.
Aşağıda, karmaşıklığı artan sırayla farklı blok içi görüntülere ilişkin bazı örnekler verilmiştir.
| Alan türü | Açıklama |
|---|---|
| Şirket | Yalnızca bir metin öğesi içeriyor. |
| Açı | Arka plan dikdörtgeni, metin öğesi ve derece simgesi içerir. |
| Kaplumbağa | Arka plan dikdörtgeni, metin öğesi ve kaplumbağa grafiğini oluşturmak için kullanılan birçok SVG öğesi içerir. |
Düzenleyici ekranı
Kullanıcı düzenlenebilir bir alanı tıkladığında alanda rastgele karmaşık bir düzenleyici gösterilebilir.
Aşağıda, karmaşıklık sırasına göre farklı düzenleyicilere ilişkin bazı örnekler verilmiştir.
| Alan türü | Açıklama |
|---|---|
| Onay kutusu | Tıklandığında düzenleyici açılmıyor. Blok içi ekran güncellemeleri. |
| Sayı girişi | Blok içi gösterimin üzerinde yer paylaşımlı metin düzenleyici. Kullanıcılar yazabilir. Düzenleyici, hatalı değerleri belirtmek için rengi değiştirebilir. |
| Açı seçici | Açı seçicide hem sayı yazmak için bir metin düzenleyici hem de açıları görsel olarak seçmek için sürüklenebilir bir düzenleyici bulunur. |
Diğer ekran modları
Daraltılmış mod: Kullanıcı bloğu daraltır.Blok, değerlerinin metin gösterimini, tek tek alanlar tarafından döndürülen metni kullanarak gösterir.
Erişilebilirlik modu: Kullanıcılar, Blockly ile etkileşim kurmak için ekran okuyucu veya benzeri bir teknoloji kullanıyor olabilir. Alan metni kullanıcıya okunabilir.