Bir alanın anatomisi

Değer

Tüm alanlar, alandaki verilerin doğru kaynağı olan bir değere sahip olmalıdır. Bu değer 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 (ör. tarih biçimlerini normalleştirme) için doğrulayıcılar kullanabilir.

Metin

Tüm alanlar, alanın değerini temsil eden, kullanıcıların okuyabileceği basit bir dize olan metin içerir. Bu, her zaman aynı oldukları anlamına gelmez. Örneğin, boole alanındaki metin "Açık" veya "Kapalı" olabilir ancak değeri "doğru" veya "yanlış" olabilir.

Bu metin, erişilebilirlik için blok daraltıldığında görüntülenen ve isteğe bağlı olarak engellenen ekranın bir parçası olan metindir.

Düzenlenebilir ve düzenlenemeyen alanlar

Genel olarak, düzenlenebilir alanlar kullanıcının kodda değişiklik yapmasına izin verirken düzenlenemeyen alanlar kullanıcıya engelleme hakkında bilgi gösterir. Düzenlenebilir alanlar tıklandığında zengin düzenleyici gösterebilir.

Düzenlenebilir alanlar şunlardır:

Düzenlenemeyen alanlar aşağıdakileri içerir:

Serileştirme

Seri hale getirilebilir bir alanın değeri, kaydetme biçiminde (JSON veya XML) kodlanır. Tüm düzenlenebilir alanlar, değerleri dinamik olduğundan serileştirilebilir. Düzenlenemeyen alanların değerleri genellikle dinamik olmadığından genellikle serileştirilmez.

Serileştirilmiş alanlar şunları içerir:

Serileştirilmemiş alanlar şunları içerir:

Etiket Serileştirilebilir alanının düzenlenebilir olmadığını, ancak serileştirilebilir olduğunu unutmayın. Bu, verilerin kullanıcılar tarafından görülebilen bir kullanıcı arayüzü yerine yalnızca programlı olarak düzenlenebildiği anlamına gelir. Düzenlendikten sonra değeri, oluşturulan JSON/XML olarak kodlanır.

Kod oluşturma

Kullanıcının Blockly tarafından oluşturulan kodu kontrol edebilmesinin tek yolu, blokları bağlama ve bağlantıları kesmenin yanı sıra alanlardır. Bir alanın sağladığı düzenleyici, kullanıcının alan tarafından depolanan değeri değiştirmesine olanak tanır. Ardından bloğun oluşturucu, oluşturulan kodda kullanmak üzere alanın değerine erişebilir.

Oluşturucuda bir alanın değerini kullanma hakkında daha fazla bilgi için alan kodu oluşturma bölümünü inceleyin.

Blok üzerindeki ekran

Bir alanın bloktaki ekranı, alanın değerini temsil eden SVG öğelerinin koleksiyonudur. Bunlar, blokta yer kaplar ve boyut değiştikçe blokun boyutu da değişir. Bir alanın bloktaki ekranı, ihtiyaçlarına bağlı olarak basit veya karmaşık olabilir.

Bunlar, karmaşıklığı artan sıraya göre blok içindeki farklı ekranlara bazı örneklerdir.

Alan türü Açıklama
Etiket Yalnızca metin öğesi içerir.
Açı Dik arka plan, metin öğesi ve derece simgesi içerir.
Kaplumbağa Kaplumbağa grafiğini oluşturmak için kullanılan bir arka plan dikdörtgeni, metin öğesi ve birçok SVG öğesi içerir.

Düzenleyici ekranı

Kullanıcı düzenlenebilir bir alanı tıkladığında, alanda isteğe bağlı olarak karmaşık bir düzenleyici görüntülenebilir.

Karmaşıklığı artan bir sıra ile, farklı editörlere bazı örnekler verilmiştir.

Alan türü Açıklama
Onay kutusu Tıklandığında düzenleyici yok. Bloktaki ekran güncellenir.
Sayı girişi Blok ekranının üzerinde yer alan 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ıları yazmak için bir metin düzenleyici, hem de açıları görsel olarak seçmek için sürüklenebilir bir düzenleyici vardır.

Diğer görüntü modları

Daraltılmış mod: Kullanıcı, bloğu daraltır.Blok, tek tek alanlar tarafından döndürülen metni kullanarak kendi değerlerinin metin temsilini görüntüler.

Kaplumbağa tarlası bloğunun daralması

Erişilebilirlik modu: Kullanıcılar, Blockly ile etkileşimde bulunmak için bir ekran okuyucu veya benzer bir teknoloji kullanıyor olabilir. Alandaki metin kullanıcıya sesli okunabilir.