Bootstrap 是一個相當優秀的前端框架,但在實際使用中難免會遇到各種各樣的坑。這裡記錄幾個曾經碰到過的問題以及排查過程。
1. modal 模態框被遮罩遮住的問題
有時候彈出模態框時,遮罩反而把模態框擋住了。
出現這個問題,多半是模態框的 HTML 代碼放置位置不對。翻閱官方文檔可以看到這樣的說明:
模態框的 HTML 代碼放置的位置
務必將模態框的 HTML 代碼放在文檔的最高層級內(也就是盡量作為 body 標簽的直接子元素),以避免其他組件影響模態框的展現和功能。
如果因為某些原因實在沒法放到最高層級,也可以事後把它移動過去。用 jQuery 只需一行:
$(".modal").appendTo("body");
這個問題提醒我們:文檔真的很重要。
2. Bootstrap 與地圖 API 衝突導致地圖顯示不出來
在使用 Bootstrap(尤其是其變體 ZUI)的同時引入地圖 API 時,可能會出現樣式衝突,導致地圖或地圖內的控件無法正常顯示。由於 Bootstrap 自帶大量 CSS,很容易和地圖 API 打架。我之前用天地圖 WebAPI 搭配 ZUI 時就遇到過地圖加載不出來的情況。
排查過程:
1. 打開浏覽器開發者工具,先看 console 有沒有報錯——沒有。再看 network 裡地圖相關的圖片資源有沒有加載——有。
2. 把地圖調用代碼從項目中剝離出來單獨運行,看能否正常顯示——能。
3. 回到項目,用二分法一半一半地刪除引用的 js、css,判斷是哪個文件影響了天地圖 API,最終鎖定問題出在 zui.css。
4. 在 elements 面板核對地圖那個 div 下的 CSS,最後發現是這一句:
audio, canvas, img, svg, video { max-width: 100%; vertical-align: middle; }
問題迎刃而解:ZUI 與天地圖 WebAPI 的衝突正是出在 max-width:100% 上。把它改為 max-width:none;,地圖便成功顯示。當然,並不是直接去改源碼,而是在對應 div 下把這個屬性覆蓋掉即可。
後來做行運行軌跡時,又發現標注 Marker 和線 line 顯示不出來。對比正常情況並在控制台查詢後確認:標注和線其實已經加載,只是沒能成功顯示,根源仍是 svg,同樣受上面那句樣式影響,改過之後就正常了。
3. ZUI 數據表格初始化不正常(datatable.js)
ZUI 自帶一個強大的數據表格插件,可以對表格首列進行排序。按官方文檔說法,只要這一句就能初始化並正常排序:
$('table.datatable').datatable({sortable: true});
但同事使用時發現這句話毫無作用,完全沒有達到示例中的排序效果,於是問題交到了我手上。
起初懷疑是接口調用不對,可我自己試了 likewise 也沒用。繼續翻接口,發現還有另一種初始化方式,需要自己把數據拼成數組傳進去:
/* 使用啟動參數選項來初始化數據 */ $('table.datatable').datatable({ data: { cols: [ {width: 80, text: '#', type: 'number', flex: false, colClass: 'text-center'}, {width: 160, text: '時間', type: 'date', flex: false, sort: 'down'}, {width: 80, text: '名稱', type: 'string', flex: true, colClass: ''} ], rows: [ {checked: false, data: [1, '2016-01-18 11:05:15', '名稱示例1']}, {checked: false, data: [2, '2016-01-20 12:06:16', '名稱示例2']}, // 更多數據 ] }, // 其他啟動參數選項 });
我照着拼了一份,發現可以正常初始化,達到預期效果。但如果每次都要手工拼這麼一大坨數組,顯然不划算。問題到底出在哪裡?
於是下斷點跟進源碼,發現兩種方式的差別就在於一個有 data 傳入、一個沒有。而在源碼裡,對於沒有 data 的情況,它會根據表格內容自行生成 data。
於是我把它生成的 data 用 console.log(JSON.stringify(data)) 打印出來,再用第二種方式傳入 data 初始化,結果卻不能正常工作。問題就此鎖定在這個「生成的 data」上。
對比示例中的 data 和生成的 data,發現二者竟然不一樣:示例中每一行的數據是一個數組,裡面直接裝著每個格子的內容(純量);而生成的 data,每一行是數組包含著每個格子的對象,對象裡又嵌套了一些信息。此外表頭數據也有一些差異。
於是按照示例的數據要求來修改源碼。把:
cols.push($.extend( { text: $th.html(), flex: false || $th.hasClass('flex-col'), width: 'auto', cssClass: $th.attr('class'), css: $th.attr('style'), type: 'string', ignore: $th.hasClass('ignore'), sort: !$th.hasClass('sort-disabled'), mergeRows: $th.attr('merge-rows') }, $th.data()));
改為:
$t.find('thead > tr:first').children('th').each(function() { $th = $(this); cols.push($.extend( { text: $th.html(), flex: false || $th.hasClass('flex-col'), width: 'auto', cssClass: $th.attr('class'), colClass: $th.attr('class'), css: $th.attr('style'), type: 'string', ignore: $th.hasClass('ignore'), sort: !$th.hasClass('sort-disabled') }, $th.data())); });
再把:
row.data.push($.extend( { cssClass: $td.attr('class'), css: $td.attr('style'), text: $td.html(), colSpan: colSpan }, $td.data()));
改為:
row.data.push($td.html());
測試:
$('table.datatable').datatable({sortable: true});
成功初始化,排序正常,表格 CSS 也正常,問題初步解決。
附:ZUI 文檔:https://zui.sexy/
bootstrap 文檔:https://v3.bootcss.com/javascript/
做前端的難免遇到各種各樣的問題,不要慌,一步步來。掌握了科學系統的發現問題和解決問題的方法,就能很快鎖定並解決問題了。以上就是這篇文章的全部內容,希望大家多多支持。