做前端模塊化時,大家的注意力通常都在 JS 上,但其實 HTML 片段同樣需要被管理起來。本文介紹如何用 RequireJS 加 text 插件把 HTML 也模塊化。
RequireJS 有一個官方 text 插件,它能讀取指定文件的內容,讀回來的就是純文本。對於 HTML 片段來說,這恰好是我們需要的。
第一種方式,用 npm 安裝:
npm install requirejs/text
第二種方式,直接去官方 GitHub 倉庫下載源碼,把內容拷進 text.js 即可。
在 main.js 裡像配置其他依賴一樣加上 text 的路徑就行,只要保證能通過正常方式加載到:
requirejs.config({ baseUrl: './', paths: { 'text':path+'/require/text', ... }, shim: { ... } });
如果文件就放在 baseUrl 目錄下,甚至可以不配。
在目標模塊中,寫法有兩種:
define(function(require){ var html = require("text!html/test.html"); console.log(html); });
或者放在依賴數組裡:
define(["text!html/test.html"],function(html){ console.log(html); });
那個感嘆號是插件語法的標記,後面跟需要加載的文件路徑。
會用 text 之後,剩下的問題就是怎麼組織代碼。舉個例子。
假設要做一個單頁應用,頂部導航切換不同內容區。最樸素的思路是:每個按鈕對應一個 div,點誰就顯示誰,其他隱藏。代碼大概長這樣:
<html> <body> <nav> 導航按鈕1、導航按鈕2、導航按鈕3 </nav> <div style="display:block">按鈕1對應的頁面</div> <div style="display:none">按鈕2對應的頁面</div> <div style="display:none">按鈕3對應的頁面</div> </body> </html>
頁面一多,這份 HTML 會迅速膨脹到難以維護——所有內容都堆在一個文件裡,改一小塊要在幾百行裡翻半天。
有了 text 插件,結構可以變成這樣:
<html> <body> <nav> 導航按鈕1、導航按鈕2、導航按鈕3 </nav> <div id="target"></div> </body> </html>
然後在對應模塊裡按需填充:
$('#target').html(require("text!目標按鈕對應的頁面.html"));
主文件瞬間清爽了,每個 HTML 片段跟著自己的模塊走,維護邊界也清楚了。
這種做法有個坑:用 html() 替換內容之後,原本綁定在這些元素上的 jQuery 事件會全部失效,因為 DOM 節點已經被換成了新的一批。
所以務必在 html() 調用之後重新綁定事件,或者改用事件委託——把監聽掛到不會被替換的父元素上,這樣會省心很多。
以上就是關於在 HTML 中使用 RequireJS 做模塊化開發的相關知識,希望對你有所幫助。