DIV CSS 佈局教程網

jBox 2.3 多功能 jQuery 對話框插件:安裝配置與常見問題全解析
編輯:JQuery特效代碼     

jBox 是一款以 jQuery 為基礎打造的多功能對話框插件,能輕鬆為網站塑造統一而精緻的視覺風格,為使用者帶來耳目一新的操作體驗。

執行環境與授權

在瀏覽器相容性方面,jBox 支援 IE6 以上的版本,同時也能在 Firefox、Chrome、Safari、Opera 等主流瀏覽器上穩定運作。授權上,jBox 提供永久免費使用,但使用者需保留相關的版權資訊。若有任何改進建議,歡迎透過留言與作者交流。

目前版本為 2.3,檔案大小約 19.8k。線上展示頁面:https://www.kudystudio.com/jbox/jbox-demo.html

v2.3 beta 版本更新重點(2011-11-08)

  • [新增] tip 方法加入 opacity 選項,用於控制是否顯示隔離層。
  • [新增] 加入 showScrolling 選項,在彈出 jBox 視窗時可隱藏瀏覽器的捲軸。
  • [新增] 多視窗並存時,點擊任一視窗標題即可自動將該視窗置於最上層。
  • [調整] id 選項預設值改為 null,當值為 null 時會自動產生隨機 id,且同一個 id 僅顯示一個 jBox。
  • [調整] loaded 選項新增參數 h,代表視窗內容的 jQuery 物件,方便使用者在視窗載入後對內容做初始化處理。
  • [調整] 全域設定抽離至獨立 js 檔案,統一收錄於 i18n 目錄,目前提供 jquery.jBox-zh-CN.js。
  • [調整] 按下空白鍵即可觸發預設按鈕的提交事件(權衡後仍優先保留此使用者體驗)。
  • [修復] 解決 IE 下多視窗狀態切換時無法顯示的問題。

基本用法

先在頁面中依序引入 jQuery、jBox 主程式、中文語言包以及對應的皮膚樣式表:

<script type="text/javascript" src="jBox/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="jBox/jquery.jBox-2.3.min.js"></script>
<script type="text/javascript" src="jBox/i18n/jquery.jBox-zh-CN.js"></script>
<link type="text/css" rel="stylesheet" href="jBox/Skins/皮膚文件夾/jbox.css"/>
// 或
<link type="text/css" rel="stylesheet" href="jBox/Skins2/皮膚文件夾/jbox.css"/>

常見使用問題

1. 建議採用 XHTML 1.0 標準

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

2. 不想顯示標題

將 title 設為 null 即可,例如:jBox('內容', { title: null });

3. 隱藏或自訂按鈕

把 buttons 設為 {} 表示不顯示按鈕,例如:jBox('內容', { buttons: {} });。若需自訂按鈕,可寫成 jBox('內容', { buttons: {'按鈕1':'按鈕1點擊返回值','按鈕2':'按鈕2點擊返回值'} });。此外还能透過 buttonsFocus 指定預設按鈕,索引從 0 開始。

4. 不顯示隔離層

將 opacity 設為 0 即可,例如:jBox('內容', { opacity: 0 });

5. 讓視窗自動關閉

timeout 設為 0 代表不自動關閉,填入正整數則表示多少毫秒後關閉。例如 3 秒後關閉:jBox('內容', { timeout: 3000 });

6. 不顯示隔離層時,避免重複彈出相同視窗

只要傳入 id 即可,因為同一個 id 僅會顯示一個視窗,例如:jBox('內容', { id: 'my-id'});

7. 視窗寬高一定要指定嗎?能否自適應?

除 iframe 情況外,其餘情境都能讓寬高自適應,例如:jBox('內容', { width: 'auto', height:'auto' });

jBox 提供的可選參數相當豐富,搭配不同組合能創造多樣效果,建議詳閱 jquery.jBox-zh-CN.js 中的全域參數說明。若使用簡體中文且不打算修改全域設定,其實無須載入 jquery.jBox-zh-CN.js,因為 jquery.jBox-2.3.min.js 內建的預設值與中文語言包一致。若只想調整少數選項(例如視窗邊框),一行程式碼就能搞定:jBox.setDefaults({ defaults: { border: 8} });

jBox 全域參數對照

/* jBox 全局設置 */
var jBoxConfig = {};
jBoxConfig.defaults = {
id: null, /* 頁面中的唯一id,若為null則自動生成隨機id,一個id只顯示一個jBox */
top: '15%', /* 視窗距頂部的距離,可用百分比或像素(如 '100px') */
border: 5, /* 視窗外框像素大小,須為0以上整數 */
opacity: 0.1, /* 隔離層透明度,設為0則不顯示隔離層 */
timeout: 0, /* 顯示多少毫秒後自動關閉,設為0則不關閉 */
showType: 'fade', /* 顯示類型:show、fade、slide */
showSpeed: 'fast', /* 顯示速度:'slow'、'fast' 或毫秒整數 */
showIcon: true, /* 是否顯示標題圖標 */
showClose: true, /* 是否顯示右上角關閉按鈕 */
draggable: true, /* 是否可拖動視窗 */
dragLimit: true, /* 拖動時是否限制在可視範圍內 */
dragClone: false, /* 拖動時滑鼠按下是否克隆視窗 */
persistent: true, /* 顯示隔離層時,點擊隔離層是否堅持不關閉 */
showScrolling: true, /* 是否顯示瀏覽器捲軸 */
ajaxData: {}, /* ajax post 的資料 */
iframeScrolling: 'auto', /* iframe 的 scrolling 屬性值:'auto'、'yes'、'no' */
title: 'jBox', /* 視窗標題 */
width: 350, /* 寬度,'auto' 或像素整數 */
height: 'auto', /* 高度,'auto' 或像素整數 */
bottomText: '', /* 按鈕左側內容 */
buttons: { '確定': 'ok' }, /* 按鈕設定 */
buttonsFocus: 0, /* 第幾個按鈕為預設,索引從0開始 */
loaded: function (h) { }, /* 載入完成後執行的函數,參數h為視窗內容的jQuery物件 */
submit: function (v, h, f) { return true; }, /* 點擊按鈕後的回調,返回true關閉視窗 */
closed: function () { } /* 關閉後執行的函數 */
};
$.jBox.setDefaults(jBoxConfig);

如果喜歡 jBox,別忘了給它一個好評。

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