Dinamik Açılır Liste

Dinamik Açılır Liste form elemanı, listenin dinamik olarak yüklenebilmesi için oluşturulmuştur. Girilen değerlere göre, istek atılarak liste verileri API'den çekilir.

Genel Ayarlar

Genel ayarlara buradan ulaşabilirsiniz.

Gelişmiş Ayarlar

Bu bölümdeki gelişmiş ayarlar, istek atılacak URL ve ilgili diğer ayarlarla ilgilidir. Bu ayarlar sonrasında Dinamik Açılır Liste, istek atarak verileri çekebilir.

URL

İstek atılacak URL'dir. Bu URL içerisinde dinamik alanlar eklenebilir. Dinamik olarak eklenmiş değerler, : karakteri ile başlatılarak kullanılır.

Not: Zorunludur. (*)

Dinamik veriler, Proje Ayarlarından API Default URL Query Params içine eklenmiş herhangi bir değer olabilir. Ayrıca bir form elemanı URL tipinde seçilip bağımlı hale getirilirse, bu URL içerisinde dinamik olarak tanımlanabilir.

Method

İsteğin method tipidir (Örnek: GET, POST, DELETE, PUT).

Zorunludur. (*)

Data Key

Eğer URL'den gelen istek, direkt olarak bir Array şeklinde gelmiyorsa ve başka bir Key içerisinde yer alıyorsa, Data Key belirlenmelidir.

Zorunlu değildir.

Örnek:

Gelecek Response:

[{ "test": 1 }]

Data Key boş olmalıdır

Örnek:

Gelecek Response:

{ "list": [{ "test": 1 }] }

Data Key list olmalıdır

Başlık Key

Liste içinde başlık olarak gösterilecek yazının Key'idir

Zorunludur. (*)

Örnek:

Gelecek Response:

[
  { "label": "Seçenek 1", "value": 1 },
  { "label": "Seçenek 2", "value": 2 }
]

Başlık Key label olmalıdır

Değer Key

Liste içinde, başlığın değer Key'idir

Zorunludur. (*)

Örnek:

Gelecek Response:

[
  { "label": "Seçenek 1", "value": 1 },
  { "label": "Seçenek 2", "value": 2 }
]

Değer Key value olmalıdır

Arama Parametresi

Eğer listeyi API'ye filtre uygulayarak çekmek istiyorsak, arama parametresi girmek zorundayızdır.

Zorunlu değildir.

Örnek: Kullanıcı liste arama kısmına herhangi bir yazı yazdığında, girdiği yazıyı API'i içinde göndererek istek atmak istiyorum. Bu sayede filtrelenmiş listeyi görmek istiyorum.

Arama Parametresi: username
 
İstek atılan URL: /users/?username=kullanıcının_girdiği_değer

Bağımlılıklar

Eğer Dinamik Açılır Liste form elemanını başka bir elemanın değerine bağımlı hale getirmek istiyorsanız, bu bağımlılığı eklemeniz gerekir.

Zorunlu değildir.

Örnek:

Formunuza bir Açılır Liste form elemanı eklediniz ve Genel Ayarlar sekmesinden bu elemanın bağımlılık durumunu aktif hale getirdiniz. Ardından, Dinamik Açılır Liste form elemanını eklediniz ve ilk eklediğiniz form elemanının değerini URL üzerinde kullanmak istediniz. Bağımlılıklar kısmında, bağımlı olarak işaretlenmiş Key'i seçiyorsunuz ve Tip'ini URL olarak işaretliyorsunuz. Bu şekilde, seçilen Key değerini Dinamik Açılır Liste URL'si içinde kullanabilir hale gelirsiniz. İlk eklenen Açılır Liste form elemanının değeri değiştikçe, Dinamik Açılır Liste tekrar istek atacak ve yeni değerleri çekecektir.

Bağımlılık Tipleri

url: URL içerisinde kullanılacak bağımlılıklardır. URL olarak seçtikten sonra, dinamik olarak URL içerisine eklenmelidir.

body: Body içerisinde kullanılacak bağımlılıklardır. Eklenen bağımlılık body içerisinde gider.

Header

API isteğinde herhangi bir header eklemek istiyorsanız, bunu JSON formatında buraya ekleyebilirsiniz.

Zorunlu değildir.

Not: JSON formatında olmalıdır.

Notlar

Eklenen bağımlılığın değeri değiştiğinde, Dinamik Açılır Liste otomatik olarak yeni değer ile istek atar.

Eklenen bağımlılığa hiç değer girilmediyse, bir değer girene kadar Dinamik Açılır Liste devre dışı bırakılır.

Eklenen API'den array yerine başka bir şey gelirse hata mesajı görülebilir. Bu sebeple hiç değer gösterilmeyecekse bile boş Array döndürülmesi önerilir.