Alan değerlerini dönüştürme

Çoğu alan değeri, kod dizenizle hemen birleştirilmeye hazırdır. Ancak bazı alan değerlerinin kullanılabilmesi için ek işlemler gerekir.

Yaylı çalgılar

Dizelerin birleştirilebilmesi için quote_ veya multiline_quote_ ile tırnak içine alınması gerekir. Bu işlevler, dile özgü karakter kaçışları gerçekleştirir (ör. JavaScript'te ' yerine \').

// For a single line text field.
const str = generator.quote_(block.getFieldValue('STR'));

// For a multiline text field.
const str = generator.multiline_quote_(block.getFieldValue('STR'));

Değişkenler

Yerleşik değişken alanı için getFieldValue, değişken adı yerine değişken kimliği döndürür. Gerçek bir değişken adı almak için kod oluşturucuda getVariableName işlevini çağırın. Bu işlem, hem benzersiz hem de yasal olan bir ad döndürür. getVariableName, diğer özelliklerin yanı sıra:

  • ASCII olmayan karakterleri ASCII'ye dönüştürür. Kullanıcılar değişken adlarını kendi dillerinde girebileceğinden bu gereklidir. Örneğin, "متغير" değerini "_D9_85_D8_AA_D8_BA_D9_8A_D8_B1" olarak dönüştürür.
  • Değişken adlarının, programlama dilleri tarafından belirlenen kurallara uymasını sağlar. Örneğin, boşlukları alt çizgiye dönüştürür ve sayı ile başlayan değişken adlarına my_ ön ekini ekler.
  • Ayrılmış kelimeler veya diğer değişken ya da işlev adlarıyla çakışmaları çözer. Örneğin, for kodunu for2 şeklinde dönüştürür.
const identifier = generator.getVariableName(block.getFieldValue('VAR'));

Yerleşik açılır liste alanı için getFieldValue, kodda doğrudan kullanılamayabilecek dilsiz bir dize döndürür. Örneğin, karşılaştırma operatörleri içeren bir açılır liste 'EQUALS', 'LESS' veya 'GREATER' döndürebilir. Bu, kodda kullanılan bir dizeyi aramak için kullanılabilir.

const OPERATORS = {
  EQUALS: '==',
  LESS: '<',
  GREATER: '>',
};
const operator = OPERATORS[block.getFieldValue('OPERATOR')];

Onay kutuları

Yerleşik onay kutusu alanı için getFieldValue, 'TRUE' veya 'FALSE' döndürür. Bu seçeneği nasıl kullanacağınız, onay kutusunun anlamına bağlıdır. Örneğin, kod oluştururken dallandırma için kullanabilirsiniz.