插件優勢
- **極簡 API**:單行代碼啟動模態層。
- **全瀏覽器支援**:Chrome/Firefox/IE7+ 完美運行 (含 IE7/8 無 CSS3 降級)。
- **靈活定位**:`centered: true` 自動垂直水平置中。
- **事件鉤子**:`onLoad`、`onClose` 回調支援焦點管理、動畫協調。
- **零 CSS 依賴**:樣式完全由開發者控制,無污染。
官方資源
快速開始
1. 引入檔案
<script src="jquery-1.7.2.min.js"></script>
<script src="jquery.lightbox_me.js"></script>
2. HTML 彈窗結構 (預設隱藏)
<div id="loginbox" style="display:none;">
<div class="loginbox-title">用戶登錄</div>
<form>
<table>
<tr><th>帳號</th><td><input type="text" name="user" /></td></tr>
<tr><th>密碼</th><td><input type="password" name="pass" /></td></tr>
</table>
</form>
<div class="loginbox-footer">
<button id="cancel" type="button">取消</button>
<button id="submit" type="submit">登錄</button>
</div>
</div>
<button id="login">點擊登錄</button>
3. CSS 樣式 (自定義)
#loginbox { width: 400px; background: #fff; border: 1px solid #ccc; padding: 10px; }
.loginbox-title { background: #eef2f7; border-bottom: 1px solid #ccc; padding: 8px; font-size: 14px; font-weight: bold; text-align: center; }
.loginbox-footer { padding: 8px; border-top: 1px solid #ccc; text-align: center; background: #eef2f7; }
.loginbox-footer button { padding: 5px 18px; margin: 0 5px; }
body { font: 12px/1.5 "Microsoft JhengHei", sans-serif; }
4. JS 啟動邏輯
$(function() {
// 打開彈窗
$('#login').click(function(e) {
e.preventDefault();
$('#loginbox').lightbox_me({
centered: true, // 視窗置中
onLoad: function() { // 彈窗顯示後回調
$('#loginbox').find('input:first').focus(); // 聚焦首個輸入框
}
});
});
// 關閉彈窗
$('#cancel').click(function() {
$('#loginbox').trigger('close'); // 觸發關閉事件
});
// 表單提交 (範例)
$('#loginbox form').submit(function(e) {
e.preventDefault();
alert('提交: ' + $(this).serialize());
$(this).trigger('close');
});
});
進階選項速查
| 選項 | 類型 | 預設 | 說明 |
| centered | Boolean | false | true=垂直水平置中 |
| overlayCSS | Object | {background:'black', opacity:0.7} | 遮罩層樣式 |
| closeEsc | Boolean | true | Esc 鍵關閉 |
| closeClick | Boolean | true | 點擊遮罩關閉 |
| modalCSS | Object | {top:'50%', left:'50%'} | 模態框初始 CSS (centered:true 時自動計算) |
| onLoad | Function | null | 彈窗顯示後觸發 |
| onClose | Function | null | 彈窗關閉後觸發 |
| destroyOnClose | Boolean | false | 關閉時銷毀 DOM (慎用) |
常見問題與解決
- IE7/8 定位偏移:確保 `` 標準模式;`html, body { height: 100%; }`。
- z-index 衝突:插件自動計算高 z-index,若被覆蓋請檢查頁面其他 `z-index: 9999+` 元素。
- 多重彈窗:同時只能開一個。需求多層彈窗請手動管理隊列或改用功能更完整的插件 (如 Magnific Popup、Bootstrap Modal)。
- 內容動態載入:`onLoad` 中用 AJAX 載入內容並 `$(content).appendTo('#loginbox')`。
現代替代方案對比
| 插件 | 依賴 | 體積 | IE 支援 | 功能豐富度 | 維護狀態 |
|------|------|------|---------|------------|----------|
| **lightbox_me** | jQuery | 3KB | IE7+ | 基礎模態 | 低 (2015年後無更新) |
| **Magnific Popup** | jQuery | 20KB | IE8+ | 圖庫、AJAX、Iframe、動畫 | 中 |
| **Bootstrap Modal** | jQuery+Bootstrap | 含框架 | IE9+ | 完整組件生態 | 高 (v5 移除 jQuery) |
| **SweetAlert2** | 無 | 40KB | IE11+ | 美觀、Promise、隊列、主題 | 高 |
| **原生 `