DIV CSS 佈局教程網

jQuery Boxy 彈出層進階用法(二):手動建立、常用對話框與完整 API
編輯:JQuery特效代碼     

4.1 手動建立實例

除了自動掛載,也可以直接 new 出一個 Boxy 物件,以便完整掌控參數:

<script type="text/javascript">
$(function() {
    $("#a1").click(function() {
        var box1 = new Boxy("<h3>這個參數是顯示的內容</h3>", {
            title: "標題",            // 對話框標題
            modal: false,             // 是否為強制模式視窗
            afterHide: function(e) { alert("dialog hide"); }, // 隱藏後回呼
            afterShow: function(e) { alert("dialog show"); }, // 顯示後回呼
            closeText: "X",           // 關閉按鈕的提示文字
            draggable: true           // 是否可拖曳
        });
        box1.resize(300, 100);        // 設定對話框尺寸
    });
});
</script>

<a href="#" id="a1">手動建立一個實例</a>

實測發現:當 modal 設為 true 時背景會被遮罩,此時即使 draggable 為 true 也無法拖動視窗。若希望使用者能自由移動對話框,請把 modal 設為 false。

5.1 提問框

$("#a2").click(function() {
    Boxy.ask("請選擇一個選項:",
        ["選項一", "選項二", "選項三"],   // 可選項
        function(val) { alert(val); },   // 回呼,收到被選取的值
        { title: "測試", modal: false }   // 對話框屬性
    );
});

四個參數分別是:question 提問內容、answers 選項陣列、callback 回呼、options 屬性設定。回呼收到的值形式取決於 answers 是純陣列還是「值—文字」對應的數列。

5.2 警告框

$("#a3").click(function() {
    Boxy.alert("這是警告訊息",
        function(val) { alert(val); },
        { title: "提示" }
    );
});

5.3 確認框

$("#a4").click(function() {
    Boxy.confirm("你確定要繼續嗎?",
        function() { alert("已確認"); },   // 只在按下確定時執行
        { title: "測試", modal: false }
    );
});

需要特別留意:Boxy.alert 與 Boxy.confirm 並非用來取代瀏覽器原生的 window.alert/window.confirm。原生版本會同步阻斷程式執行,而 Boxy 是非同步的,程式不會停下來等使用者回應。

6. API 參數

靜態方法

Boxy.load(url, options):以指定 URL 載入內容並以對話框呈現。支援類型(HTTP 方法,預設 GET)、緩存(預設 false)、過濾(以 jQuery 表達式篩選遠端內容)等選項,其餘設定會直接傳入建構函數。

Boxy.get(element):取得與該元素關聯的 Boxy 實例,例如 onclick="Boxy.get(this).hide();"。

Boxy.ask(question, answers, callback, options):顯示可選擇的提問框。

Boxy.alert(message, callback, options):顯示訊息框。

Boxy.confirm(message, callback, options):顯示含確定與取消的確認框,回呼僅在按下確定時執行。

Boxy.linkedTo(ele):回傳透過建構選項關聯到該 DOM 元素的實例。

Boxy.isModalVisible():若有強制模式對話框正在顯示則回傳 true。

new Boxy(element, options):建構函數。element 為對話框內容,任何 $() 可接受的形式皆可。

尺寸與位置

estimateSize():在對話框不可見時估算尺寸;若已可見請改用 getSize()。
getSize():以 [width, height] 陣列回傳尺寸。
getContentSize():回傳內容區尺寸,不含標題欄。
getPosition():以 [x, y] 回傳左上角座標。
getCenter():以 [x, y] 回傳中心點座標。
moveTo(x, y):移動到左上角為 (x, y) 的位置。
centerAt(x, y):移動到中心為 (x, y) 的位置。
center(axis):置中於視野,axis 可為 "x"、"y" 或省略。
resize(w, h, after):立即調整尺寸,完成後執行回呼。
tween(w, h, after):以動畫補間方式調整尺寸。

內容與顯示控制

getInner():回傳包含標題欄的內部區域。
getContent():回傳不含標題欄的內容區域。
setContent(newContent):設定內容,可接受任何 $() 支援的形式。
isVisible()/show()/hide(after)/toggle():查詢與切換可見狀態。
hideAndUnload(after):隱藏後立即卸載。
unload():從 DOM 移除對話框並中斷與觸發器的關聯;卸載後再操作該實例屬未定義行為。
toTop():移到所有對話框的最上層。
getTitle()/setTitle(t):讀取與設定標題 HTML。

CSS 選擇器對照

選擇器對應元素
.boxy-wrapper .title-bar自動產生的標題欄 div
.boxy-wrapper .title-bar h2標題欄的內容
.boxy-wrapper .title-bar.dragging拖曳中的標題欄
.boxy-wrapper .title-bar .close預設的關閉按鈕
.boxy-inner內部區域,含標題欄
.boxy-content內部區域,不含標題欄;此類別會自動加到傳入建構函數的元素上
.boxy-wrapper .questionBoxy.ask() 產生的問題文字區
.boxy-wrapper .answersBoxy.ask() 產生的答案按鈕區
.close加上此類別的元素,點擊後即關閉對話框

外框的圓角是以 PNG 圖片拼出的,若想調整透明度可用圖片編輯軟體修改;若專案已不需相容 IE6,也可改用純 CSS 的圓角寫法,省去四張圖片與額外篩選器。

官方網站:https://onehackoranother.com/projects/jquery/boxy/

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved