DIV CSS 佈局教程網

include 標籤導致 jQuery 找不到?相對路徑在共用頁面裡的陷阱
編輯:JavaScript綜合知識     

把常用 JS 抽到一個共用 JSP 裡,然後各頁 include 它——這個思路完全正確,但如果你在共用檔裡寫的是相對路徑,幾乎一定會出問題。這裡還原整個排查過程。

先釐清兩種 include 的差別

<jsp:include> 是「先編譯被包含檔,再把輸出結果插入」,屬於執行期包含。<%@ include %> 是「先把檔案內容貼進來,再一起編譯」,屬於編譯期包含。就本文討論的路徑問題而言,兩者的行為一致——關鍵都不在 include 本身。

現場:共用頁單獨跑正常,被包含就失效

共用 JSP 裡寫的是:

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<script type="text/javascript" src="js/jquery132min.js"></script>
<script type="text/javascript">
$(function(){ alert('hello1'); });
</script>

直接開這個 JSP,一切正常。但在另一個頁面用 <%@ include file="../../common_ext.jsp"%> 引入後,jQuery 就死活載不進來,alert 也不跳。一開始我還懷疑是 script 的載入順序,折騰了一陣子才發現完全不是那回事。

真正的原因

相對路徑 js/jquery132min.js 是相對於「瀏覽器網址列上那個 URL」解析的,不是相對於檔案在專案裡的位置。當共用檔被 include 進 /admin/order/list.jsp,瀏覽器請求的其實是 /admin/order/js/jquery132min.js——這個路徑下根本沒有檔案。

換句話說,共用檔把相對路徑「原封不動」交給了呼叫者,而呼叫者的目錄層級跟共用檔不同,路徑就斷了。專案裡檔案分布在多層目錄時,這個問題必然發生。

解法:在共用檔裡改用絕對路徑

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%
String tPath = request.getContextPath();
String tBasePath = request.getScheme() + "://" + request.getServerName()
                 + ":" + request.getServerPort() + tPath + "/";
%>
<script type="text/javascript" src="<%=tBasePath%>js/jquery132min.js"></script>
<script type="text/javascript">
$(function(){ alert('hello1'); });
</script>

這樣不管共用檔被誰 include,路徑都從應用程式根目錄算起。更簡潔的寫法是用 JSTL 或 Spring 的標籤:

<script src="${pageContext.request.contextPath}/js/jquery132min.js"></script>

另一個更省事的做法:用 <base>

在 <head> 最前面宣告基準路徑,頁面內所有相對連結都改以它為起點:

<base href="<%=tBasePath%>" />

不過 <base> 會連 #anchor 連結一起影響,用之前先確認頁面上沒有依賴錨點的行為。

結論

共用頁面裡一律使用絕對路徑(以 context path 為基準)。這不只是為了避開 include 的問題,也是因為共用檔天生就無法預知自己會被放在多深的目錄被呼叫——它本來就該假設最壞的情況。

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