當組織已開始採用 XSLT 2.0 處理器,但既有樣式表仍大量使用 1.0 寫法時,過渡期的重點不是急著全部重寫,而是讓新舊程式碼能在同一套執行環境中安全共存。XSLT 2.0 規範保留了向後兼容模式,讓支援此特性的處理器能以接近 1.0 的行為執行舊程式碼。不過,這並非所有 2.0 處理器都必須具備的能力,因此在規劃遷移時,仍應先確認目標處理器的支援程度。
向後兼容模式主要解決兩類常見問題:第一,當某個運算式或指令預期得到單一值,但實際得到多個項目時,1.0 會自動取第一個項目;第二,1.0 在型別轉換上較為寬鬆,而 2.0 對型別更嚴格,容易拋出錯誤。BC 模式可讓舊有行為在過渡期內保持穩定。
例如,xsl:value-of 在 1.0 中若選到多個節點,只會輸出第一個;在 2.0 中若未啟用 BC,則可能輸出以空白分隔的多個值。又例如,將字串與數字比較時,1.0 可能自動轉換,2.0 則可能視為型別錯誤。BC 模式能讓這些差異暫時回到舊行為,降低一次性升級的風險。
所謂版本島,是指在樣式表中以版本屬性標示出某段程式碼應以特定版本規則處理。最常見的是在 2.0 樣式表中嵌入 1.0 島,讓該段程式碼進入 BC 模式;也可能在 1.0 樣式表中嵌入 2.0 島,讓新處理器以向前兼容方式執行。
版本島可以出現在樣式表模組、模板,甚至單一指令上。這樣的設計讓遷移不必一次到位,而是能逐步把高風險或高價值的區塊分離出來。不過,若版本屬性嵌套過多,會讓行為變得難以追蹤,因此實務上通常建議以清楚的模組邊界取代過度細碎地標記版本。
BC 模式最常被注意到的影響,包括 xsl:value-of 是否只取第一個項目、函數參數是否自動轉換型別、屬性值模板是否只取序列首項,以及比較運算式與算術運算式的型別處理。這些行為若在舊樣式表中被依賴,BC 模式能顯著減少錯誤。
然而,BC 並非萬能。某些 2.0 的變更仍可能導致錯誤,例如部分靜態檢查變得更嚴格、某些原本可通過的語法現在不再合法,或輸出建構必須更符合規範。遷移時仍應搭配測試,而不是單靠 BC 模式掩蓋所有差異。
如果舊樣式表只是需要小幅度調整,可以把包含舊行為的模板標示為 1.0 島,讓該模板在 BC 模式下執行。若某個變數或指令涉及多值序列或型別轉換,也可在該元素上設定版本,以保留舊行為。這種做法適合短期過渡,但長期而言,仍建議把關鍵邏輯改寫成不依賴 BC 的 2.0 寫法。
若團隊同時使用多個 2.0 處理器,且其中某些不支援 BC,則可利用 use-when 這類條件屬性,在編譯階段篩選出不適用的程式碼。這樣可避免不支援 BC 的處理器在遇到 1.0 島時直接報錯。
遷移過程中,樣式表的結構往往也需要調整。1.0 時代常把所有宣告集中在主樣式表,但隨著版本島與功能模組增加,將宣告移至與其使用位置相近的模組,反而更容易維護。例如,把某個鍵的宣告與使用該鍵的模板放在同一模組,未來若要調整型別或比對規則,影響範圍會更清楚。
序列化設定也值得檢查。2.0 對輸出提供更多控制,例如不同的輸出方法與字元映射。若樣式表會產生多種輸出格式,可考慮使用具名輸出宣告,讓不同結果各自套用適當的序列化規則。
BC 模式適合過渡,不適合長期依賴。當相關程式碼已經被測試涵蓋,且團隊對 2.0 的型別與序列行為足夠熟悉時,就應逐步移除不必要的版本島。例如,原本依賴 BC 自動取首項的運算式,可明確加上位置謂詞;原本依賴自動型別轉換的地方,可改用明確的轉換函數。
這樣做的好處是,樣式表會變得更可讀、更可預測,也更容易在未來升級時重用。版本屬性若被濫用,會讓維護者難以判斷某段程式碼到底遵循哪一套規則;反之,清楚的模組邊界與明確的型別寫法,才是長期穩定的基礎。
從 1.0 過渡到 2.0,BC 模式與版本島提供了實用的緩衝機制,讓團隊能以降低風險的方式逐步遷移。但真正的升級目標,不是讓舊行為永遠保持不變,而是讓樣式表能更清楚地表達資料流、型別與轉換規則。當舊程式碼被逐步整理成符合 2.0 思維的寫法,系統的可維護性與可擴充性也會一併提升。