Ana içeriğe geç

Biçimlendirme Kuralı

Emakin'deki biçimlendirme kuralı, bir veri modeli özelliğinin değerine göre widget'ın görünümünü ayarlar. Bu özellik, formu görsel açıdan dinamik ve bağlama duyarlı hâle getirerek kullanıcı deneyimini geliştirir.

Biçimlendirme kuralları kullanılarak aşağıdaki widget özellikleri güncellenebilir:

Hidden: Widget'ı ekrandan gizler.
Disabled: Düzenleme özelliklerini devre dışı bırakarak widget'ı salt okunur hâle getirir.
BackgroundColor: Widget'ın arka plan rengini değiştirir.
Color: Widget metninin rengini günceller.
Bold: Widget metnini kalın yapar.
Italic: Widget metnini italik yapar.

Özelliklerin Yayılması

Biçimlendirme özellikleri, kalıtım yoluyla kapsayıcı widget'ın alt widget'larına uygulanır.

Bir kapsayıcı widget gizlendiğinde, alt widget'lar ve bunlarla ilişkili kurallar, doğrulama kurallarıda dahil olmak üzere, artık çalıştırılmaz.

Şu özellikler gibi BackgroundColor, Color, Boldve Italic alt widget'lara devralınır. Alt widget'lar için belirli biçimlendirme kuralları tanımlanarak bu kalıtım geçersiz kılınabilir.

Devralınan Özellikleri Geçersiz Kılma

Biçimlendirme kuralı özelliklerinin varsayılan değeri Inherit veya boş bir dizgedir:

  • Değeri devral:

    • Widget, özellik değerini üst kapsayıcı widget'tan devralır.
    • Örnek: Bir Satır Kapsayıcısı devre dışı bırakılırsa tüm alt widget'ları otomatik olarak devre dışı kalır.

  • Açıkça geçersiz kılma:

    • Bir alt widget, belirli bir biçimlendirme kuralıyla devralınan durumu geçersiz kılabilir.
    • Örnek: Devre dışı bırakılmış bir satır kapsayıcısındaki metin kutusu, Disabled özelliğini Falseolarak ayarlayan bir kural tanımlayarak düzenlenebilir hâle gelebilir.

Biçimlendirme kurallarından ve özellik kalıtımından yararlanılarak Emakin formları, yinelenen yapılandırmalar en aza indirilirken duyarlı ve kullanıcı dostu arayüzler sunacak şekilde özelleştirilebilir.

Kural Koşulu

Biçimlendirme kuralı koşulları, boole değeri döndüren JavaScript işlevleriyle tanımlanır. Veri modelinde değişiklik olduğunda bu işlevler tetiklenir ve widget'ı buna göre günceller.

Koşul betikleri, eşzamansız işlemler için async/await kalıbını destekler. Bu sayede doğrulama mantığına harici API çağrıları veya uzun süren görevler eklenebilir.

Kullanılabilir Betik Değişkenleri

  • $Xml Widget'a bağlı XML veri modeli öğesini temsil eder.
  • $ActiveUser Geçerli kullanıcının kimlik bilgilerini içerir.
  • $Disabled Formun devre dışı durumunu belirtir.
  • $Process Şu anda çalışan sürecin kimliği.
  • $StaticUrl Statik dosyalara erişim URL'si.

JSON Nesnesinin $ActiveUser yapısı:

1
2
3
4
5
6
7
{
    "name": "<user_display_name>",
    "type": "User",
    "domain": "<domain_id>",
    "id": "<user_id>",
    "email": "<user_email>"
}

Warning

Değişkeni $Disabled tek tek widget'ların değil, formun devre dışı durumunu belirtir.

Örnek

Aşağıdaki örnekte bir metin kutusu widget'ı için biçimlendirme kuralı tanımlanmıştır. Veri modelindeki status özelliğinin değeri şu olarak ayarlandığında kural, metin kutusunun arka plan rengini kırmızıya çevirir: rejected.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<TextBox XPath="status">
    <Rules>
        <FormattingRule Hidden="Inherit" Disabled="Inherit" BackgroundColor="#f44336" Color="#fff" Bold="" Italic="">
            <Condition>
                <Content><![CDATA[return $Xml.Evaluate('rejected');]]></Content>
                <Definitions/>
            </Condition>
        </FormattingRule>
    </Rules>
</TextBox>