【jBox】2.3正式版 多功能jQuery對話框插件下載及常見使用問題解答

版本:2.3 正式版

大小:15.5k

下載:點擊下載

2.3beta版升級爲正式版只要把jquery.jBox-2.3.min.js替換即可,近期內應該都不會有新的改動了。

 

請jbox的用戶在使用之前,花點時間好好看一遍在線實例和各方法的option選項說明,這幾天在2.2公佈出去以來,已經有很多朋友加我QQ問我一些小問題,而這些都可以在http://www.kudystudio.com/jbox/jbox-demo.html找到答案的,不是本人沒耐心幫助大家,希望大家在看過在線實例和各方法的option選項說明後還是不懂,再來找我幫忙,謝謝大家的配合,因爲本人要忙自己的項目,沒多少時間來給大家一一解答,請理解。等忙完這幾個月,本人會用時間完成自己的工作室網站,給大家提供更完善的應用實例與api說明。

 

在線demo:http://www.kudystudio.com/jbox/jbox-demo.html

 

插件說明

- jBox 是一款基於 jQuery 的多功能對話框插件,能夠實現網站的整體風格效果,給用戶一個新的視覺享受。

運行環境

- 兼容 IE6+、Firefox、Chrome、Safari、Opera 等主流瀏覽器。

使用授權

- jBox 永久免費使用,但是必須保留相關的版權信息。如果有好的建議,可以直接在下面留言。

 

 

[2011-11-11] jBox v2.3 正式版

- [調整&修復] IE6下有iframe或頁面有active、applet控件的情況下自動選擇用iframe來遮罩。

- [修復] IE6下拖動窗口到右邊時邊框不可見的樣式錯誤(依然還有20px,但影響不大)。

- [修復] IE6下prompt相關方法與messager方法的圖標最小高度不正確的樣式修正。

- [修復] IE6下messager方法的窗口在滾動條被拖動的時候位置不正確的bug。

- [修復] 修復瀏覽器改變大小時遮罩層不完全的bug。

[2011-11-08] jBox v2.3 beta 版本更新

- [新增] tip方法增加了 opacity 選項,它決定是否顯示隔離層。

- [新增] 增加了 showScrolling 選項,在顯示jBox窗口時可以隱藏瀏覽器的滾動條。

- [新增] 多個窗口共存時,點擊某個窗口標題時,窗口自動處於最頂層。

- [調整] id 選項默認改爲null,當爲null時會自動生成隨機id,一個id只會顯示一個jBox。

- [調整] loaded 選項增加了個參數h,參數h表示窗口內容的jQuery對象,方便用戶在窗口加載後對內容進行初始化處理。

- [調整] 把全局設置放到獨立的js文件,統一放在目錄 i18n,目前只有jquery.jBox-zh-CN.js。

- [調整] 按空格鍵可直接執行默認按鈕提交的事件(爲保留此功能,按鈕爲焦點時不是很好看,但用戶體驗應該優先考慮)。

- [修復] 修復在IE下多窗口狀態切換時顯示不了的Bug。

 

使用方法:

  <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標準,確保html頂部加上下面這行

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://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裏默認的設置和jquery.jBox-zh-CN.js是一樣的,如果只想修改某幾個選項,例如窗口邊框,只需要一行代碼就可以:jBox.setDefaults({ defaults: { border: 8} });

 

喜歡jBox的朋友別忘了點一下[推薦]哦,3q

 

/* 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, /* 是否顯示窗口標題的圖標,true顯示,false不顯示,或自定義的CSS樣式類名(以爲圖標爲背景) */
showClose: true, /* 是否顯示窗口右上角的關閉按鈕 */
draggable: true, /* 是否可以拖動窗口 */
dragLimit: true, /* 在可以拖動窗口的情況下,是否限制在可視範圍 */
dragClone: false, /* 在可以拖動窗口的情況下,鼠標按下時窗口是否克隆窗口 */
persistent: true, /* 在顯示隔離層的情況下,點擊隔離層時,是否堅持窗口不關閉 */
showScrolling: true, /* 是否顯示瀏覽的滾動條 */
ajaxData: {}, /* 在窗口內容使用get:或post:前綴標識的情況下,ajax post的數據,例如:{ id: 1 } 或 "id=1" */
iframeScrolling: 'auto', /* 在窗口內容使用iframe:前綴標識的情況下,iframe的scrolling屬性值,可選值有:'auto'、'yes'、'no' */

title: 'jBox', /* 窗口的標題 */
width: 350, /* 窗口的寬度,值爲'auto'或表示像素的整數 */
height: 'auto', /* 窗口的高度,值爲'auto'或表示像素的整數 */
bottomText: '', /* 窗口的按鈕左邊的內容,當沒有按鈕時此設置無效 */
buttons: { '確定': 'ok' }, /* 窗口的按鈕 */
buttonsFocus: 0, /* 表示第幾個按鈕爲默認按鈕,索引從0開始 */
loaded: function (h) { }, /* 窗口加載完成後執行的函數,需要注意的是,如果是ajax或iframe也是要等加載完http請求才算窗口加載完成,參數h表示窗口內容的jQuery對象 */
submit: function (v, h, f) { return true; }, /* 點擊窗口按鈕後的回調函數,返回true時表示關閉窗口,參數有三個,v表示所點的按鈕的返回值,h表示窗口內容的jQuery對象,f表示窗口內容裏的form表單鍵值 */
closed: function () { } /* 窗口關閉後執行的函數 */
};

jBoxConfig.stateDefaults = {
content: '', /* 狀態的內容,不支持前綴標識 */
buttons: { '確定': 'ok' }, /* 狀態的按鈕 */
buttonsFocus: 0, /* 表示第幾個按鈕爲默認按鈕,索引從0開始 */
submit: function (v, h, f) { return true; } /* 點擊狀態按鈕後的回調函數,返回true時表示關閉窗口,參數有三個,v表示所點的按鈕的返回值,h表示窗口內容的jQuery對象,f表示窗口內容裏的form表單鍵值 */
};

jBoxConfig.tipDefaults = {
content: '', /* 提示的內容,不支持前綴標識 */
icon: 'info', /* 提示的圖標,可選值有'info'、'success'、'warning'、'error'、'loading',默認值爲'info',當爲'loading'時,timeout值會被設置爲0,表示不會自動關閉。 */
top: '40%', /* 提示離頂部的距離,可以是百分比或像素(如 '100px') */
width: 'auto', /* 提示的高度,值爲'auto'或表示像素的整數 */
height: 'auto', /* 提示的高度,值爲'auto'或表示像素的整數 */
opacity: 0, /* 窗口隔離層的透明度,如果設置爲0,則不顯示隔離層 */
timeout: 3000, /* 提示顯示多少毫秒後自動關閉,必須是大於0的整數 */
loaded: function (h) { } /* 窗口加載完成後執行的函數,參數h表示窗口內容的jQuery對象 */
};

jBoxConfig.messagerDefaults = {
content: '', /* 信息的內容,不支持前綴標識 */
title: 'jBox', /* 信息的標題 */
icon: 'none', /* 信息圖標,值爲'none'時爲不顯示圖標,可選值有'none'、'info'、'question'、'success'、'warning'、'error' */
width: 350, /* 信息的高度,值爲'auto'或表示像素的整數 */
height: 'auto', /* 信息的高度,值爲'auto'或表示像素的整數 */
timeout: 3000, /* 信息顯示多少毫秒後自動關閉,如果設置爲0,則不自動關閉 */
showType: 'slide', /* 信息顯示的類型,可選值有:show、fade、slide */
showSpeed: 600, /* 信息顯示的速度,可選值有:'slow'、'fast'、表示毫秒的整數 */
border: 0, /* 信息的外邊框像素大小,必須是0以上的整數 */
buttons: {}, /* 信息的按鈕 */
buttonsFocus: 0, /* 表示第幾個按鈕爲默認按鈕,索引從0開始 */
loaded: function () { }, /* 窗口加載完成後執行的函數 */
submit: function (v, h, f) { return true; }, /* 點擊信息按鈕後的回調函數,返回true時表示關閉窗口,參數有三個,v表示所點的按鈕的返回值,h表示窗口內容的jQuery對象,f表示窗口內容裏的form表單鍵值 */
loaded: function (h) { } /* 窗口加載完成後執行的函數,參數h表示窗口內容的jQuery對象 */
};

jBoxConfig.languageDefaults = {
close: '關閉', /* 窗口右上角關閉按鈕提示 */
ok: '確定', /* $.jBox.prompt() 系列方法的“確定”按鈕文字 */
yes: '是', /* $.jBox.warning() 方法的“是”按鈕文字 */
no: '否', /* $.jBox.warning() 方法的“否”按鈕文字 */
cancel: '取消' /* $.jBox.confirm() 和 $.jBox.warning() 方法的“取消”按鈕文字 */
};

$.jBox.setDefaults(jBoxConfig);

在線demo:http://www.kudystudio.com/jbox/jbox-demo.html

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章