Struts html:checkbox 預設勾選解決方案與最佳實踐

問題背景

使用 Struts `` 標籤時，若要讓核取方塊預設為勾選狀態，FormBean 中對應屬性的值必須等於標籤指定的 `value` 值。Struts 內建將 `"on"`、`"yes"`、`"true"` 視為勾選值。

基本設定範例

FormBean

public class CheckBoxForm extends ActionForm {
    private String id = "on";  // 預設勾選
    // private String id = "";  // 預設不勾選

    public String getId() { return id; }
    public void setId(String id) { this.id = id; }
}

JSP 頁面

<html:checkbox property="id">CheckBox</html:checkbox>
<!-- 渲染為 -->
<input type="checkbox" name="id" checked="checked">CheckBox</input>

Action 中判斷邏輯

if ("on".equals(form.getId())) { /* 勾選 */ }
else if ("".equals(form.getId())) { /* 未勾選 */ }

進階場景：頁面首次載入勾選、提交後保持狀態

問題

若在 FormBean 初始化屬性為 `true`（或 `"on"`），Struts 在每次請求處理前會呼叫 `reset()` 方法將屬性重置為 `false`，導致首次進入頁面時核取方塊不會被勾選。

解決方案：隱藏欄位強制提交

在 checkbox 後方加入同名、值為 `"false"` 的隱藏欄位，強迫 Struts 在表單提交時重新設定屬性值：

<html:checkbox property="syaken"/>
<input type="hidden" name="syaken" value="false">

原理

• 未勾選時：瀏覽器只提交隱藏欄位 `syaken=false`，Struts 設定屬性為 `"false"`。
• 勾選時：瀏覽器提交 `syaken=on`（checkbox）與 `syaken=false`（hidden），Struts 依照標準處理，後發送的值通常會覆蓋，或由框架邏輯判定為勾選。

最佳實踐建議

1. 屬性型別優先使用 `boolean`，搭配 `reset()` 方法在 `reset()` 中根據業務邏輯決定初始值（如從 Session/資料庫讀取）。
2. 若必須用 String，未勾選時設為 `""` 而非 `null`，避免 Action 判斷時拋出空指標異常。
3. 複雜表單狀態管理建議改用前端框架（Vue/React）配合 REST API，減少伺服端模板邏輯。