在 Struts2 中,若希望 checkboxlist 標籤輸出的 input 帶有 class,但發現畫面沒有套用,通常要檢查 checkboxlist.ftl 是否支援 cssClass 參數。
部分版本的 checkboxlist 模板在產生 input 時,並未把 cssClass 轉成 HTML 的 class 屬性,因此即使頁面設定了 cssClass,最終仍看不到效果。
可在 checkboxlist.ftl 的 input 屬性區加入 FreeMarker 條件:先判斷 parameters.cssClass 是否存在,若存在就輸出 class 屬性,值使用 parameters.cssClass 並做 HTML 轉義。
parameters.cssClass 存在時,輸出 class="${parameters.cssClass?html}"
修改後,重新打包或放入正確的模板目錄,讓 Struts2 載入新的 checkboxlist.ftl。若專案有多個主題目錄,也要確認實際使用的模板位置。
這個做法能讓 checkboxlist 產生的核取方塊套用自訂樣式,方便與表單整體視覺保持一致。