DIV CSS 佈局教程網

讓多個頁面共用同一段 HTML 片段(續):外部 JS 的載入時序陷阱
編輯:關於JavaScript     

接續前文,這次把片段中的事件綁定搬到外部 JS 檔案,卻踩到一個很典型的時序問題。

一、先把片段拉回來

HTML 頁面:

<script type="text/javascript">
$(function() {
    $("#clickToInsert").click(function() {
        $.get("service.ashx?file=pages2_1.txt", function(data) {
            $("#placeholder").html(data);
        }, "text");
    });
});
</script>
<input type="button" id="clickToInsert" value="Insert HTML" />
<div id="placeholder"></div>

service.ashx 的後端:

public void ProcessRequest(HttpContext context)
{
    string filePath = context.Request["file"].ToString();
    string fileContent = String.Empty;
    using (StreamReader sr = new StreamReader(context.Server.MapPath(filePath)))
    {
        fileContent = sr.ReadToEnd();
    }
    context.Response.ContentType = "text/plain";
    context.Response.Write(fileContent);
}

pages2_1.txt:

<script type="text/javascript">
$(function() {
    var parent = $("#complex_page_segment");
    $(".previous", parent).click(function() {
        $(".content", parent).html("Previous Page Content");
    });
    $(".next", parent).click(function() {
        $(".content", parent).html("Next Page Content");
    });
});
</script>
<div id="complex_page_segment">
    <input type="button" value="Previous Page" class="previous" />
    <input type="button" value="Next Page" class="next" />
    <div class="content">Page Content</div>
</div>

二、把 JavaScript 抽成獨立檔案

片段裡的 JavaScript 一多,抽成外部 .js 讓瀏覽器快取是很自然的想法。

pages2_2.txt:

<script type="text/javascript">
$(function() {
    setup();
});
</script>
<script src="pages2_2.js" type="text/javascript"></script>
<div id="complex_page_segment">
    <input type="button" value="Previous Page" class="previous" />
    <input type="button" value="Next Page" class="next" />
    <div class="content">Page Content</div>
</div>

pages2_2.js:

function setup() {
    var parent = $("#complex_page_segment");
    $(".previous", parent).click(function() {
        $(".content", parent).html("Previous Page Content");
    });
    $(".next", parent).click(function() {
        $(".content", parent).html("Next Page Content");
    });
}

執行結果:直接報錯。

三、問題分析

錯誤訊息說 setup 未定義,但 Firebug 明明顯示 pages2_2.js 已經載入。那唯一的可能就是:setup 在 js 檔載入完成之前就被呼叫了。

可是我們的呼叫明明包在 $(function(){ }) 裡,理應等 DOM Ready 才執行——問題就出在這裡。透過 AJAX 取回片段的時候,整個頁面早已經 DOM Ready 了。因此在片段當中:

$(function() {
    setup();
});

與直接寫成下面這樣完全等價:

setup();

四、三種解法

解法一:把外部 JS 放在主頁面載入,不要塞進 AJAX 回傳的片段裡。

解法二:先用 JavaScript 動態載入外部 JS,載入完成後再取純 HTML 片段。pages2_3.htm:

<script type="text/javascript">
$(function() {
    $("#clickToInsert").click(function() {
        $.getScript("pages2_2.js", function() {
            $.get("service.ashx?file=pages2_3.txt", function(data) {
                $("#placeholder").html(data);
            }, "text");
        });
    });
});
</script>
<input type="button" id="clickToInsert" value="Insert HTML" />
<div id="placeholder"></div>

解法三:利用 JavaScript 順序執行的特性,把外部 JS 的引用放在片段最上方。pages2_4.txt:

<script src="pages2_2.js" type="text/javascript"></script>
<script type="text/javascript">
setup();
</script>
<div id="complex_page_segment">
    <input type="button" value="Previous Page" class="previous" />
    <input type="button" value="Next Page" class="next" />
    <div class="content">Page Content</div>
</div>

第三種解法乍看多此一舉,但當你有「不想讓每個頁面都各自載入這個 JS」或「呼叫方無從得知片段依賴哪些 JS」這類限制時,它的重要性就顯現出來了。

五、關於 JavaScript 的順序執行特性

用一個實驗說明:

<html>
<head>
<title></title>
<script src="js1.js" type="text/javascript"></script>
<script src="js2.js" type="text/javascript"></script>
<script type="text/javascript">
console.log("after js2:" + new Date().toLocaleTimeString());
</script>
</head>
<body></body>
</html>

js1.js(中間是一段刻意拖慢的長程式碼):

console.log("start load js1:" + new Date().toLocaleTimeString());
// ...很長很長的一段 JavaScript
console.log("end load js1:" + new Date().toLocaleTimeString());

js2.js:

console.log("load js2:" + new Date().toLocaleTimeString());

Firebug 的記錄如下:

可以看到,雖然 js2.js 更早被下載完成,但執行仍舊必須等 js1.js 跑完才開始。這就是 JavaScript 順序執行的特性,也是前面三種解法背後共同的依據。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved