如何在多个页面使用同一个HTML片段《续》

上一篇文章中我们使用textarea来模拟AJAX的返回结果，造成了一些误解。

这里我们首先用asp.net的Generic Handler做一个简单的后台来重现这个AJAX过程。
1. 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>
    

2. 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);
    }
    

3. 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>
    

将HTML片段中的JavaScript提取为一个文件
这也是自然而然就想到的，特别是HTML片段中JavaScript代码比较多的情况下，
提取为一个JS文件，让浏览器帮忙缓存不失为一种好方法。
1. 重新定义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>
    

2. 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");
        });
    }
    

3. 运行，居然报错！ 




问题分析
错误信息是 setup 这个函数没有定义，但是从Firebug中我们明显看到pages2_2.js的确被加载了。
那个极有可能是在 pages2_2.js 加载之前就调用了 setup 这个函数。
但是我们的setup 函数调用是放在jQuery的 $(function(){ }) 之中的，也就是在页面加载完毕才调用的。

其实现在问题已经很明显了，在AJAX返回页面片段的时候，整个页面是已经加载完成了，也就是DOM Ready。
所以在页面片段中：

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

和下面直接调用是等价的：

    setup();
    

解决问题
对于这个问题，我们有三种解决办法。
1. 将外部JS文件在页面中加载，而不是在AJAX返回的HTML片段。

2. 我们可以通过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>
    

3. 利用JavaScript在页面上是顺序加载的特性，将HTML片段中外部JS引用放在最上面

pages2_4.htm：

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

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文件
• 调用者不知道一个HTML片段关联哪些JS文件

============================================================
关于JS的顺序执行特性
可能有人对这个特性并不是很清楚，我就通过一个例子来说明。

    <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，有12M之多
    console.log("end load js2:" + new Date().toLocaleTimeString());
    

js2.js:

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

我们来看下Firebug的记录： 
 

 



可以看到，虽然js2.js更早的被加载，但是还是js1.js执行结束之后，才开始执行js2.js。

源代码下载