Struts 2 單 Form 多圖片提交按鈕實戰指南

場景

一個表單包含多個操作按鈕（如「新增」「修改」「查詢」），需對應同一 Action 的不同方法，且提交前執行 JavaScript 校驗。

核心配置

1. Form 標籤指定命名空間

<s:form namespace="/system/usermanager">

2. 圖片提交按鈕完整屬性

<s:submit
    type="image"
    id="FIND"
    value="FIND"
    label="按指定條件檢索用戶信息"
    src="/issframe/images/btn/btn_find.jpg"
    cssClass="button_image"
    onclick="return CheckInputForRequired();"
    action="user"
    method="doSearch"
/>

關鍵屬性解析

• type="image"：渲染為 <input type="image">，顯示圖片按鈕。
• onclick="return CheckInputForRequired();"：務必加 return，若 JS 返回 false 則阻止提交。
• action="user"：對應 struts.xml 中的 Action name（不含通配符）。
• method="doSearch"：Action 類中的具體方法名。

Struts.xml 動態方法映射範例

<action name="user_*" class="com.system.action.ManagerUserAction" method="{1}">
    <result name="success">/userList.jsp</result>
</action>

此處 user_* 中的 * 會被 method="{1}" 捕獲，對應按鈕的 method 屬性值（如 doSearch），實際調用 ManagerUserAction.doSearch()。

測試環境

• Struts 2.1.2
• Tomcat 5.5.26
• MyEclipse 6

最佳實踐提示

1. 統一按鈕 id、value 便於前端 JS 選取。
2. label 屬性生成 alt 文字，提升無障礙性。
3. JS 校驗函數返回 true/false，配合 return 控制流程。
4. 若需傳遞額外參數，可在按鈕內嵌套 <s:param>。