在實際專案中,樣式表往往不會只跑在單一處理器上。有些環境仍使用 XSLT 1.0,有些則已導入 2.0,甚至未來可能出現更高版本。若希望同一份樣式表能在不同處理器版本中運作,就必須理解向前兼容、向後兼容,以及各種條件篩選工具的界線。
XSLT 1.0 在設計時已預留未來擴充空間。當樣式表版本高於處理器版本時,處理器可進入向前兼容模式,對未知的屬性與宣告層元素採取較寬鬆的態度。這代表 1.0 處理器遇到某些 2.0 元素時,不一定立即失敗,而是可能忽略或依 fallback 機制處理。
不過,向前兼容並非無限制。若未知元素出現在不該出現的位置,或涉及執行語意,仍可能產生錯誤。因此,跨版本樣式表通常仍需搭配明確的分支邏輯,而不是單純依賴處理器寬容。
use-when 是 2.0 中非常實用的條件屬性。它能在樣式表編譯階段判斷某段程式碼是否納入,適合用來區分不同處理器版本或功能可用性。例如,可依處理器版本決定要執行 1.0 或 2.0 的分支,也可依某個擴充函數是否存在來決定是否採用。
但要注意,1.0 處理器不認得 use-when。若樣式表整體仍標示為 1.0,1.0 處理器可能直接報錯;若希望 1.0 忽略它,通常需要讓樣式表處於向前兼容狀態,例如把版本設為高於 1.0,並確保未知屬性不會造成致命錯誤。
跨版本程式碼常需要知道目前處理器版本。此時可使用 system-property('xsl:version')。在 1.0 中,它能回報處理器版本;在 2.0 中,也可用來判斷是否進入特定分支。若再搭配 function-available() 與 element-available(),就能判斷某個函數或指令是否可用,進而選擇替代路徑。
這種做法特別適合處理擴充函數。例如,某個計算在 2.0 中有內建函數,在 1.0 中卻只能以命名模板或不同擴充函數完成。透過可用性測試,樣式表可在支援時走快速路徑,不支援時走相容路徑。
另一種常見策略是利用 xsl:import 與導入優先級。當多個模組定義相同名稱的模板或函數時,優先級較高者會被選用。這讓團隊能把 1.0 與 2.0 版本分置於不同模組,再由主樣式表依需要組合。
這種方法很適合逐步遷移。例如,主模組維持 1.0 相容,匯入一個包含 2.0 專用邏輯的模組;1.0 處理器只會看到可安全忽略的部分,2.0 處理器則可選用新版本。相較於在單一檔案中塞滿條件分支,模組化通常更清楚,也更容易測試。
對於 2.0 新增的指令,若希望 1.0 處理器也能安全通過,可使用 xsl:fallback。當處理器不支援該指令時,會改為執行 fallback 內的內容。這在處理例如新增輸出或命名空間相關指令時特別有用。
不過,若某個 1.0 既有指令在 2.0 中新增了屬性或子元素,1.0 處理器未必能正確理解。例如,某些原本必須使用 select 屬性的地方,在 2.0 中可能改用序列建構子;若直接採用新寫法,1.0 可能無法得知該如何取值。因此,這類差異通常需要透過版本島或替代模板來隔離。
宣告層的差異也需留意。2.0 新增了若干宣告,例如函數宣告、字元映射與模式匯入。1.0 處理器通常會忽略未知宣告,但若後續程式碼依賴這些宣告的結果,仍可能出錯。因此,跨版本設計時,最好把新宣告與使用它的程式碼放在同一個可篩選的區塊中。
輸出設定也是常見的相容重點。2.0 提供新的輸出方法與序列化屬性,例如 XHTML 輸出、字元映射、BOM 控制等。若希望 1.0 與 2.0 都能運作,通常需要在主模組保留 1.0 可理解的輸出設定,再於 2.0 專用模組中提供增強版本,透過具名輸出或條件篩選套用。
並非所有 2.0 特性都適合與 1.0 混用。像序列、型別敏感運算、分組、函數宣告、通道參數等,往往需要較大的語意變更,很難只靠單一屬性篩選。這類功能通常應放入明確的 2.0 島,並以模板或模組為邊界。
反之,若新功能只是小幅增強,例如某個字串函數或輸出屬性,則可用較輕量的方式處理。判斷標準在於:若 1.0 處理器即使忽略該元素仍能維持正確語意,混用風險較低;若忽略後會導致資料遺失、型別錯誤或流程中斷,就必須嚴格隔離。
跨版本相容不只是為了 1.0 與 2.0,也是為更高版本做準備。只要樣式表持續標示版本,並以模組化方式分隔不同功能,未來面對新處理器時,就能更容易決定哪些區塊需要調整。與其依賴隱晦的向後兼容技巧,不如建立清楚的版本邊界與測試策略。
實務上,最穩健的做法通常是:以模組切分功能,以條件屬性處理版本差異,以明確型別與運算式取代模糊的自動轉換,並保留可回溯的測試案例。如此一來,樣式表即使歷經多次升級,仍能維持可讀、可測與可維護。
讓樣式表相容於不同處理器版本,並不是尋找單一神奇設定,而是綜合運用向前兼容、條件篩選、可用性測試、模組優先級與回退機制。當這些工具被放在正確的位置,樣式表就能在過渡期同時服務舊環境與新環境,並為後續升級累積更低的成本。