Bootstrap 的 Modal(模態框)預設是固定在畫面中央的,無法拖動。當內容比較長、或需要對照背景資訊時,能自由移動視窗會方便很多。主管提出這個需求後,我用一段擴充腳本解決了它。
思路是保留 Bootstrap 原本的 modal 行為,只在初始化時額外綁定移動事件。監聽 modal-header 上的 mousedown 作為拖曳起點,在文件層追蹤 mousemove 來更新 dialog 的 offset,最後以 mouseup 結束拖曳。
以下這段程式要在 Bootstrap 初始化之後執行:
// bootstrap 模態框視窗移動擴充,在 bootstrap 初始化後呼叫
var btModalMoveEx = function () {
function moveEx($this) {
var $head = $this.find(".modal-header"),
$dialog = $this.find(".modal-dialog");
var move = { isMove: false, left: 0, top: 0 };
$this.on("mousemove", function (e) {
if (!move.isMove) return;
$dialog.offset({ top: e.pageY - move.top, left: e.pageX - move.left });
}).on("mouseup", function () {
move.isMove = false;
});
$head.on("mousedown", function (e) {
move.isMove = true;
var offset = $dialog.offset();
move.left = e.pageX - offset.left;
move.top = e.pageY - offset.top;
});
}
var old = $.fn.modal;
$.fn.modal = function (o, _r) {
var $this = $(this);
// 標識是否已綁定過移動事件,用於防止重複綁定
if ($this.attr("isbindmv")) return old.call(this, o, _r);
$this.attr("isbindmv", "1");
moveEx($this);
return old.call(this, o, _r);
};
};
再補一段 CSS,讓滑鼠移到標題列時游標變成移動樣式,使用者才知道這裡可以拖:
.modal[isbindmv] .modal-header { cursor: move; }
之後照原本的方式呼叫 modal 即可,擴充會自動生效:
$('#editModal').modal({ backdrop: 'static' });
腳本裡有兩處值得留意。第一,覆寫 $.fn.modal 時先把原函式存進 old,呼叫時再交回給它,確保 Bootstrap 自身的顯示、隱藏、backdrop 等邏輯完全不受影響。第二,用 isbindmv 這個自訂屬性做「是否已綁定」的標記,避免同一個元素每次開啟都重複綁一次 mousedown,那會導致拖曳速度異常。
如果 modal 的內容高度會超過視窗,還可以進一步加上 max-height 與 overflow-y: auto,讓視窗內部滾動而不是撐出畫面。