在 JSF 應用中,關鍵操作(刪除、提交含附件郵件)前彈出確認框是標準交互。本文展示如何在 JSF 命令組件中優雅集成 confirm(),處理事件鏈、AJAX 與傳統提交的差異。
<h:commandButton id="sendBtn" value="發送" action="#{mailBean.send}">
<f:ajax execute="@form" render="@form" />
</h:commandButton>
<script>
// 頁面加載後綁定(或用 h:outputScript target="body")
document.addEventListener('DOMContentLoaded', function() {
var btn = document.getElementById('form:sendBtn'); // JSF 客戶端 ID
if (!btn) return;
// 保存原有 onclick(JSF 生成的 AJAX/提交邏輯)
var originalOnClick = btn.onclick;
btn.onclick = function(event) {
// 1. 業務邏輯判斷
var content = $('#form\\:content').val(); // 注意 JSF ID 轉義
var hasAttachment = $('#form\\:attachment').val();
if (content.indexOf('附件') !== -1 && !hasAttachment) {
// 2. 彈出確認框
if (!confirm('您的郵件內容提到附件,但您可能忘記了添加附件。確定仍要發送?')) {
return false; // 取消:阻止後續事件(含 JSF AJAX/提交)
}
}
// 3. 確認:執行原有邏輯
if (originalOnClick) {
return originalOnClick.call(this, event);
}
return true;
};
});</script>
h:commandButton + f:ajax 生成類似:
onclick="mojarra.ab(this,event,'action',0,'@form','@form');return false"
直接覆蓋 onclick 會丟失 AJAX 行為,必須保存原函數並在確認後調用。
<h:commandButton id="submitBtn" value="提交" action="#{bean.submit}" />
// 生成: onclick="document.forms['form'].submit();return false"
// 同樣需保存並調用原 onclick
var original = btn.onclick;
btn.onclick = function(e) {
if (!confirm('確定提交?')) return false;
return original.call(this, e);
};
<p:commandButton id="pfBtn" value="PF提交" action="#{bean.submit}" onclick="return confirm('確定?')" />
// PrimeFaces 原生支援 onclick 返回 false 阻塞,無需手動綁定
// RichFaces
<a4j:commandButton onclick="if(!confirm('確定?')) return false;" />
<!-- confirmTag.xhtml -->
<ui:composition>
<script>
function confirmAction(source, message, originalFn) {
if (confirm(message)) {
return originalFn ? originalFn.call(source, event) : true;
}
return false;
}
</script>
</ui:composition>
<!-- 使用 -->
<h:commandButton value="刪除" action="#{bean.delete}">
<f:ajax />
</h:commandButton>
<script>
$('#form\\:deleteBtn').on('click', function(e) {
return confirmAction(this, '確定刪除?', this.onclick);
});
</script>
confirm:可自定義樣式、多語言、焦點管理、鍵盤操作。JSF 中集成 confirm 關鍵在於保存並調用原有 onclick,不破壞 JSF 的 AJAX/提交鏈。現代項目建議遷移至組件庫(PrimeFaces p:confirmDialog、OmniFaces o:confirmDialog)或自定義 Modal 組件,獲得更好的 UX、無障礙支援和可維護性。