0.6.0 • Published 10 years ago

uxrocket.modal v0.6.0

Weekly downloads
2
License
MIT
Repository
github
Last release
10 years ago

UX Rocket Modal

Modal plugini, jQuery Colorbox üzerine geliştirilmiştir. Orjinal plugindeki özelliklerin tamamı kullanılabilir. Ayrıca, modal pencere açacak bağlantılara data tanımları ile de ayarları değiştirilebilir. Colorbox kullanımı ile alakalı detayları buradan inceleyebilirsiniz.

<p>Başka bir <a href="http://github.com/uxrocket" class="modal">sayfaya</a> ajax</p>

<p><a href="http://player.vimeo.com/video/2285902" class="modal" data-iframe="true" data-inner-width="500" data-inner-height="409">Flash/Video gösterimi</a> (iframe ile vimeo videosu)</p>

<p>Başka bir <a href="http://www.google.com" class="modal" data-iframe="true" data-width="80%" data-height="80%">sayfaya</a> iframe</p>

<p>Sayfa içindeki <a href="#hidden-content" class="modal" data-inline="true">gizli bir içerik</a> gösterimi.</p>

<p>Callback <a href="http://www.google.com" class="modal" data-iframe="true" data-on-ready="onReady()" data-on-open="onOpen()" data-on-load="onLoad()" data-on-complete="onComplete()" data-on-cleanup="onCleanup"
data-on-closed="onClosed()">örnekleri</a> (console'da tetiklenen callbackleri görebilirsiniz).</p>
var onReady = function(){
	console.log("onReady: Modal plugini elemana bind oldu");
}

var onOpen = function(){
    console.log("onOpen: Modal plugini, pencereyi açıyor.");
}

var onLoad = function(){
    console.log("onLoad: Modal plugini, içeriği yükledi");
}

var onComplete = function(){
    console.log("onComplete: Modal plugini, pencere açılışını ve yüklemeyi tamamladı");
}

var onCleanup = function(){
    console.log("onCleanup: Modal plugini kapanmaya hazırlandı");
}

var onClosed = function(){
    console.log("onClosed: Modal plugini kapandı");
}

Notlar

Ajax formatında ya da inline açılan içeriklerde pencere genişliği yüklenen içeriğin genişliğine göre otomatik olarak belirlenir. Dilenirse, genişlik/yükseklik tanımı ayrıca yapılabilir.

iFrame formatında açılacak içerikler de ise, yükseklik ve genişlik tanımı yapılmalıdır.

Callback tanımlarında, onReady callbacki uxitd-modal plugini tarafından çalıştırılmaktadır. Diğer callbackler ise Colorbox eventlerine göre Colorbox içinden çalışmaktadır.

Tanımlar

PropertyDefaultAçıklama
iframefalsePencere içerisine yüklenecek içeriğin iFrame olarak yüklenmesini sağlar.
inlinefalsePencere içerisine yüklenecek içeriğin sayfa içerisinde bulunan bir eleman olmasını sağlar. Bu içerik bir seçici de olabilir. Bir jQuery objesi de olabilir. // Using a selector:$("#inline").modal({inline:true, href:"#myForm"}); // Using a jQuery object:var $form = $("#myForm");$("#inline").modal({inline:true, href:$form});
htmlfalseHerhangibir yerden çekilecek içerik yerine, doğrudan modal içerisinde gösterilecek bir html ya da text içerik tanımlamanızı sağlar. $.uxmodal({html:"Hello"});
ajaxBaşka bir tanım yapılmadığı durumda, pencere içerisine içerikler Ajax ile yüklenir.
hreffalseAçılacak içeriğin URL adresi. modal ile tanımlanmış linkin href attributeündeki URL adresi kullanılmaktadır.
widthnullAçılan içerik penceresi için ön tanımlı genişlik. Pixel ya da % cinsinden tanımlanabilir.
heightnullAçılan içerik penceresi için ön tanımlı yüksekli. Pixel ya da % cinsinden tanımlanabilir.
innerWidthfalse'width' tanımı için alternatif kullanımdır. Modal içindeki border ve buton genişliklerini hesaplamadan sadece yüklenen içerik kısmının genişliğini belirler.
innerHeightfalse'height' tanımı için alternatif kullanımdır. Modal içindeki border ve buton genişliklerini hesaplamadan sadece yüklenen içerik kısmının genişliğini belirler.
maxWidthfalseYüklenen içeriğin kendi genişliğinden bağımsız olarak, modal penceresinin maksimum genişliğini belirler.
maxHeightfalseYüklenen içeriğin kendi yüksekliğinden bağımsız olarak, modal penceresinin maksimum yüksekliğini belirler.
Data Attribute 
iframePencere içerisine yüklenecek içeriğin iFrame olarak yüklenmesini sağlar.
inlinePencere içerisine yüklenecek inline bir elemanın id, class'ı ya da etiketi ni belirtir.
htmlİçerik olarak gösterilecek HTML ya da Text formatlı metni belirtir.
widthAçılan içerik penceresi için ön tanımlı genişlik. Pixel ya da % cinsinden tanımlanabilir.
heightAçılan içerik penceresi için ön tanımlı yüksekli. Pixel ya da % cinsinden tanımlanabilir.
inner-width'width' tanımı için alternatif kullanımdır. Modal içindeki border ve buton genişliklerini hesaplamadan sadece yüklenen içerik kısmının genişliğini belirler.
inner-height'height' tanımı için alternatif kullanımdır. Modal içindeki border ve buton genişliklerini hesaplamadan sadece yüklenen içerik kısmının genişliğini belirler.
max-widthYüklenen içeriğin kendi genişliğinden bağımsız olarak, modal penceresinin maksimum genişliğini belirler.
maxHeightYüklenen içeriğin kendi yüksekliğinden bağımsız olarak, modal penceresinin maksimum yüksekliğini
Callback 
onReadyModal plugini elemana bağlandığında çalışacak fonksiyonu çağırır.
onOpenLinke tıklandığında, modal açılmadan önce çalışacak fonksiyonu çağırır.
onLoadModal açıldığında, içine gösterilecek içerik yüklenmeye başlandığında çalışacak fonksiyonu çağırır.
onCompleteModal penceresine gösterilecek içerik yüklendikten sonra çalışacak fonksiyonu çağırır.
onCleanupModal penceresi kapanmadan önce çalışacak fonksiyonu çağırır.
onClosedModal penceresi kapandıktan sonra çalışacak fonksiyonu çağırır.

Public Metodlar

MethodAçıklama
$(selector).modal(options)Bu method plugini manuel olarak bir elemana bağlamanızı sağlar.
$.uxmodalBu method pluginin detayını görmenizi sağlar
$.uxmodal.versionSayfaya eklenmiş pluginin versiyon numarasını gösterir.
$.uxmodal.settingsAktif pluginin ayarlarını gösterir.
$.uxmodal.close()Modal penceresini kapatır.
$.uxmodal.resize()Modal penceresini tekrar boyutlandırır.
$.uxmodal.remove()Modal penceresini sayfadan kaldırır. Bu metod çağrıldıktan sonra, modal penceresinin çalışması iptal edilmiş olur.