Areas

Kütüphanenin "mor > Ajax > Areas" dalında bulunan “SourceArea”, “TargetArea” ve "RefreshableArea" elemanları sayfalarda sadece istenilen bölümleri, tüm sayfa için yeni bir istekte bulunmadan tazelemek için kullanılırlar. Yenileme tanımı RefreshAreasAction veya RefreshAreasProcess elemanlarından biri ile yapılır.
 

TargetArea

Sayfa üzerinde tazelenmesi gereken alan için “TargetArea” elemanı kullanılabilir. Bu eleman panel elemanından türetilmiştir. Bu nedenle elemanın içine alt elemanlar yerleştirilerek ilk yenileme işlemine kadar görünecek olan içerik hazırlanabilir.

SourceArea

“SourceArea” elemanı ise “TargetArea” elemanına yeni içerik sağlamak üzere kullanılır. Bu elemanlar bir başka sayfa içine yerleştirilmelidir. Bir ya da daha fazla “SourceArea” elemanının yerleştirildiği sayfalara “Kaynak Sayfası” adı verilir.

Bir Kaynak Sayfası bir ya da daha fazla “SourceArea” elemanını içerebilen taşıyıcı sayfalardır. Kendileri doğrudan sayfa gösteriminde kullanılmazlar. İçlerine yerleştirilecek olan “SourceArea” eleman sayısında bir sınırlama olmamasına rağmen, yenileme isteği alındığında XSLT işleminin tüm sayfa için yapılacağı göz önüne alınmalıdır. Bu nedenle aynı kaynak sayfası içine sadece aynı anda tazelenecek olan elemanlar yerleştirilmesi performans açısından önemlidir.

RefreshableArea

RefreshableArea hem SourcePanel hem de TargetPanel görevi görür ve ayrı bir sayfada bir SourceArea oluşturulmadan da kullanılabilir.

Bu elemanı kullanırken dikkat edilmesi gereken konu elemanın içine yerleştirilmiş olduğu sayfanın, SourceArea elemanında olduğu gibi, kaynak sayfa olarak işleme alınacağı, ve sayfanın bir bütün olarak XSLT işlemine dahil edileceğidir. Ancak normal sayfaları üretirken olduğu gibi sayfada yer alan tüm veri kaynakları değil sadece RefreshableArea tarafından kullanılan veri kaynakları harekete geçirilir.

Bu nedenle, örneğin eğer RefreshableArea tekrarlayan bir blok içinde ise tekrarlamayı sağlayan veri kaynağından veri gelmeyeceği için, beklediğiniz sonucu alamayabilirsiniz.

Alan içeriklerini yenileme işlemi RefreshAreasAction ve RefreshAreasProcess elemanları aracılığı ile tanımlanır.