Ana içeriğe geç

Yinelenen İçerik

RepeatingContent widget'ı, dikey olarak düzenlenmiş dinamik içerik bölümlerini 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 yinelenen satırların her birini 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 sıralarını tanımlar. ItemsRootXPath koleksiyon kökü widget'ın bağlamından farklı olduğunda kullanılır.

Satır Komutları ve Boş Durum

  • AllowNewXPath, AllowDeleteXPath, AllowDeleteAllXPath, AllowMovingXPathve AllowMoveUpDownXPath ilgili satır komutlarını denetler. Geçerli form veya satır durumunu temel alarak değerlendirilen ifadeler kullanın.
  • AddNewLabel satır ekleme başlığını ayarlar. ShowBlankSlate boş durumu etkinleştirir ve BlankSlate orada görüntülenen içeriği barındırır. MonitoredXPaths listeyi yenilemesi gereken form değerlerini belirtir.

Satır Sunumları

  • Preview kompakt 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 barındırır.
  • 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 kapsamlı 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ına olanak tanır.
  • Liste işlevselliği import/export içerir.

Satır Düzenleyicileri ve Kurallar

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

Önizleme Paneli

Her satır için görüntülenir; satır verilerini görüntülemeye veya temel düzeyde düzenlemeye uygun herhangi bir widget'ı içerebilir.

Düzenleyici Paneli

Kullanıcı önizleme panelindeki "Düzenle" düğmesiyle (veya benzer bir denetimle) etkileşime geçtiğinde etkinleşir. Bu panel genellikle verilerin daha ayrıntılı düzenlenmesini sağlayan widget'lar içerir.

Ayrıntılar Paneli

Kullanıcı "Ayrıntılar" düğmesiyle (veya benzeriyle) etkileşime geçtiğinde bu panel ( ExpandableDetails özelliği tarafından denetlenir) görünür. Genellikle satır verileriyle ilgili ek bilgiler görüntüler.

Satır Komut Dizisi

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

Tam 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 Dizisi

Aşağıdaki komut dizisi, 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 dizisi, satırların veri modelinizde Rows/Row yoluna sahip öğelerle temsil edildiğini varsayar. Veri modeli yapınıza uyacak şekilde bu yolu gerektiği gibi ayarlayın. Komut dizisi, mevcut satır sayısını belirlemek için $Xml.Count() işlevini kullanır ve yeni satırın RowNumber alanına sıradaki numarayı atar.