- eyceks, bir AJAX (Asenkron Javascript Ve XML) kütüphanesidir.
- Kendi uygulamalarınızda kolay yoldan AJAX tekniğini kullanabilmenizi sağlar.
- eyceks ile sayfalarınız arasında bilgi alış-verişi yapabilirsiniz. Bu esnada sayfanın tümü yüklenmez !
- Kullanımı çok kolaydır.
- Ticarî olmayan işlerde kullanım kısıtlaması yoktur.
Sayfadan sayfaya veri transferi için POST ve GET olmak üzere iki farklı metod kullanılır. eyceks kütüphanesi bu iki metodu da kullanabilmenizi sağlar. POST işlemleri için JXP, GET işlemleri için JXG fonksiyonu kullanılmalıdır. Her iki fonksiyonda aynı parametreler ile çalışmaktadır ve böylece size kolaylık sağlar. Her fonksiyon için ayrı ayrı parametre kullanmanız gerekmez.
POST işlemleri için => JXP(yukleniyor, yer, dosya, sc)
GET işlemleri için => JXG(yukleniyor, yer, dosya, sc)
Parametrelerin anlamları
1. yukleniyor:
İşlem tamamlanıncaya kadar, işlemin yapıldığını belirtmek amacıyla kullanılır. Parametre için 1 kullanırsanız yükleniyor resmi görüntülenir, 0 kullananırsanız yükleniyor resmi görüntülenmez.
2. yer:
Geri dönen verinin sayfanın hangi bölümüne yerleştirileceğini belirtmek amacıyla kullanılır. Ayrıca bu parametre no_id isimli özel bir değer alır. Bu değer kullanıldığında geri dönen bilgi sayfanın herhangi bir bölümünde gösterilmez. Aynı zamanda yukleniyor parametresini devre dışı bırakır.
3. dosya:
Gönderilen bilgilerin hangi sayfada işleneceğini belirtir. Örneğin bilgiler form_isle.php isminde bir sayfada işlenecekse, bu parametrenin olduğu yere sayfa ismi aynen yazılmalıdır.
4. sc:
Açılımı Sorgu Cümlesi'dir. "dosya" parametresinde bildirdiğiniz dosyaya, bilgileri taşıyan ifadededir.
Örnek bir fonksiyon kullanımı
- Method olarak POST methodu kullanısın
- İşlem başlangıcından bitişine kadar yükleniyor resmi görüntülensin
- Geri dönen bilgi ID'si sonuc olan bölgeye yerkeştirilsin
- Yolladığımız bilgiler islem.php sayfasına gönderilsin
- "islem.php" sayfasına isim=Erhan ve soyisim=BURHAN bilgileri gönderilsin
JXP(1, 'sonuc', 'islem.php', 'isim=Erhan&soyisim=BURHAN')
Bu örnekte bilgiler "islem.php" sayfasına gönderildi. Gönderilen bilgiler işleniyorken ve geri dönüyorken yükleniyor resmi gösterildi. Geri gönen bilgiler, ID'si "sonuc" olan bölgede gösterildi. <span id="sonuc"></span>
Bilinen Sorunlar
- Yalnızca Internet Explorer'da oluşan bir soruna dikkat etmeniz gerekli. innerHTML yöntemi ile p etiketiyle oluşan bir sorundan dolayı geri dönen veriler sayfada gösterilememektedir. Bu yüzden <p id="sonuc"></p> kullanımından kaçınmalısınız.
Versiyon 1.3
- Loading() fonksiyonuna hata kontrolü eklendi. Hata oluştuğunda sebebi yazıyor.
- JXG fonksiyonunda sc parametresini bildirmek zorunda değilsiniz artık.
Versiyon 1.2
- Daha önceki sürümlerde görünmeyen "Yükleniyor" göstergesi düzeltildi.
- Kütüphane dosyası içerisinde yapılan kod optimizasyonu sonucunda sayfanın boyutu %30 hafifletildi.
- JXP ile JXG fonksiyonları arasında fark kalktı. Artık her iki fonksiyon da aynı parametrelerle çalışabilmektedir.
Versiyon 1.1
- Türkçe karakter sorunu düzeltildi
- Zararlı karakterleri, zararsız karakterlere dönüştüren fonksiyon eklendi. fc_() fonksiyonu
- JXP fonksiyonunun qs olan parametresi sc olarak değiştirildi.
Versiyon 1.0
- İlk dağıtım :)
Detay için:
http://ajax-tr.com/
eburhan@ajax-tr.com