Ana içeriğe geç

Tekrarlanan İçerik

RepeatingContent widget'ı, dinamik ve dikey yönelimli içerik bölümlerinden oluşan bir listeyi yönetmek için esnek ve kullanıcı dostu bir arayüz sağlar. Eklenen her bölüm bir satırı temsil eder ve veri girişi ile düzenleme için bir dizi widget içerir.

XML Alanları

Koleksiyon ve Satır Seçimi

  • XPath koleksiyon bağlamını seçer ve ItemXPath tekrarlanan her satırı seçer. RowIdXPath liste yenilendiğinde veya düzenlendiğinde kararlı bir satır kimliği sağlar.
  • FilterXPath koşulunu karşılamayan satırları kaldırır; SortXPath satırların sırasını belirler. ItemsRootXPath koleksiyon kökü widget'ın bağlamından farklı olduğunda kullanılır.

Satır Komutları ve Boş Durum

  • AllowNewXPath, AllowDeleteXPath, AllowDeleteAllXPath, AllowMovingXPath, ve AllowMoveUpDownXPath eşleşen satır komutlarını denetler. Geçerli form veya satır durumuna göre değerlendirilen ifadeler kullanın.
  • AddNewLabel satır ekleme açıklamasını belirler. ShowBlankSlate boş durumunu etkinleştirir ve BlankSlate burada görüntülenecek içeriği içerir. MonitoredXPaths listeyi yenilemesi gereken form değerlerini belirtir.

Satır Sunumları

  • Preview daraltılmış satır görünümünü tanımlar. Editor satır düzenlenirken kullanılan denetimleri içerir. Details ek satır içeriğini içerir.
  • ExpandableDetails ayrıntılar panelinin genişletilmesini etkinleştirir. AllowDetailsXPath bu panelin belirli bir satır için kullanılabilir olup olmadığını belirler. RowWidth ve RowHeight isteğe bağlı satır boyutlarını tanımlar.
  • RowRules satırlara koşullu davranış uygular, RowScript bir satırı başlatır veya günceller ve DataExchange içe ve dışa aktarma verilerini tanımlar.

Temel Özellikler

  • şuna kıyasla daha zengin bir düzenleme deneyimi sunar: TableContent widget'ı.
  • Satır eklemeyi, silmeyi ve yeniden sıralamayı destekler.
  • Her satır için ayrı önizleme, düzenleyici ve ayrıntılar panelleri sağlar.
  • Satır içeriğinin genişletilip daraltılmasını sağlar.
  • Liste import/export işlevselliği içerir.

Satır Düzenleyicileri ve Kurallar

Her satırın önizleme, düzenleyici ve ayrıntılar panelleri için veri doğrulama ve biçimlendirme kuralları tanımlanabilir. Bu kurallar her satıra bağımsız olarak uygulanır.

Önizleme Paneli

Her satır için görüntülenir; satırın verilerini görüntülemeye veya bu verilerde temel düzenlemeler yapmaya uygun herhangi bir widget'ı içerebilir.

Düzenleyici Paneli

Kullanıcı önizleme panelindeki "Düzenle" düğmesiyle (veya benzer bir denetimle) etkileşime girdiğinde etkinleşir. Bu panel genellikle daha ayrıntılı veri düzenlemeye olanak tanıyan widget'lar içerir.

Ayrıntılar Paneli

Bu panel ( ExpandableDetails özelliği tarafından denetlenir), kullanıcı "Ayrıntılar" düğmesiyle (veya benzeriyle) etkileşime girdiğinde görüntülenir. Genellikle satırın verileriyle ilgili ek bilgileri gösterir.

Satır Betiği

RepeatingContent widget'ı, yeni satırları varsayılan değerlerle başlatmak veya diğer satırlardaki verilere göre hesaplamalar yapmak için komut dosyası çalıştırmayı destekler. Bu komut dosyası her yeni satır eklendiğinde çalıştırılır. Yeni eklenen satıra komut dosyası içindeki $NewChild değişkeni üzerinden erişilebilir.

Eksiksiz XML Örneği

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<RepeatingContent XPath="Items" RequiredForGroup="" ShowBlankSlate="True"
                  ExpandableDetails="False" RowWidth="0" RowHeight="0">
    <ItemXPath><![CDATA[*]]></ItemXPath>
    <RowIdXPath><![CDATA[]]></RowIdXPath>
    <FilterXPath><![CDATA[]]></FilterXPath>
    <SortXPath><![CDATA[]]></SortXPath>
    <ItemsRootXPath><![CDATA[]]></ItemsRootXPath>
    <AllowMovingXPath><![CDATA[]]></AllowMovingXPath>
    <AllowMoveUpDownXPath><![CDATA[]]></AllowMoveUpDownXPath>
    <AllowNewXPath><![CDATA[]]></AllowNewXPath>
    <AllowDeleteXPath><![CDATA[]]></AllowDeleteXPath>
    <AllowDeleteAllXPath><![CDATA[]]></AllowDeleteAllXPath>
    <AllowDetailsXPath><![CDATA[]]></AllowDetailsXPath>
    <AddNewLabel><Content><![CDATA[Add row]]></Content></AddNewLabel>
    <MonitoredXPaths />
    <BlankSlate />
    <RowScript><Content><![CDATA[]]></Content></RowScript>
    <DataExchange AllowImport="False" AllowExport="False"><Columns /></DataExchange>
    <RowRules />
    <Preview />
    <Details />
    <Editor />
    <Rules />
</RepeatingContent>

Örnek: Satır Numaralandırma Komut Dosyası

Aşağıdaki komut dosyası, RepeatingContent widget'ına eklenen her yeni satıra otomatik olarak ardışık bir satır numarası atar:

1
$NewChild.SetValue('RowNumber', $Xml.Count('Rows/Row') + 1);

Bu komut dosyası, veri modelinizde satırların şu yola sahip öğelerle temsil edildiğini varsayar: Rows/Row Veri modelinizin yapısını yansıtması için bu yolu gerektiği şekilde ayarlayın. Komut dosyası, mevcut satır sayısını belirlemek için $Xml.Count() işlevini kullanır ve yeni satırın RowNumber alanına bir sonraki ardışık numarayı atar.