Kişisel bir web günlüğü

jQuery ile hazırladığım “Kalan Karakter” eklentisi

JQueryjQuery ile eklenti hazırlamanın önemli bir nedeni de değişik projelerde ihtiyaç duyulan aynı kodları, her seferinde kopyala-yapıştır yapmaktan kurtulmaktır. Ben de textarea gibi metin alanlarında kullandığım ve ziyaretçilerin kaç karakterlik yazı yazabileceklerini gösteren kodları bir eklenti haline getirdim. Eklentiye de Kalan Karakter ismini verdim ;)

Eklentinin özellikleri nelerdir?

  1. Textarea ve Input gibi metin alanlarında kullanabilirsiniz
  2. Karakter limitini istediğiniz gibi belirleyebilirsiniz
  3. Ziyaretçiye gösterilecek mesajı istediğiniz gibi yazabilirsiniz
  4. Ziyaretçiye gösterilecek mesaj için DIV gibi veya SPAN gibi istediğiniz bir HTML etiketi kullanabilirsiniz
  5. Kullanımı çok kolaydır ve yalnızca 1 KB boyutundadır
jquery için kalan karakter eklentisi

Eklenti nasıl kullanılıyor?

Önce eBurhan Araçları sayfasından eklentiyi bilgisayarınıza indirin. İndirdiğiniz dosya içerisindeki "jquery.kalanKarakter.js" dosyasını jQuery kütüphanesi ile birlikte web sayfanıza alttaki gibi bağlamalısınız.

  1. <script type="text/javascript" src="jquery.js"></script>
  2. <script type="text/javascript" src="jquery.kalanKarakter.js"></script>

Bu işlemden sonra eklentiyi kullanmaya başlayabiliriz. Diyelim ki web sayfamızdaki bir iletişim formunda, ID özniteliği mesaj olan bir textarea elemanı bulunsun. Alttaki gibi:

  1. <textarea id="mesaj" cols="25" rows="5"></textarea>

Bu metin alanına 50 karakterlik bir limit koymak için yazmamız gereken kodlar şöyle olmalıdır:

  1. $('textarea#mesaj').kalanKarakter({
  2.     limit: 50,
  3.     mesaj: 'kalan karakter: #1',
  4.     kapsa: '<div></div>',
  5.     uyari: function(){
  6.         alert('karakter limiti aşıldı !');
  7.     }
  8. })

İşte hepsi bu kadar ;) Çalışır halini görmek için demo sayfasına bakabilirsiniz.

Eklentinin hangi seçenekleri var?

Yukarıdaki örnek uygulamada limit, metin, kapsa, uyari gibi seçenekler kullandık. Bunlar, eklentinin seçenekleridir ve 4 tanedir. Bu seçenekleri tanımlamak zorunda değilsiniz zira tanımlamadığınız zaman varsayılan ayarlar kullanılacaktır ve eklenti çalışmaya devam edecektir. Şimdi bu 4 adet seçeneğe kısaca gözatalım:

  1. limit: metin alanına toplam kaç karakter yazı yazılabileceğini tanımlar. 500, 1000 gibi sayısal değerler verilmelidir. Varsayılan değeri 250 olarak tanımlıdır.
  2. mesaj: metin alanının altında veya yanında ziyaretçiye gösterilecek olan mesajı tanımlar. #1 parametresi, limit seçeneğinin değerini işaret eder.
  3. kapsa: mesajın gösterileceği alan için kullanılacak olan HTML etiketini tanımlar. DIV, SPAN veya EM gibi etiketler kullanabilirsiniz fakat etiketin başlangıçını ve bitişini mutlaka belirtmelisiniz. Örneğin etiket olarak EM kullanacaksanız bu seçeneğe <em></em> şeklinde bir değer girmelisiniz. Ayrıca bu etikete class ataması da yapılabilir. Örnek vermek gerekirse <em class="kalanKarakter"></em> formatında bir değer girebilirsiniz. Böylece CSS kullanarak mesaj alanını kolayca biçimlendirebilirsiniz.
  4. uyari: karakter limiti aşıldığında bir fonksiyonun çalıştırılmasını sağlar. Örneğin bu seçenek ile "alert()" gibi javaScript fonksiyonlarını kullanarak ziyaretçiyi uyarabilirsiniz veyahut Css Message Boxes gibi uygulamaları tetikleyebilirsiniz.

Sonuç

Eklentinin kurulumu ve kullanımı çok kolay fakat yine bir video sunumu hazırladım.
Alttaki ekran görüntüsüne tıklayarak videoyu online izleyebilirsiniz ve Kalan Karakter eklentisini daha yakından tanıyabilirsiniz. Eklentinin faydalı olması dileğiyle... ;)

jquery için kalan karakter eklentisi

17 Mayıs 2008, 15:55 İnternet & Web Bugün 19 kez, toplamda ise 2,551 kez okundu. , , , , ,
14 yorum var
  1. yine güzel bir çalışma teşekkürler. ancak asp dilini kullandığım için tr karakter hatası verir mi?

  2. Gerçekten işe yarayacak bir eklenti. Sağol. Forumlarda imza boyutu vb. bunla düzenlenebilir.

  3. Çok güzel elinize sağlık. Keşke kodları packed etmeseydiniz biz de bakardık. Aslında bir tane de yorumlu olanı olsa çok güzel olur. Bu video işi tuttu galiba ;)

  4. @sinan
    bu eklenti asp’ye veya php’ye bağlı değil. O yüzden karakter sorunu oluşturmaz.

    @HMERT
    eklentiyi indirdiğinde göreceksin ki bir tane “jquery.kalanKarakter.dev.js” dosyası var. bu dosyada herşey açık, paketlenmiş birşey yok.

  5. pardon ben demodan bakmıştım…

  6. Eline sağlık üstad, bu aralar çok iyi gidiyorsun. Durmak yok :)

  7. hocam peki bunu mesaj kutularına nasıl ayarlayacağız?

  8. @sinan
    Bunu video‘da adım adım anlatmıştım.

  9. Merhaba sitenizin takipçisiyim. Gerçekten çok hoş ve işe yara bilgiler veriyorsunuz. Teşekkürler.

  10. Adaş, Adobe Dreamweaver’ın kod yazarken ne kadar da hızlandırıcı olduğunu bu video ile hatırlamış oldum. Hemen bir yerlerden tedarik ediyorum :))

    Ayrıca bu video işini cidden sevdim. Bundan sonra ben de kullanayım.

    İyi çalışmalar.

  11. tamam hocam unutmuşum.

İçinizde kalmasın, siz de yorum yazın

Copyright © 2008 eburhan.com | Structure Theme | XHTML 1.0 | Yukarı